OpenTelemetry(OTel)로 지표 전송

OTel Export와 Prometheus 통합의 차이점

OTel 내보내기 경로는 기존 Prometheus 통합을 완전히 대체하지 않습니다. Prometheus 통합은 풀 기반이며 MongoDB Agent는 Prometheus 서버가 스크랩하는 /metrics 엔드포인트를 노출합니다. OTel 경로는 푸시 기반이며 MongoDB Agent는 타이머에 따라 구성된 OTLP 엔드포인트로 지표를 보냅니다.

OTel 지표는 MongoDB에 대한 OpenTelemetry 의미 체계 규칙을 따르는 다른 이름, 유형 및 단위를 사용하므로 기존 Prometheus 대시보드를 재사용할 수 없습니다. 내보낸 지표에 대해 대상 관찰 가능성 플랫폼에서 새 대시보드, 경고 및 쿼리를 생성해야 합니다.

전제 조건

OTel 내보내기를 구성하기 전에 다음 요구 사항을 충족하는지 확인하세요.

• OTel 내보내기를 구성하기 전에 배포서버에 대한 모니터링을 활성화해야 합니다. OTel export는 MongoDB Agent가 이미 모니터링을 위해 수집하는 샘플을 재사용합니다. MongoDB Agent 설치 및 모니터링 활성화 방법을 학습하려면 배포서버 모니터 또는 백업을 위한 MongoDB Agent 설치를 참조하십시오.

• MongoDB Agent가 실행되는 모든 호스트에서 OTLP 엔드포인트에 연결할 수 있는지 확인하세요. MongoDB Agent는 지표를 엔드포인트로 직접 푸시합니다. 이 기능을 활성화하기 전에 방화벽 규칙과 송신 정책을 확인하세요.

• Project Automation Admin MongoDB Ops Manager API 를 통해 자동화 구성을 업데이트하기 위한 액세스가 있는지 확인합니다. 프로젝트 역할에 대해 자세히 학습하려면 MongoDB Ops Manager 역할을 참조하세요. 자동화 구성 API에 대해 알아보려면 자동화 구성 리소스를 참조하세요.

• OTLP 엔드포인트가 수신 프로토콜로 OTLP/HTTP를 지원하는지 확인하세요. OTLP/HTTP 수신기 구성에 대해 학습하려면 OpenTelemetry 프로토콜 사양을 참조하세요.

OTel 내보내기 활성화

OTel export는 자동화 구성을 통해 구성합니다. 모든 설정은 모니터링 모듈의 additionalParams에 단일 otelConfig 키로 저장됩니다. 이 구성을 Ops Manager 인터페이스의 기존 사용자 지정 구성 흐름을 통해 적용할 수 있습니다. 자세한 내용은 사용자 지정 설정을 참조하십시오. 공개 자동화 구성 API를 통해 이 구성을 적용할 수도 있습니다.

다음 예시는 OTel 내보내기를 활성화하는 additionalParams 항목을 보여줍니다.

1"additionalParams": {2  "otelConfig": "{\"enabled\":true,\"metricsExportIntervalSec\":30,\"backends\":[{\"endpoint\":\"https://collector.example.com:4318\",\"headers\":\"Authorization=Bearer <token>\",\"caCertPath\":\"/etc/ssl/ca.pem\"}]}"3}

otelConfig 필드의 전체 목록은 OpenTelemetry(OTel) 내보내기 설정을 참조하세요.

구성 변경 사항은 모니터링 모듈이 다음에 다시 시작될 때 적용됩니다. 관련 자동화 구성 속성을 변경하면 MongoDB Ops Manager가 이 다시 시작을 자동으로 트리거합니다.

Kubernetes 배포서버

MongoDB Controllers for Kubernetes (MCK)에서 managed하는 배포서버의 경우, OTel 내보내기는 동일한 자동화 구성 메커니즘을 사용합니다. 연산자는 자동화 구성을 유지합니다. 연산자는 사용자 지정 리소스 업데이트를 통해 OTel 설정을 에이전트 호스팅하다에 쓰기 (write)합니다. 별도의 Kubernetes 관련 구성은 필요하지 않습니다.

내보낸 지표

이 기능은 다음 표의 지표 그룹을 OTLP를 통해 내보냅니다. MongoDB의 지표 이름, 유형 및 단위는 일관적인 mongodb.* 명명 패턴을 사용하여 OpenTelemetry 의미 체계 규칙을 따릅니다.

