Puedes configurar tus clústeres de M10+ Atlas para exportar registros del sistema cada minuto a OpenTelemetry (OTel).
Esta integración te permite:
Especifique qué entradas de registro de MongoDB desea exportar al endpoint OTel. Atlas admite la exportación de los siguientes tipos de registros:
mongodmongosmongod-auditmongos-audit
Configure hasta 10 rutas de exportación, lo que le permitirá exportar registros a varios endpoints OTel simultáneamente.
Importante
Los registros pueden contener información confidencial (incluida la PII). Usted es responsable del almacenamiento y tratamiento de sus registros en su extremo OTel. Para que Atlas redacte cierta información antes de exportar registros, comunícate con Soporte de MongoDB.
Acceso requerido
Para exportar registros a un endpoint de OTel, debes tener acceso a Project Owner o Organization Owner a Atlas.
Considerations
Cada host de Atlas generalmente produce 1 GB de registros por día. Exportar registros implica un costo de transferencia de datos. El costo exacto de la transferencia de datos varía según el destino, la región y el proveedor de nube.
Los problemas de red o los reintentos pueden causar entradas de registro duplicadas en su endpoint OTel.
Atlas aplica TLS al conectarse a puntos finales OTLP y requiere certificados firmados por una autoridad de certificación pública (CA). No se admiten los certificados autofirmados.
Requisitos previos
Necesitarás:
Un endpoint de OTel existente.
URL del endpoint y puerto.
Configuración de autenticación.
Un clúster de Atlas
M10+ejecutando MongoDB 7.0 o superior.
Procedimiento
Para exportar registros a un punto final de OTel, completa los siguientes pasos.
En Atlas, diríjase a la página Project Settings.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en el icono junto a Project Overview.
La página Configuración del proyecto se muestra.
En Atlas, diríjase a la página Project Integrations.
Haz clic en la pestaña Integrations.
La página de Integraciones del proyecto se muestra.
Conecta Atlas a un endpoint OTel.
En el campo OTLP Endpoint, ingrese la URL de su endpoint OTel tal como aparece en su cuenta de proveedor OTel.
En los campos OTLP Header, introduce los encabezados y valores requeridos por el endpoint OTel para la autenticación.
En Log Type, selecciona los tipos de registros que deseas exportar.
MongoDB Logs Registros de diagnóstico escritos por cada proceso del servidor
mongod. Registran el inicio y el apagado del servidor, la configuración, las conexiones, las consultas lentas, la replicación, la actividad de particionado y otros eventos operativos.MongoDB Audit Logs Auditoría de los registros emitidos por
mongodque rastrean acciones de eventos del sistema como intentos de autenticación, comprobaciones de autorización, cambios de rol y otras operaciones relevantes para la seguridad. Estos registros son independientes del registro principal de MongoDB.MongoDB Router Logs Registros de diagnóstico escritos por cada proceso de enrutador
mongosen un clúster particionado. Capturan el comportamiento específico del router, como el enrutamiento de queries a particiones, la actualización de metadatos de particionado y diagnósticos generales del proceso.MongoDB Router Audit Logs Auditoría de registros generados por los procesos de enrutador
mongos, registrando los mismos tipos de eventos del sistema auditados, pero desde la perspectiva del enrutador en una implementación particionada.Events Eventos del Project Activity Feed, como eventos del ciclo de vida de la integración y cambios en el estado de exportación de registros. Para obtener más información, consulte Exportar eventos del feed de actividad a herramientas externas.
Para obtener más información sobre los registros de MongoDB, consulte Ver y descargar registros de MongoDB.
Haz clic en Validate para confirmar que tu configuración y credenciales sean correctas antes de habilitar la exportación.
Haga clic en Save.
Eventos de la actividad de la organización exportadora
Las integraciones de OpenTelemetry a nivel de organización exportan eventos de Activity Feed en lugar de registros de base de datos. La exportación de eventos de la organización solo admite destinos compatibles con OTel.
Acceso requerido
Para exportar eventos de la organización, debe tener acceso Organization Owner a Atlas.
Procedimiento
Para exportar eventos de la organización a un punto final de OTel, siga los pasos que se indican a continuación.
En Atlas, diríjase a la página Organization Settings.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
En la barra lateral, haga clic en Organization Settings.
Se muestra la página Configuración de la organización.
En Atlas, diríjase a la página Organization Integrations.
Haz clic en la pestaña Integrations.
Se muestra la página Integraciones de la organización.
Conecta Atlas a un endpoint OTel.
En el campo OTLP Endpoint, introduzca la URL de su punto final OTel tal como aparece en su cuenta de proveedor OTel. El punto final debe utilizar HTTPS con un certificado firmado por una Autoridad de Certificación (CA) pública.
En los campos OTLP Header, introduzca los encabezados y valores que su punto final OTel requiere para la autenticación. Puede especificar hasta 10 encabezados con un tamaño combinado de hasta 2 KB.
Haz clic en Validate para confirmar que tu configuración y credenciales sean correctas antes de habilitar la exportación.
Haga clic en Save.
Alertas para fallos de exportación de registros
Atlas te notifica automáticamente cuando fallan las exportaciones de registros o cuando se recuperan mediante alertas predeterminadas que están habilitadas para todos los proyectos.
Default Alerts
Las siguientes alertas están habilitadas de forma predeterminada para todos los proyectos con receptores de registro externos:
Estas alertas son informativas, lo que significa que cuando se cumple la condición de alerta, Atlas envía inmediatamente notificaciones por correo electrónico a todos los usuarios con el rol Project Owner y registra la alerta en el Project Activity Feed. Estas alertas no aparecen en las pestañas Open Alerts o Closed Alerts de la página Project Alerts. Puede personalizar los destinatarios y métodos de notificaciones en la configuración Project Alerts. Para obtener más información sobre el ciclo de vida de las alertas informativas, consulte Flujo de trabajo de alertas.
Eventos de la fuente de actividad
Además de las alertas, Atlas registra los siguientes eventos informativos en el Project Activity Feed:
Log export has recovered. Queued logs are ready to resume sending.
Log export has recovered. Queued logs are now being sent.
All queued logs have been delivered to sink.
Para ver estos eventos, consulte Ver historial de actividad.
Para obtener más información sobre la configuración de notificaciones de alerta, consulta Configurar una alerta.