docs: ChromaDB telemetry 에러 해결 및 1.0.21 업그레이드 문서화

troubleshooting/250912_happybell80_ChromaDB_telemetry_업그레이드.md

@@ -0,0 +1,60 @@
+# 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 적용 완료.