배포 모니터링

mongot Pod 및 리소스 상태 모니터링

mongot 의 가장 직접적인 가용 신호는 Pod 의 상태와 MongoDBSearch 리소스의 상태입니다.

팝 상태와 재시작 횟수를 확인합니다.

kubectl get pods -n <namespace> --context <context> | grep search

건강한 mongot 팝은 모든 컨테이너가 준비되고 재시작 횟수가 증가하지 않는 Running 상태를 보고합니다. 재시작 횟수가 증가하면 메모리 부하 또는 구성 오류를 나타냅 수 있습니다. 자세한 내용은 mongot 배포서버 문제 해결을 참조하세요.

MongoDBSearch 리소스 상태 및 조건 검사:

kubectl describe mongodbsearch <MongoDBSearch.metadata.name> \
  -n <namespace> --context <context>

Prometheus 지표 사용

기본적으로 mongot Prometheus 지표 엔드포인트는 비활성화되어 있습니다. 이를 활성화하려면 MongoDBSearch 리소스에 spec.observability.prometheus 블록을 추가하세요. 빈 블록은 기본 포트 9946에서 엔드포인트를 활성화합니다.

spec:
  observability:
    prometheus: {}

기본 값이 아닌 포트를 사용하려면 spec.observability.prometheus.port을 설정하세요.

spec:
  observability:
    prometheus:
      port: 9090

엔드포인트는 팝 내부에 노출되며 구성된 포트에서 mongot 컨테이너의 팝 IP를 통해 액세스할 수 있습니다. Kubernetes 연산자는 지표 엔드포인트를 인증하지 않습니다.

Ops Manager로 지표 전송

지표 전송기는 mongot 지표를 MongoDB Ops Manager로 보내어 다른 배포 지표와 함께 볼 수 있게 합니다. Kubernetes 연산자는 mongot 지표 엔드포인트를 스크래하고 지표를 MongoDB Ops Manager로 푸시하는 별도의 Kubernetes Deployment 로 전송기를 배포합니다.

지표 전송기는 MongoDB Ops Manager 8.0.25 이상이 필요하며 Cloud Manager는 지원하지 않습니다.

포워더를 구성하려면 MongoDBSearch 리소스에서 spec.observability.metricsForwarder 아래의 다음 필드를 설정합니다.

• mode Kubernetes 연산자가 포워더를 배포할 지 여부를 제어합니다. 다음 값 중 하나로 설정합니다.

  • auto (기본값) 내부 MongoDB 소스와 opsManager을 설정하는 경우 외부 소스에 대한 포워더를 자동으로 배포합니다.

  • enabled 항상 포워더를 배포합니다.

  • disabled 포워더를 배포하지 않습니다.

• opsManager.projectConfigMapRef Ops Manager 프로젝트 구성이 있는 ConfigMap의 이름을 지정합니다. ConfigMap에 다음 키를 입력합니다.

  • baseUrl: Ops Manager 인스턴스의 URL입니다.

  • projectName: MongoDB Ops Manager 프로젝트 이름입니다.

  • orgId: MongoDB Ops Manager 조직의 ID입니다.

• opsManager.agentCredentials Ops Manager API 키를 보관하는 Secret의 이름을 지정합니다. Secret에 다음 키를 입력합니다.

  • publicKeyMongoDB Ops Manager API 키의 공개 키입니다.

  • privateKey: MongoDB Ops Manager API 키의 개인 키입니다.

• resourceRequirements 전송자 컨테이너의 CPU 및 메모리를 설정합니다.

opsManager을 설정하지 않으면 Kubernetes 연산자가 소스 MongoDB 리소스에서 Ops Manager 연결 세부 정보를 가져오게 됩니다. 외부 MongoDB 소스에 대해 opsManager 을 설정해야 합니다.

spec:
  observability:
    metricsForwarder:
      mode: enabled
      opsManager:
        projectConfigMapRef:
          name: my-om-project-config
        agentCredentials:
          name: my-om-agent-api-key

Kubernetes Operator는 MongoDBSearch 리소스의 status.metricsForwarder 아래에 포워더 상태를 보고합니다.

로그 상세도 구성

mongot 구조화된 JSON 로그를 컨테이너의 stdout 및 stderr 스트림에 쓰기 (write)하므로 표준 Kubernetes 로그 도구로 읽을 수 있습니다.

kubectl logs statefulset/<MongoDBSearch.metadata.name>-search-0

