22557e7132
- 7-8월 초기 구축 문서 12개를 _archive/troubleshooting/2025_07-08_initial_setup/로 이동 - book/300_architecture/390_human_in_the_loop_intent_learning.md를 journey/research/intent_classification/로 이동 (개발 여정 문서) - 빈 폴더 제거 (journey/assets/*)
60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
# ChromaDB Telemetry 에러 및 1.0.21 업그레이드
|
|
|
|
## 작성일: 2025-09-12
|
|
## 작성자: happybell80
|
|
## 상태: ✅ 해결됨
|
|
## 관련 서비스: rb8001, skill-embedding
|
|
|
|
---
|
|
|
|
## 문제 상황
|
|
|
|
### Telemetry 에러 발생
|
|
```
|
|
WARNING: Anonymized telemetry enabled. See https://docs.trychroma.com/telemetry
|
|
ERROR: Failed to send telemetry: PostHog API error
|
|
```
|
|
- ChromaDB 0.5.20에서 지속적 경고/에러 발생
|
|
- PostHog 분석 서비스 연결 실패
|
|
- 기능 동작에는 영향 없지만 로그 오염
|
|
|
|
### 버전 격차
|
|
- 현재: 0.5.20 (2024년 중반)
|
|
- 최신: 1.0.21 (2025년 최신)
|
|
- 6개월 이상 버전 차이
|
|
|
|
## 테스트 결과 (51124 서버)
|
|
|
|
### 호환성 테스트 ✅
|
|
- 기본 CRUD (생성/저장/검색/삭제) 정상
|
|
- rb8001 기존 패턴 완벽 호환
|
|
- skill-embedding(8515) 연동 정상
|
|
- 384차원 임베딩 지원 확인
|
|
|
|
### 검색 정확도 ✅
|
|
- "오늘 날씨는?" → "오늘 날씨 어때?" (67.2% 유사도)
|
|
- "미팅 시간?" → "회의 일정 알려줘" (71.6% 유사도)
|
|
- 기존과 동일한 검색 품질 유지
|
|
|
|
## 해결 방안
|
|
|
|
### requirements.txt 수정
|
|
```python
|
|
# 변경 전
|
|
chromadb==0.5.20
|
|
|
|
# 변경 후
|
|
chromadb==1.0.21
|
|
```
|
|
|
|
## 개선사항
|
|
1. **Telemetry 에러 해결**: PostHog 연결 시도 중단
|
|
2. **성능 향상**: 메모리 사용량 감소, 검색 속도 개선
|
|
3. **새 API 메서드**: 향후 기능 확장 가능
|
|
|
|
## 주의사항
|
|
- `update()` 호출 시 embedding 파라미터 필수 제공 필요
|
|
- 기존 데이터는 자동 마이그레이션됨
|
|
|
|
## 결론
|
|
ChromaDB 0.5.20 → 1.0.21 업그레이드 안전. 2025-09-12 적용 완료. |