모니터링 & 텔레메트리

모니터링 & 텔레메트리 (ops-monitoring-monitoring)

Qdrant가 실제로 어떻게 돌아가는지, 자원은 얼마나 쓰는지 파악하려면 모니터링이 필수예요. Qdrant는 메트릭을 Prometheus / OpenMetrics 형식으로 노출하기 때문에, 호환되는 도구와 쉽게 연동할 수 있고 자신만의 모니터링 시스템으로 Qdrant를 관찰할 수 있어요.

출처: Qdrant 공식문서

메트릭 엔드포인트는 다음과 같아요.

http://localhost:6333/metrics

Prometheus와 Grafana와의 연동은 구성을 통해 쉽게 설정할 수 있습니다.

메트릭 (Metrics)

Qdrant는 Prometheus/OpenMetrics 형식으로 다양한 메트릭을 노출하는데, 주로 Grafana와 함께 사용해 모니터링해요. 두 가지 엔드포인트가 제공됩니다.

  • /metrics — Qdrant 노드/피어(peer)의 메트릭. 모든 메트릭을 확인할 수 있어요.
  • /sys_metrics (Qdrant Cloud 전용) — CPU, 메모리, 디스크 사용률, 컬렉션 메트릭, 로드 밸런서 텔레메트리 등 클러스터 전반의 메트릭. 자세한 내용은 Qdrant Cloud 모니터링 문서에서 볼 수 있어요.

메트릭 구성 (Metrics Configuration)

v1.16.0부터 사용 가능

자체 호스팅 환경에서는 메트릭에 대한 추가 구성 옵션을 제공합니다. 기본적으로 모든 Qdrant 메트릭에는 애플리케이션 네임스페이스 접두사(namespace prefix)가 붙어 있지 않아요. 구성의 service.metrics_prefix로 접두사를 지정할 수 있어요.

예를 들어 다음과 같은 환경 변수를 사용하면 됩니다.

QDRANT__SERVICE__METRICS_PREFIX="qdrant_"

컬렉션별 API 메트릭 (Per-Collection API Metrics)

컬렉션별(per-collection) 모드를 활성화하면 전역 메트릭을 완전히 대체합니다. 컬렉션별 데이터가 활성화되면 라벨이 없는 rest_responses_total과 grpc_responses_total은 반환되지 않아요.

Kubernetes 헬스 엔드포인트 (Kubernetes Health Endpoints)

v1.5.0부터 사용 가능

Qdrant는 서버의 현재 상태를 나타내기 위해 세 가지 엔드포인트를 노출해요.

이 엔드포인트들은 현재 가장 기본적인 상태 응답을 제공하며, Qdrant가 시작되어 사용 준비가 되면 HTTP 200을 반환해요. API 키가 구성되어 있는지와 관계없이 이 엔드포인트는 항상 접근할 수 있습니다.

더 알아보기 (Learn more)