실시간으로 로그인하려면 --follow 플래그를 추가합니다. 재시작 후 이전 컨테이너 인스턴스의 로그를 보려면 --previous 플래그를 추가합니다.

로그 상세 수준을 변경하려면 MongoDBSearch 리소스에서 spec.logLevel 을 설정합니다. 유효한 값은 TRACE, DEBUG, INFO, WARN, ERROR입니다. 생략하면 mongot 은 INFO에 로그를 기록합니다.

spec:
  logLevel: DEBUG

mongot 자체 로그를 회전하지 않습니다. Kubernetes 배포에서는 컨테이너 런타임(대부분의 배포에서는 containerd 또는 CRI-O)이 노드 수준에서 로그 회전을 처리합니다. 로그를 외부 집계자에게 전송하는 경우 mongot 프로세스에서가 아니라 해당 시스템에서 보유기간을 구성합니다.

상태 확인 엔드포인트

mongot 두 개의 엔드포인트가 있는 팝 내부의 포트 8080 에 HTTP 헬스 서버를 노출합니다.

엔드포인트는 mongot 스타트업, 라이브니스 및 인덱스 복제 초기화를 반영합니다. 엔드포인트는 비활성화할 수 없습니다.

Kubernetes Operator는 /health 와 /ready 을 mongot 컨테이너의 라이브니스 및 준비 프로브에 자동으로 연결합니다. 일반적으로 이러한 프로브를 재정의할 필요가 없습니다. kubectl describe pod <mongot-pod> 에는 연산자가 적용한 프로브 구성이 표시됩니다.

FTDC 진단

mongot 포드의 데이터 경로에 마운트된 영구 볼륨에 diagnostic.data/ 하위 디렉토리로 Full-Time Diagnostic Data Capture(FTDC) 파일을 쓰기합니다. FTDC는 기본적으로 활성화되어 있으며 MongoDB 지원이 성능 및 안정성 문제를 분류하는 데 사용됩니다.

FTDC 파일에는 Prometheus 표면보다 높은 카디널리티 데이터가 포함되어 있습니다. 인덱스별 크기, 인덱싱 및 요청에 대한 지연 시간 분석, 요청 카탈로그 통계, 직렬화 지연 시간, Lucene 성능 카운터 등이 포함됩니다.

지원 사례에 대한 FTDC 파일을 수집하려면 kubectl cp를 사용하여 mongot 포드에서 diagnostic.data/ 디렉토리를 복사합니다.

kubectl cp <mongot-pod>:/mongot/data/diagnostic.data ./mongot-ftdc

인포드 마운트 경로는 spec.clusters[].persistence 구성에 관계없이 /mongot/data 으로 고정됩니다. 영구 설정은 마운트 위치가 아닌 PVC 크기 및 저장 클래스를 제어합니다.

managed Envoy 과찰 가능

spec.clusters[].loadBalancer.managed을 설정하면 Kubernetes 연산자가 mongot 팝의 앞에 있는 Envoy L7 프록시를 프로비저닝합니다. Envoy 컨테이너는 두 개의 관찰 표면을 노출합니다.

• 통계 및 런타임 제어(로그 수준, 수신기 배출)를 위한 포트 9901 의 관리 엔드포인트 입니다. 연산자는 관리 인터페이스를 허용 경로 목록( /ready, /stats*, /drain_listeners, /logging*)으로 제한합니다. 이 엔드포인트는 kubectl port-forward를 사용하여 임시 문제 해결을 위한 것이며, 외부 노출을 위한 것이 아닙니다.

• 표준 /stats/prometheus 경로의 Envoy 관리 포트에서의 Prometheus 지표. 이 엔드포인트를 mongot 지표와 함께 스크래합니다. 이렇게 할 경우 검색 트래픽 플레인의 요청 흐름, 업스트림 상태 및 연결 상태에 대한 전체 가시성을 확보할 수 있습니다.

연산자는 MongoDBSearch 리소스의 status.loadBalancer.phase 에 대한 높은 수준의 Envoy 상태를 보고합니다.

kubectl get mongodbsearch <name> -o jsonpath='{.status.loadBalancer.phase}'

이 단계는 연산자가 managed Envoy Deployment 수명 주기(예시: Pending, Running, Failed)를 반영합니다.

자세히 알아보기

• mongot 배포 문제 해결
• mongot 배포 제한
• spec.observability.prometheus
• spec.logLevel