이 기능은 카운터 지표를 mongod 가동 시간에서 파생된 시작 타임스탬프가 있는 누적 값으로 내보냅니다. mongod 재시작은 표준 카운터 재설정으로 표시되므로 재시작 전반에 걸쳐 속도 계산이 정확하게 유지됩니다.

데이터 노후화 및 시리즈 수명

• MongoDB Agent는 프로세스에 일시적으로 연결할 수 없는 동안 카운터 시리즈를 변경하지 않고 다시 내보내므로 컬렉션 간격이 카운터 재설정으로 잘못 해석되지 않습니다.

• MongoDB Agent는 mongodb.health와 같은 Time Series를 최신 상태일 때만 내보내므로, 연결할 수 없는 프로세스는 오래된 값을 유지하는 대신 침묵 상태가 됩니다.

• MongoDB Agent는 새로운 샘플 없이 20 분이 지나면 시리즈를 제거하며, 해당 시리즈는 백엔드에서 사라집니다. 누락된 데이터를 기반으로 경고를 빌드할 때 이 동작을 고려하십시오.

관찰 플랫폼에서 대시보드 설정

내보낸 지표를 사용하여 대상 관찰 가능성 플랫폼에서 새 대시보드를 만들어야 합니다. MongoDB Ops Manager는 사전 빌드된 대시보드를 제공하지 않으며, Prometheus 통합, MongoDB Ops Manager 인터페이스 또는 기타 타사 MongoDB 통합을 위해 생성된 기존 대시보드를 재사용할 수 없습니다.

대시보드를 설정할 때 다음 지침을 고려하십시오.

• 기존 대시보드를 포팅하는 대신 새 대시보드를 만드세요. OTLP를 통해 내보낸 지표 이름은 Prometheus 내보내기 도구의 이름 및 MongoDB Ops Manager 내부 지표 식별자와 다른 mongodb.* 명명 규칙을 따릅니다.

• 리소스 속성을 사용하여 필터링하고 그룹화합니다. 모든 지표에는 모니터 프로세스와 프로젝트를 식별하는 리소스 속성이 포함되어 있습니다. 이러한 속성을 대시보드 패널, 경고 및 그룹화의 프라이머리 차원으로 사용합니다.

• 카운터 지표에 비율 함수를 적용합니다. 카운터는 누적됩니다. 카운터 유형 지표에 rate() 또는 increase()과 같은 함수나 플랫폼의 해당 함수를 적용합니다.

• 경고를 다시 만듭니다. OTel 내보내기는 Prometheus, MongoDB Ops Manager 또는 기타 타사 통합에 정의된 기존 경고 규칙을 전송하지 않습니다. OTel 지표 이름 및 리소스 속성에 대해 대상 플랫폼에서 새 경고 규칙을 정의합니다.

제한 사항

• 배포서버당 하나의 백엔드. 이 기능은 정확히 하나의 OTLP 백엔드를 지원합니다. 둘 이상의 백엔드를 구성하면 하드 오류가 발생합니다. 지표를 여러 대상으로 팬아웃하려면 OpenTelemetry Collector를 내보내기 대상으로 구성하고 파이프라인 구성을 통해 더 많은 백엔드로 라우팅하십시오.

• 지표만 해당. 이 기능은 OTLP를 통한 지표만 내보냅니다. OTel 내보내기 경로에는 다음 신호가 포함되지 않으며, 이러한 신호는 변경 없이 MongoDB Ops Manager로 계속 흐릅니다.

  • 로그(프로파일러 항목, 호스트 로그, 에이전트 로그) 및 추적

  • MongoDB Search 프로세스 지표

  • 호스트 수준 시스템 지표(CPU, 메모리, 디스크 및 네트워크)

  • 컬렉션별 지연 시간 히스토그램

• 도달할 수 없는 대상에 대한 버퍼링이 없습니다. MongoDB Agent는 내보내기 정책에 따라 실패한 내보내기를 재시도하거나 제거합니다. 이 기능은 저장 후 전달(store-and-forward) 대기열을 제공하지 않습니다. 모든 경우에 MongoDB Ops Manager로의 전달은 영향을 받지 않습니다.

자세히 알아보기

• Prometheus와 통합

• 사용자 지정 설정

• 자동화 구성 암호화