DOCS/troubleshooting/250912_happybell80_ChromaDB_telemetry_업그레이드.md

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 수정

# 변경 전
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 적용 완료.