Ops Manager Ops Manager가 이러한 지표 계속 수신하는 동안 Ops Manager 가 OpenTelemetry(OTel) 형식으로 MongoDB Agent 가 수집한 배포서버 지표 타사 가관측성 백엔드 로 내보낼 수 있습니다. 이 기능 사용하면 MongoDB 배포를 기존 가관측성 스택 또는 OTLP(OpenTelemetry Protocol)를 허용하는 기타 플랫폼에 통합할 수 있습니다. 사용자 지정 파이프라인, 사이드카 프로세스 또는 추가 컬렉션 에이전트가 필요하지 않습니다.
OTel 내보내기는 추가 기능이며 기본값 으로 비활성화되어 있습니다. Ops Manager 에 대한 지표 전달은 어떤 식으로든 변경되지 않으며, 모든 신호는 변경되지 않은 상태로 기존 Ops Manager 경로를 통해 계속 전달됩니다. 연결할 수 없는 엔드포인트와 같은 OTel 내보내기 경로의 모든 오류는 격리되므로 Ops Manager 에 대한 보고 중단되지 않습니다.
이 기능 활성화 하면 MongoDB Agent OTLP/ HTTP 를 통해 구성 가능한 케이던스( 기본값 : 30초)로 구성된 엔드포인트에 지표 푸시합니다. 각 주기는 모니터링되는 프로세스 당 하나의 OTLP 요청 과 에이전트의 자체 상태에 대한 요청 하나를 전송하므로 백엔드 하나의 대규모 배치 아닌 간격당 여러 개의 작은 요청을 수신합니다. 엔드포인트는 다음 중 하나일 수 있습니다.
지표 프로세스 하고 이를 여러 대상으로 라우팅할 수 있는 OpenTelemetry 수집기입니다.
기본적으로 OTLP를 허용하는 가시성 플랫폼입니다( 예시: Datadog, Grafana, Dynatrace).
자동화 구성을 통해 이 기능 구성합니다. MongoDB Agent 기존 컬렉션 주기에 따라 내보낸 지표 수집하므로 이 기능 모니터링되는 MongoDB 프로세스에 예비 부하를 가하지 않습니다.
OTel 내보내기와 Prometheus 통합의 차이점
OTel 내보내기 경로는 기존 Prometheus 통합을 바로 대체할 수 없습니다. Prometheus 통합은 풀 기반이며, MongoDB Agent Prometheus 서버 스크래핑하는 /metrics 엔드포인트를 노출합니다. OTel 경로는 푸시 기반이며, MongoDB Agent 타이머를 통해 구성된 OTLP 엔드포인트로 지표 전송합니다.
또한 OTel 지표 MongoDB 에 대한 OpenTelemetry 시맨틱 규칙을 따르는 다양한 이름, 유형 및 단위를 사용하므로 기존 Prometheus 대시보드를 재사용할 수 없습니다. 내보낸 지표 에 대해 대상 가시성 플랫폼에서 새 대시보드, 경고 및 쿼리를 만들어야 합니다.
전제 조건
OTel 내보내기를 구성하기 전에 다음 요구 사항을 충족하는지 확인하세요.
OTel 내보내기를 구성하려면 먼저 배포서버 에 대한 모니터링 활성화 해야 합니다. OTel 내보내기는 MongoDB Agent 모니터링 위해 이미 수집한 샘플을 재사용합니다. MongoDB Agent 설치하고 모니터링 활성화 방법을 학습 배포 모니터링 또는 백업을 위한 MongoDB Agent 설치를 참조하세요.
MongoDB Agent 실행되는 모든 호스팅하다 에서 OTLP 엔드포인트에 연결할 수 있는지 확인하세요. MongoDB Agent 지표 엔드포인트로 직접 푸시합니다. 이 기능 활성화 전에 방화벽 규칙 및 송신 정책을 확인하세요.
Ops Manager API 통해 자동화 구성을 업데이트 할 수 있는
Project Automation Admin액세스 있는지 확인합니다. 프로젝트 역할에 대해 자세히 학습 Ops Manager 역할을 참조하세요. 자동화 구성 API 에 대해 학습 자동화 구성 리소스를 참조하세요.OTLP 엔드포인트가 수신자 프로토콜 로 OTLP/ HTTP 지원하는지 확인합니다. OTLP/ HTTP 수신자 구성에 대해 학습 OpenTelemetry Protocol 사양을 참조하세요.
O텔 내보내기 활성화
자동화 구성을 통해 OTel 내보내기를 구성합니다. 모든 설정은 모니터링 모듈의 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) 내보내기 설정을 참조하세요.
중요
잘못 구성된 otelConfig는 조용히 무시되지 않고 큰 소리로 실패합니다. 구성이 유효하지 않은 경우, MongoDB Agent 모니터링 모듈이 시작되지 않도록 합니다. MongoDB Agent 유효한 구성을 수신할 때까지 30초마다 구성을 재시도합니다. 따라서 유효하지 않은 otelConfig는 OTel 경로뿐만 아니라 모니터링 전체에 영향을 미칩니다. 에이전트 Otel: 접두사를 사용하여 이 실패를 기록하고 Ops Manager 에 대한 에이전트의 상태 보고 에 이를 표시합니다.
구성 변경 사항은 다음에 모니터링 모듈을 다시 시작할 때 적용됩니다. 관련 자동화 구성 속성을 변경하면 Ops Manager 이 재시작을 자동으로 트리거합니다.
경고
http:// 엔드포인트를 구성하면 MongoDB Agent 암호화되지 않은 연결을 통해 지표 전송합니다. Ops Manager 엔드포인트가 프로덕션 대상인지 여부를 감지할 수 없으므로 가드레일이 없으므로 프로덕션에서 안전하지 않은 내보내기를 방지할 수 있습니다. 프로덕션 배포에는 https:// 엔드포인트를 사용하세요.
Kubernetes 배포
MCK( MongoDB Controllers for Kubernetes )에서 managed 배포서버의 경우 OTel 내보내기는 동일한 자동화 구성 메커니즘을 사용합니다. 연산자 는 자동화 구성을 유지 관리합니다. 연산자 사용자 지정 리소스 업데이트를 통해 OTel 설정을 에이전트 호스트에 씁니다. 별도의 Kubernetes 관련 구성은 필요하지 않습니다.
내보낸 지표
이 기능 OTLP를 통해 다음 표의 지표 그룹을 내보냅니다. 지표 이름, 유형 및 단위는 일관적인 mongodb.* 명명 패턴 사용하는 MongoDB 에 대한 OpenTelemetry 시맨틱 규칙을 따릅니다.
지표 그룹 | 소스 | 적용 범위 |
|---|---|---|
Server status |
| 작업 카운터(복제된 항목 포함), 작업 지연 시간, 연결, 메모리, 네트워크, 커서, 삽입된 문서, 업데이트, 삭제 및 반환된 문서, WiredTiger 캐시 통계, 티켓 및 대기열 깊이, 락 획득, 대기 및 교착 상태 수, 활성 읽기 및 쓰기 , 어설션, 흐름 제어, 쿼리 타겟팅, TTL(Time-to-Live) 삭제, 페이지 오류, 가동 시간 및 상태입니다. |
데이터베이스 통계 |
| 데이터베이스별 저장, 데이터 크기, 객체, 인덱스 및 보기 통계. |
컬렉션 활동 |
| 작업별 집계 시간입니다. |
복제 |
| Oplog 크기 및 창, 복제 지연 및 멤버 상태입니다. |
샤딩 | Config metadata | 청크 수 및 샤드 간 데이터 분포. |
에이전트 자체 상태 | 에이전트 런타임 | 전용 |
이 기능 카운터 지표 mongod 가동 시간에서 파생된 시작 타임스탬프와 함께 누적 값으로 내보냅니다. mongod 재시작은 표준 카운터 재설정으로 표시되므로 재시작 시에도 요금 계산이 올바르게 유지됩니다.
부실 상태 및 시리즈 수명
프로세스 일시적으로 연결할 수 없는 동안 MongoDB Agent 카운터 시리즈를 변경하지 않고 다시 내보내므로 컬렉션 간격이 카운터 재설정으로 잘못 읽히지 않습니다.
MongoDB Agent
mongodb.health와 같은 특정 시점 시리즈를 최신 상태에서만 내보내므로, 연결할 수 없는 프로세스 오래된 값을 유지하는 대신 조용히 처리됩니다.MongoDB Agent 20분 후에 새 샘플 없이 시리즈를 삭제하고 백엔드 에서 시리즈가 사라집니다. 누락된 데이터를 기반으로 경고를 빌드 때 이 동작을 고려하세요.
관찰 가능성 플랫폼에서 대시보드 설정
내보낸 지표 에 대해 대상 가시성 플랫폼에서 새 대시보드를 만들어야 합니다. Ops Manager 사전 빌드된 대시보드를 제공하지 않으며, Prometheus 통합, Ops Manager 인터페이스 또는 다른 타사 MongoDB 통합을 위해 생성된 기존 대시보드를 재사용할 수 없습니다.
대시보드를 설정하다 때 다음 지침 고려하세요.
기존 대시보드를 포팅하는 대신 새 대시보드를 만듭니다. OTLP를 통해 방출되는 지표 이름은
mongodb.*명명 규칙을 따르며, 이는 Prometheus 내보내기의 이름 및 Ops Manager 내부 지표 식별자와는 다릅니다.필터링 및 그룹화에 리소스 속성을 사용합니다. 모든 메트릭에는 모니터링되는 프로세스 와 프로젝트 식별하는 리소스 속성이 있습니다. 이러한 속성을 대시보드 패널, 경고 및 그룹화의 프라이머리 차원으로 사용하세요.
카운터 지표 에 요금 함수를 적용합니다. 카운터는 누적됩니다. 지표 에
rate()또는increase()또는 해당 플랫폼의 이에 상응하는 함수를 적용합니다.경고를 다시 만듭니다. OTel 내보내기는 Prometheus, Ops Manager 또는 다른 타사 통합에 정의된 기존 경고 규칙을 이어가지 않습니다. OTel 지표 이름 및 리소스 속성에 대해 대상 플랫폼에서 새 경고 규칙을 정의합니다.
제한 사항
배포서버 당 하나의 백엔드 . 이 기능 정확히 하나의 OTLP 백엔드 지원합니다. 둘 이상의 백엔드 구성하면 심각한 오류가 발생합니다. 지표 여러 대상으로 확장하려면 OpenTelemetry 수집기를 내보내기 대상으로 구성하고 파이프라인 구성을 통해 더 많은 백엔드로 라우팅합니다.
지표만 해당. 이 기능 OTLP를 통해서만 지표 내보냅니다. OTel 내보내기 경로에는 다음 신호가 포함되지 않으며, 이 신호는 변경 없이 Ops Manager 로 계속 전달됩니다.
로그(프로파일러 항목, 호스팅하다 로그 및 에이전트 로그) 및 추적
MongoDB Search 프로세스 지표
호스트 수준 시스템 지표 (CPU, 메모리, 디스크 및 네트워크)
컬렉션별 지연 시간 히스토그램
연결할 수 없는 대상에 대한 버퍼링이 없습니다. MongoDB Agent 내보내기의 정책에 따라 실패한 내보내기를 재시도하거나 삭제합니다. 이 기능 저장 후 전달 대기열을 제공하지 않습니다. Ops Manager 로의 전송은 모든 경우에 영향을 받지 않습니다.