Docs Menu
Docs Home
/ /

Exportar registros a OpenTelemetry

Puedes configurar tu M10+ Los clústers Atlas exportan registros del sistema cada minuto a OpenTelemetry (OTel).

Esta integración le permite:

  • Especifique los archivos de registro de MongoDB que desea exportar al punto final de OTel. Atlas admite la exportación de los siguientes tipos de registro:

    • mongod

    • mongos

    • mongod-audit

    • mongos-audit

  • Configure hasta 10 rutas de exportación, lo que le permitirá exportar registros a múltiples puntos finales de OTel simultáneamente.

Importante

Los registros pueden contener información confidencial (incluida información de identificación personal). Usted es responsable del almacenamiento y el tratamiento de sus registros en su terminal OTel. Para que Atlas... Redactar cierta información antes de exportar registros, póngase en contacto con Soporte de MongoDB.

Para exportar registros a un punto final de OTel, debe tener Project Owner o acceso a Organization Owner Atlas.

  • Cada host Atlas suele producir 1 GB de registros al día. Exportar registros implica un coste de transferencia de datos. El coste exacto de la transferencia de datos varía según el destino, la región y el proveedor de la nube.

  • Los problemas de red o los reintentos pueden provocar entradas de registro duplicadas en su punto final OTel.

  • Atlas aplica TLS al conectarse a puntos finales OTLP y requiere certificados firmados por una autoridad de certificación (CA) pública. No se admiten certificados autofirmados.

Usted necesitará:

  • Un punto final OTel existente.

  • URL y puerto del punto final.

  • Configuración de autenticación.

  • Un clúster de Atlas M10+ ejecutando MongoDB 7.0 o superior.

Para exportar registros a un punto final de OTel, complete los siguientes pasos.

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

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haga clic en Project Settings.

La página Configuración del proyecto se muestra.

2

Haz clic en la pestaña Integrations.

La página de Integraciones del proyecto se muestra.

3
4
  1. En el campo OTLP Endpoint, ingrese la URL de su punto final OTel tal como aparece en su cuenta de proveedor OTel.

  2. En los campos OTLP Header, ingrese los encabezados y valores que su punto final OTel requiere para la autenticación.

  3. En Log Type, seleccione los tipos de registros que desea exportar.

    • MongoDB Logs Registros de diagnóstico escritos por cada mongod proceso del servidor. Registran el inicio y el apagado del servidor, la configuración, las conexiones, las consultas lentas, la replicación, la actividad de fragmentación y otros eventos operativos.

    • MongoDB Audit Logs Registros de auditoría emitidos por que 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 mongod MongoDB.

    • MongoDB Router Logs Registros de diagnóstico escritos por cada mongos proceso de enrutador en un clúster fragmentado. Capturan el comportamiento específico del enrutador, como el enrutamiento de consultas a los fragmentos, la actualización de metadatos de los fragmentos y el diagnóstico general del proceso.

    • MongoDB Router Audit Logs Registros de auditoría emitidos por mongos procesos del enrutador, que registran los mismos tipos de eventos del sistema auditados, pero desde la perspectiva del enrutador en una implementación fragmentada.

    Para obtener más información, consulte Ver y descargar registros de MongoDB.

  4. Haga clic en Validate para confirmar que su configuración y credenciales son correctas antes de habilitar la exportación.

  5. Haga clic en Save.

Para asegurarse de recibir una notificación si Atlas deja de exportar registros a su receptor externo, configure una alerta a nivel de proyecto:

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

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. Haga clic en el icono Alerts en la barra de navegación.

  4. Haz clic en Alerts bajo el encabezado Project.

La página Alertas del proyecto se muestra.

2
3

En el menú desplegable Condition/Metric, seleccione Log export is unable to export logs on this host.

