사용 통계

사용 통계 (Usage Statistics) (ops-configuration-usage-statistics)

Qdrant 오픈소스 컨테이너 이미지는 기본적으로 엔진을 개선하기 위해 사용자들로부터 익명화된 사용 통계를 수집해요. 이 페이지에서는 어떤 정보를 수집하는지, 그리고 원하지 않을 때 어떻게 비활성화하는지 살펴볼게요.

출처: Qdrant 공식문서

Qdrant 오픈소스 컨테이너 이미지는 기본적으로 사용자들로부터 익명화된 사용 통계를 수집해서 엔진을 개선하는 데 사용해요. 언제든 비활성화할 수 있고, 이미 수집된 데이터도 요청하면 삭제할 수 있어요.

비활성화한다고 해서 데이터베이스의 /metrics 또는 /telemetry 엔드포인트에 접근해 Qdrant 데이터베이스를 직접 모니터링하는 능력에는 영향을 주지 않아요. 단지 Qdrant 팀에 독립적인 익명 사용 통계를 보내는 것만 멈출 뿐이에요.

우리는 Qdrant를 빠르고 안정적으로 만들고 싶어요. 그러려면 실제 시나리오에서 어떻게 동작하는지 이해해야 해요. 내부적으로 벤치마킹을 많이 수행하지만, 가능한 모든 사용 사례·하드웨어·설정을 다룰 수는 없거든요.

병목 지점을 찾아내고 Qdrant를 개선하려면 사용되는 방식에 대한 정보를 수집해야 해요.

또한 Qdrant는 성능을 최적화하기 위해 여러 내부 휴리스틱을 사용해요. 이 휴리스틱의 파라미터를 더 잘 설정하려면 다양한 코드 부분의 타이밍과 카운터를 수집해야 해요. 이 정보로 우리는 모두를 위해 Qdrant를 더 빠르게 만들 수 있어요.

수집하는 정보는 세 가지 유형이에요.

시스템 정보 – CPU, RAM, 디스크 유형 같은 시스템 전반 정보와 Qdrant 인스턴스의 설정.
성능 – 다양한 코드 부분의 타이밍과 카운터 정보.
치명적 오류 보고 – Qdrant에서 발생한 백트레이스(backtrace) 같은 치명적 오류 정보. 아직 아무도 보고하지 않은 문제를 식별하는 데 도움이 돼요.

일부 사용자들은 데이터의 프라이버시에 대해 우려할 수 있다는 걸 잘 알고 있어요. 그래서 우리는 프라이버시를 지키기 위해 추가로 노력해요.

데이터를 익명화하는 데 사용하는 여러 기법이 있어요.

인스턴스를 식별하는 데 무작위 UUID를 사용해요. 이 UUID는 매 시작 시 생성되고 어디에도 저장되지 않아요. 서로 다른 인스턴스를 구분할 다른 방법은 없어요.
모든 큰 숫자를 반올림해서 마지막 자리가 항상 0이 되게 해요. 예를 들어 숫자가 123456789라면 123456000으로 저장해요.
모든 이름을 되돌릴 수 없는 해시 값으로 바꿔요. 그래서 어떤 컬렉션·필드 이름도 텔레메트리로 새어 나가지 않아요.
모든 URL도 해시 처리해요.

익명화된 수집 데이터의 정확한 버전은 anonymize=true 파라미터로 telemetry API에 접근해 확인할 수 있어요.

사용 통계는 다음 방법으로 비활성화할 수 있어요.

QDRANT__TELEMETRY_DISABLED 환경 변수를 true로 설정
config/production.yaml 또는 config/config.yaml 파일에서 설정 옵션 telemetry_disabled를 true로 설정
CLI 옵션 --disable-telemetry 사용

이 중 어느 옵션이든 Qdrant가 어떤 사용 통계 데이터도 보내지 않도록 막아요.

사용 통계를 비활성화하기로 결정했다면, Discord 커뮤니티나 GitHub discussions에서 피드백을 남겨주시길 부탁드려요.

사용자가 모든 도구에서 자신의 데이터를 완전히 삭제하도록 요청할 수 있는 이메일 주소를 제공해요.

그렇게 하려면, Qdrant 설치를 위해 생성된 고유 식별자가 포함된 이메일을 [email protected]로 보내 주세요. 이 식별자는 telemetry API 응답("id" 필드)이나 Qdrant 인스턴스의 로그에서 찾을 수 있어요.