Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Enviar métricas a OpenTelemetry (OTel)

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.

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.

Antes de configurar la exportación de OTel, asegúrese de cumplir los siguientes requisitos:

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.

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.

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

serverStatus

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

dbStats

Estadísticas de almacenamiento, tamaño de los datos, objetos, índices y vistas por base de datos.

Actividad de la colección

top

Tiempo agregado por operación.

Replicación

replSetGetStatus y el oplog

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 mongodb.mms.*.

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.

  • 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.

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() o increase(), 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.

  • 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.