4
  1. En la sección Add Notification Method, seleccione de la lista de roles.

  2. En el menú desplegable Add Notifier, selecciona entre las opciones descritas en la siguiente tabla.

    Opción de notificación
    Descripción

    Proyecto Atlas

    Envía la alerta por correo electrónico o mensaje de texto a los usuarios con roles específicos en el proyecto.

    El proyecto Atlas es el destinatario de la alerta por defecto. Se pueden configurar los roles a los que se envía la alerta y cómo se entrega. No se puede agregar un segundo proyecto de Atlas como destinatario.

    El proyecto Atlas está disponible como una opción en la lista Add solo si no está actualmente en la lista de destinatarios.

    1. Se pueden seleccionar los roles del Proyecto que deben recibir las alertas desde las casillas de verificación de Select Role(s) o seleccionar All Roles para que todos los usuarios del Proyecto reciban la alerta.

    2. Seleccionar SMS para enviar estas alertas al número de móvil configurado para cada usuario del Proyecto Atlas en su página de cuenta.

    3. Seleccionar Email para enviar estas alertas a la dirección de correo electrónico configurada para cada usuario del Proyecto Atlas en su página de Cuenta. Email está seleccionado por defecto.

    Organización Atlas

    Envía la alerta por correo electrónico o mensaje de texto a los usuarios con roles específicos en la Organización.

    1. Seleccionar los roles de la organización que deben recibir las alertas de las casillas Select Role(s) o seleccionar All Roles para que todos los usuarios de la organización reciban la alerta.

    2. Seleccionar SMS para enviar estas alertas al número de móvil configurado para cada usuario de la organización Atlas en la página de cuenta.

    3. Seleccionar Email para enviar estas alertas a la dirección de correo electrónico configurada para cada usuario de la organización Atlas en la página de cuenta. Email está seleccionado por defecto.

    Atlas User

    Envía la alerta por correo electrónico o mensaje de texto a un Atlas user especificado.

    1. Seleccionar SMS para enviar estas alertas al número móvil configurado para el Atlas user en su página de Cuenta.

    2. Seleccionar Email para enviar estas alertas a la dirección de correo electrónico configurada para el Atlas user en su página de Cuenta. Email está seleccionado por defecto.

    Correo electrónico

    Envía la alerta a una dirección de correo electrónico.

    SMS

    Envía la alerta a un número de móvil. Atlas remueve todos los signos de puntuación y letras y utiliza únicamente los dígitos. Si la alerta se envíe desde fuera de los Estados Unidos o Canadá, se debe incluir 011 y el código del país porque Atlas utiliza el servicio Twilio con sede en EE. UU. para enviar mensajes de texto. Como alternativa a la opción de un número de teléfono que no es de EE. UU., se debe utilizar un número de teléfono de Google Voice.

    Por ejemplo, se debe ingresar 01164 antes del número de teléfono para enviar la alerta a un número de móvil de Nueva Zelanda.

    Slack

    Envía la alerta a un canal de Slack. Ingrese el nombre del canal y un Token de API o token de bot. Para crear un token de API, consulta la página web https://api.slack.com/ en tu cuenta de Slack. Para obtener más información sobre los usuarios de bot en Slack, consulta https://api.slack.com/bot-users.

    Después de que se cree una notificación que requiere una clave API o de integración, la clave aparece parcialmente redactada cuando:

    • Ver o editar la alerta a través de la Interfaz de Usuario de Atlas.

    • Se debe hacer un query de la alerta para la notificación a través de la API de Atlas Administration.

    PagerDuty

    Envía la alerta a una cuenta de PagerDuty. Introducir únicamente la clave de servicio de PagerDuty. Definir las reglas de escalamiento y las asignaciones de alertas directamente en PagerDuty.

    Los usuarios pueden reconocer las alertas de PagerDuty únicamente desde el tablero de PagerDuty.

    Todas las nuevas claves de PagerDuty utilizan su API de Eventos v2.

    Si se tiene una clave de la API de eventos v1, se puede seguir utilizando con Atlas.

    Después de que se cree una notificación que requiere una clave API o de integración, la clave aparece parcialmente redactada cuando:

    • Ver o editar la alerta a través de la Interfaz de Usuario de Atlas.

    • Se debe hacer un query de la alerta para la notificación a través de la API de Atlas Administration.

    Datadog

    Envía la alerta a una cuenta de Datadog como un evento de Datadog.

    Cuando se abre por primera vez la alerta, Atlas envía la alerta como un evento de "éxito". Las actualizaciones subsiguientes se envían como eventos "info". Cuando se cierra la alerta, Atlas envía un evento de "listo".

    1. Introducir la clave de API de DataDog en API Key y hacer clic en Validate Datadog API Key.

    2. Introducir la región API.

      Atlas admite las siguientes regiones de Datadog en la interfaz de usuario de Atlas:

      • US1

      • US3

      • US5

      • EU1

      • AP1

      Datadog utiliza US1 por defecto.

      Para aprender más sobre las regiones de Datadog, se puede consultar Sitios de Datadog.

      Después de que se cree una notificación que requiere una clave API o de integración, la clave aparece parcialmente redactada cuando:

      • Ver o editar la alerta a través de la Interfaz de Usuario de Atlas.

      • Se debe hacer un query de la alerta para la notificación a través de la API de Atlas Administration.

    3. (Opcional) Para habilitar el seguimiento de métricas de la base de datos, se debe activar Send Database Metrics a On.

    4. (Opcional) Para activar el seguimiento de métricas de latencia de la colección, cambiar Send Collection Latency Metrics a On.

    5. (Opcional) Para activar el seguimiento de métricas de forma del query, cambiar Send Query Shape Metrics a On.

    6. Haga clic en Save.

    VictorOps

    Envía la alerta a una cuenta de VictorOps.

    Introducir la clave API alfanumérica de VictorOps para integrar el endpoint de VictorOps para las alertas. Agregar guiones a la clave API para que coincida con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Por ejemplo, 489f7he7-790b-9896-a8cf-j4757def1161. Introducir una clave de enrutamiento opcional para enrutar las alertas a un grupo específico de VictorOps. Hacer clic en Post Test Alert para probar la configuración de VictorOps. Definir las reglas de escalamiento y enrutamiento directamente en VictorOps.

    Esta opción solo está disponible para las alertas que requieren reconocimiento. Se pueden recibir alertas informativas de este servicio de supervisión de terceros en Atlas. Sin embargo, se deben resolver estas alertas dentro del servicio externo. Se debe acusar de recibido las alertas de VictorOps desde el tablero de VictorOps.

    Después de que se cree una notificación que requiere una clave API o de integración, la clave aparece parcialmente redactada cuando:

    • Ver o editar la alerta a través de la Interfaz de Usuario de Atlas.

    • Se debe hacer un query de la alerta para la notificación a través de la API de Atlas Administration.

    Opsgenie

    Envía la alerta a una cuenta de Opsgenie. Introducir solo la clave API de Opsgenie. Definir las reglas de escalamiento y las asignaciones de alertas directamente en Opsgenie.

    Esta opción solo está disponible para las alertas que requieren reconocimiento. Se pueden recibir alertas informativas de este servicio de supervisión de terceros en Atlas. Sin embargo, se deben resolver estas alertas dentro del servicio externo. Acusar de recibido las alertas de Opsgenie desde el tablero de Opsgenie.

    Después de que se cree una notificación que requiere una clave API o de integración, la clave aparece parcialmente redactada cuando:

    • Ver o editar la alerta a través de la Interfaz de Usuario de Atlas.

    • Se debe hacer un query de la alerta para la notificación a través de la API de Atlas Administration.

    Microsoft Teams

    Envía la alerta a un canal de Microsoft Teams como una Tarjeta adaptable.

    Para enviar notificaciones de alerta a un canal de Microsoft Teams, se debe crear un webhook entrante de Microsoft Teams. Después de crear el webhook, se puede usar la URL generada automáticamente para configurar la integración de Microsoft Teams en Atlas.

    Para configurar la integración, se puede consultar Integrarse con Microsoft Teams.

    Cuando se visualiza o edita la alerta de una notificación de Microsoft Teams, la URL aparece parcialmente oculta.

    Webhook

    Envía una solicitud HTTP POST a un endpoint para su procesamiento programático. El cuerpo de la solicitud contiene un documento JSON que utiliza el mismo formato que el recurso de alertas de la API de Administración de Atlas.

    Esta opción solo está disponible si se han configurado los ajustes de Webhook en la página Integraciones.

    Cuando se ve o edita la alerta de una notificación de webhook, la URL aparece parcialmente oculta y el secreto aparece completamente oculto.

    1. En el campo Webhook URL, se debe especificar la URL de destino para las alertas basadas en webhook.

    2. (Opcional) Si se configura la integración con Webhook con un secreto, en el campo Webhook Secret, se debe especificar el secreto de autenticación para las alertas basadas en webhook.

  3. En la sección Recurrence, configure la alerta para que se active cuando la condición de error en la exportación del registro dure más de 60 minutos y para que se reenvíe cada 10080 minutos (7 días) hasta que se resuelva el problema.

    De esta manera, se le notificará si las fallas en la exportación de registros persisten durante un período prolongado, al tiempo que se evitan notificaciones excesivas por problemas transitorios.

5

Para obtener más detalles sobre la configuración de alertas, consulte Configurar una alerta.

Volver

Exportar registros a Google Cloud Storage

En esta página