Qdrant Private Cloud 로깅 & 모니터링 구성

Qdrant Private Cloud 로깅 & 모니터링 구성 (private-cloud-logging-monitoring)

출처: Qdrant 공식문서

Qdrant Private Cloud에서 로깅과 모니터링을 구성하는 방법을 알아볼게요. 로그는 로그 관리 도구로 수집하고, 메트릭은 Prometheus/OpenMetrics 호환 엔드포인트로 노출해서 자신의 모니터링 시스템에 통합할 수 있어요.

로깅 (Logging)

로그는 kubectl이나 여러분이 선택한 Kubernetes 로그 관리 도구로 접근할 수 있어요. 예를 들면:

kubectl -n qdrant-private-cloud logs -l app=qdrant,cluster-id=a7d8d973-0cc5-42de-8d7b-c29d14d24840

로그 레벨 설정

각 데이터베이스의 로그 레벨은 QdrantCluster 스펙을 통해 개별적으로 구성할 수 있어요. 예시:

apiVersion: qdrant.io/v1
kind: QdrantCluster
metadata:
  name: qdrant-a7d8d973-0cc5-42de-8d7b-c29d14d24840
  labels:
    cluster-id: "a7d8d973-0cc5-42de-8d7b-c29d14d24840"
    customer-id: "acme-industries"
spec:
  id: "a7d8d973-0cc5-42de-8d7b-c29d14d24840"
  version: "v1.11.3"
  size: 1
  resources:
    cpu: 100m
    memory: "1Gi"
    storage: "2Gi"
  config:
    log_level: "DEBUG"

config.log_level 값을 DEBUG, INFO 등으로 바꾸면 원하는 상세도로 로그를 조정할 수 있어요.

감사 로깅 (Audit Logging)

Qdrant v1.17.0부터 사용 가능

Qdrant는 인증이나 권한 부여가 필요한 API 작업을 구조화된 JSON으로 기록할 수 있어요. 이 기능은 기본적으로 비활성화되어 있으며, QdrantCluster의 spec.config.audit로 클러스터별로 활성화할 수 있어요. 구성 방법은 Audit Logging 문서를, 항목 형식과 쿼리 API는 보안 가이드의 Audit Logging 섹션을 참고하세요.

감사 항목은 위에서 본 컨테이너 표준 출력(stdout)이 아니라, 클러스터의 데이터베이스 볼륨에 있는 파일(기본값 ./storage/audit)로 기록돼요. 그래서 따로 수집해줘야 해요.

로그 관리 시스템과 연동하기

Kubernetes를 지원하는 어떤 로그 관리 시스템과도 로그를 연동할 수 있어요. Qdrant 특유의 구성은 필요하지 않아요. 여러분의 시스템 에이전트가 Qdrant 네임스페이스의 모든 Pod에서 로그를 수집하도록 설정하기만 하면 돼요.

감사 로그까지 수집하려면, 각 Qdrant Pod의 데이터베이스 볼륨에 있는 감사 디렉터리를 읽도록 에이전트를 구성하거나, /audit/logs API를 통해 항목을 가져오면 돼요.

모니터링 (Monitoring)

Qdrant Cloud 콘솔에서 클러스터의 CPU, 메모리, 디스크 사용량에 대한 기본 메트릭을 확인할 수 있어요.

여러분의 모니터링 시스템에 Qdrant 메트릭을 통합하고 싶다면, 메트릭을 Prometheus/OpenMetrics 호환 형식으로 제공하는 다음 엔드포인트를 스크래핑(scrape)하도록 구성하세요:

각 Qdrant 데이터베이스 Pod의 포트 6333에 있는 /metrics. 각 데이터베이스와 내부 상태에 대한 메트릭을 제공해요.
Qdrant Operator Pod의 포트 9290에 있는 /metrics. Operator 자체와 Qdrant 클러스터·스냅샷의 상태에 대한 메트릭을 제공해요.

Qdrant Hybrid Cloud 네임스페이스 내 Pod, PersistentVolume 같은 Kubernetes 리소스 상태에 대한 메트릭은 kube-state-metrics를 사용하는 것을 권장해요.

Grafana 대시보드

위 메트릭을 여러분의 모니터링 시스템으로 스크래핑하고 Grafana를 사용한다면, 이 메트릭을 시각화하는 데 우리가 제공하는 Grafana 대시보드를 사용할 수 있어요.

Qdrant Private Cloud 로깅 & 모니터링 구성