MongoDB Ops Manager puede emitir métricas de implementación recopiladas por MongoDB Agent en formato OpenTelemetry (OTel) a un backend de observabilidad de terceros, mientras sigue recibiendo estas métricas. Esta funcionalidad le permite integrar sus implementaciones de MongoDB en una pila de observabilidad existente o cualquier otra plataforma que acepte el protocolo OpenTelemetry (OTLP). No necesita pipelines personalizados, procesos sidecar o agentes de colección adicionales.
OTel export es aditivo y está deshabilitado por defecto. La entrega de métricas a Ops Manager no se altera de ninguna manera: cada señal sigue transmitiéndose en la ruta existente de Ops Manager sin cambios. Cualquier fallo en la ruta de exportación de OTel, como un punto final inaccesible, se aísla para que el reporte a MongoDB Ops Manager nunca se interrumpa.
Cuando habilita esta funcionalidad, MongoDB Agent envía métricas a través de OTLP/HTTP a su punto de conexión configurado con una cadencia configurable (el valor por defecto es de 30 segundos). Cada ciclo envía una solicitud OTLP por cada proceso supervisado, además de una solicitud para la propia salud del agente, por lo que su backend recibe varias solicitudes pequeñas por intervalo en lugar de agrupar en un único lote grande. Su endpoint puede ser uno de los siguientes:
Un Collector de OpenTelemetry, que puede procesar métricas y enviarlas a múltiples destinos.
Una plataforma de observabilidad que acepta OTLP nativamente (por ejemplo, DataDog, Grafana, Dynatrace).
Usted configura esta funcionalidad a través de la Configuración de automatización. MongoDB Agent recopila las métricas exportadas en su ciclo de colección existente, por lo que esta funcionalidad no impone ninguna carga extra en sus procesos de MongoDB supervisados.
Cómo la exportación OTel se diferencia de la integración Prometheus
La ruta de exportación de OTel no es un reemplazo directo para la integración existente de Prometheus. Mientras que la integración de Prometheus se basa en la extracción, MongoDB Agent expone un punto final /metrics que su servidor de Prometheus extrae. La ruta OTel se basa en inserción, y MongoDB Agent envía métricas a su extremo OTLP configurado con un temporizador.
Las métricas de OTel también utilizan nombres, tipos y unidades diferentes que siguen las convenciones semánticas de OpenTelemetry para MongoDB, por lo que no puede reutilizar sus tableros de Prometheus existentes. Debe crear nuevos tableros, alertas y queries en su plataforma de observabilidad de destino frente a las métricas exportadas.
Requisitos previos
Antes de configurar la exportación de OTel, asegúrese de cumplir los siguientes requisitos:
Debe habilitar la supervisión para su implementación antes de poder configurar la exportación de OTel. La exportación de OTel reutiliza las muestras que MongoDB Agent ya recopila para la supervisión. Para aprender a instalar MongoDB Agent y habilitar la supervisión, consulte Instalar el MongoDB Agent para supervisar o realizar copias de seguridad de las implementaciones.
Asegúrese de que su OTLP endpoint sea accesible desde cada host donde se ejecuta MongoDB Agent. MongoDB Agent envía métricas directamente al punto final. Verifique sus reglas de firewall y políticas de salida antes de habilitar esta funcionalidad.
Confirme que tiene
Project Automation Adminacceso para actualizar la configuración de automatización a través de la API de MongoDB Ops Manager. Para aprender más sobre los roles del proyecto, consulta roles de MongoDB Ops Manager. Para aprender sobre la configuración de automatización API, consulta recurso de configuración de automatización.Asegúrese de que su punto final OTLP admita OTLP/HTTP como protocolo de receptor. Para aprender a configurar un receptor OTLP/HTTP, consulte la especificación del protocolo OpenTelemetry.
Habilitar exportación de OTel
Puede configurar la exportación de OTel a través de la Configuración de automatización. Todas las configuraciones se almacenan en una única clave otelConfig bajo el additionalParams del módulo de supervisión. Puede aplicar esta configuración a través del flujo de configuración personalizada existente en la interfaz de MongoDB Ops Manager, descrito en Configuración personalizada. También puede aplicar esta configuración a través de la pública Configuración de automatización API.
El siguiente ejemplo muestra una entrada additionalParams que habilita la exportación de OTel:
"additionalParams": { "otelConfig": "{\"enabled\":true,\"metricsExportIntervalSec\":30,\"backends\":[{\"endpoint\":\"https://collector.example.com:4318\",\"headers\":\"Authorization=Bearer <token>\",\"caCertPath\":\"/etc/ssl/ca.pem\"}]}"}Para ver la lista completa de campos de otelConfig, consulte OpenTelemetry (OTel) Configuración de exportación.
Importante
Un otelConfig mal configurado falla de forma notoria en lugar de ser ignorado silenciosamente. Si la configuración no es válida, MongoDB Agent impide que el módulo de supervisión se inicie. MongoDB Agent reintenta la configuración cada 30 segundos hasta que reciba una configuración válida. Un otelConfig no válido, por lo tanto, afecta a la supervisión en su conjunto, no solo a la ruta OTel. El agente registra este error con un prefijo Otel: y lo muestra en el reporte de estado del agente a MongoDB Ops Manager.
Los cambios de configuración surten efecto la siguiente vez que se reinicie el módulo de supervisión. MongoDB Ops Manager activa este reinicio automáticamente cuando cambia las propiedades de configuración de automatización pertinentes.
Advertencia
Si configura un punto final http://, MongoDB Agent envía métricas a través de una conexión sin cifrar. MongoDB Ops Manager no puede detectar si un punto de conexión es un destino de producción, por lo que ninguna barrera de seguridad impide la exportación no segura en producción. Utilice un extremo https:// para implementaciones de producción.
Implementaciones de Kubernetes
Para las implementaciones gestionadas por MongoDB Controllers for Kubernetes (MCK), la exportación de OTel utiliza el mismo mecanismo de configuración de automatización. El operador mantiene la configuración de automatización. El operador escribe su configuración de OTel en los host del agente a través de actualizaciones de recursos personalizadas. No necesita ninguna configuración específica de Kubernetes por separado.
Métricas exportadas
Esta funcionalidad exporta los grupos de métricas de la siguiente tabla a través de OTLP. Los nombres, tipos y unidades de las métricas siguen las convenciones semánticas de OpenTelemetry para MongoDB, utilizando un patrón de nomenclatura mongodb.* coherente.
Grupo de métricas | Origen | cobertura |
|---|---|---|
Server status |
| Contadores de operaciones (incluidas las replicadas), latencias de operaciones, conexiones, memoria, red, cursores, documentos insertados, actualizados, borrados y devueltos, estadísticas de caché de WiredTiger, tickets y profundidad de cola, recuento de adquisiciones, esperas y bloqueos mutuos, lecturas y guardados activos, aserciones, control de flujo, query targeting, borrados de tiempo de vida (TTL), errores de página, tiempo de actividad y estado. |
Estadísticas de la base de datos |
| Estadísticas de almacenamiento, tamaño de los datos, objetos, índices y vistas por base de datos. |
Actividad de la colección |
| Tiempo agregado por operación. |
Replicación |
| Tamaño y ventana del oplog, atraso de la replicación y estado del nodo. |
particionado | Config metadata | Recuentos de fragmentos y distribución de datos en todas las particiones. |
Autosalud del agente | Tiempo de ejecución del agente | Tiempo de actividad, memoria y goroutines de MongoDB Agent, publicado en el namespace dedicado |
Esta funcionalidad exporta métricas de contador como valores acumulativos con una marca de tiempo de inicio derivada del tiempo de actividad de mongod. Un reinicio de mongod se muestra como un restablecimiento de contador estándar, por lo que los cálculos de tasa permanecen correctos en todos los reinicios.
Antigüedad y vida útil de la serie
MongoDB Agent reexporta las series de contadores inalteradas mientras un proceso es inaccesible temporalmente, por lo que una brecha en la colección no se malinterpreta como un restablecimiento del contador.
MongoDB Agent exporta series de tiempo de un punto dado, como
mongodb.health, solo mientras están actualizadas, de modo que un proceso inaccesible se silencia en lugar de mantener un valor obsoleto.MongoDB Agent descarta una serie después de 20 minutos sin una nueva muestra, y la serie desaparece de su backend. Tenga en cuenta este comportamiento cuando compile alertas basadas en datos faltantes.
Configurar tableros en su plataforma de observabilidad
Debe crear nuevos tableros en su plataforma de observabilidad de destino a partir de las métricas exportadas. MongoDB Ops Manager no incluye tableros prediseñados y no puede reutilizar los tableros existentes creados para la integración de Prometheus, la interfaz de MongoDB Ops Manager u otra integración de MongoDB de terceros.
Tenga en cuenta esta orientación al configurar tableros:
Cree nuevos tableros en lugar de migrar los existentes. Los nombres de las métricas emitidos a través de OTLP siguen una convención de nomenclatura
mongodb.*que difiere de los nombres del exportador de Prometheus y de los identificadores de métricas internas de MongoDB Ops Manager.Utilice atributos de recurso para filtro y agrupación. Cada métrica contiene atributos de recurso que identifican el proceso supervisado y el Proyecto. Utilice estos atributos como las dimensiones principales para los paneles del tablero, alertas y agrupación.
Aplicar funciones de tasa a métricas de contador. Los contadores son acumulativos. Aplicar funciones como
rate()oincrease(), o sus equivalentes en su plataforma, a métricas de contador.Vuelva a crear sus alertas. La exportación de OTel no transfiere las reglas de alerta existentes definidas en Prometheus, MongoDB Ops Manager o cualquier otra integración de terceros. Defina nuevas reglas de alerta en su plataforma de destino en función de los nombres de métricas y los atributos de recurso de OTel.
Limitaciones
Un backend por implementación. Esta funcionalidad soporta exactamente un backend OTLP. Configurar más de un backend resulta en un error grave. Para distribuir métricas a muchos destinos, configure un OpenTelemetry Collector como su objetivo de exportación y enrute a más backend a través de su configuración de pipeline.
Solo métricas. Esta funcionalidad solo exporta métricas a través de OTLP. La ruta de exportación de OTel no incluye las siguientes señales, que siguen fluyendo a Ops Manager sin cambios:
Registros (entradas del perfilador, registros del host y registros del agente) y seguimientos
Métricas de proceso de MongoDB Search
Métricas del sistema a nivel de host (CPU, memoria, disco y red)
Histogramas de latencia por colección
Sin almacenamiento en búfer para destinos inalcanzables. MongoDB Agent reintenta o descarta una exportación fallida según la política del exportador. Esta funcionalidad no proporciona ninguna cola de almacenamiento y reenvío. La entrega a Ops Manager no se ve afectada en todos los casos.