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.

Exportar eventos de la fuente de actividad a herramientas externas

Puede transmitir eventos desde la fuente de actividad de Atlas a herramientas externas, como DataDog, Splunk, almacenamiento en la nube gestionado por el cliente y cualquier destino compatible con OpenTelemetry (OTel). La exportación de eventos permite el registro de auditar centralizado, la retención a largo plazo e integración con sus herramientas de supervisión y observabilidad existentes.

Se puede configurar la exportación de eventos en los siguientes niveles:

  • Proyecto: exporta eventos desde el Project Activity Feed.

  • organización: exporta eventos del Organization Activity Feed.

A diferencia de la exportación de registros del sistema, la exportación de eventos no requiere un clúster M10+. La exportación de eventos admite clústeres de todos los niveles, incluidos los clústeres de nivel gratuito y compartido.

Los destinos disponibles dependen de si configura la integración para un Proyecto o una organización. La exportación de eventos del proyecto admite todos los destinos de exportación de registros. En la versión inicial, la exportación de eventos de la organización solo admite destinos compatibles con OTel.

Destino
Eventos del proyecto
Eventos de la organización

Sí

No

Sí

No

Sí

No

Sí

No

Sí

Sí

Sí

No

  • Para configurar la exportación de eventos de un proyecto, se debe tener acceso Project Owner al proyecto.

  • Para configurar la exportación de eventos para una organización, debes tener acceso Organization Owner a la organización.

Para exportar eventos a nivel de proyecto, siga el procedimiento de configuración para su destino y seleccione Events en Log Type cuando se le solicite:

Puede combinar Events con tipos de registro del sistema en la misma integración, o crear integraciones separadas para registro y evento.

Las integraciones a nivel de organización solo exportan eventos y solo admiten destinos compatibles con OTel. Para configurar una integración a nivel de organización, consulte Exportar eventos de la fuente de actividad de la organización.

Para configurar la exportación de eventos mediante programación, utilice los puntos de conexión de integración de registros de la Atlas Administration API. Para exportar eventos, establezca logTypes para incluir EVENTS.

Método
Endpoint
Descripción

POST

/api/atlas/v2/groups/{groupId}/logIntegrations

Crea una integración de registros a nivel de proyecto.

GET

/api/atlas/v2/groups/{groupId}/logIntegrations

Devuelve todas las integraciones de registro a nivel de proyecto.

GET

/api/atlas/v2/groups/{groupId}/logIntegrations/{id}

Devuelve una integración de registro a nivel de proyecto.

PUT

/api/atlas/v2/groups/{groupId}/logIntegrations/{id}

Actualiza una integración de registro a nivel de proyecto.

DELETE

/api/atlas/v2/groups/{groupId}/logIntegrations/{id}

Remueve una integración de registro a nivel de Proyecto.

POST

/api/atlas/v2/orgs/{orgId}/logIntegrations

Crea una integración de registro a nivel de organización.

GET

/api/atlas/v2/orgs/{orgId}/logIntegrations

Devuelve todas las integraciones de registro a nivel de organización.

GET

/api/atlas/v2/orgs/{orgId}/logIntegrations/{id}

Devuelve una integración de registro a nivel de organización.

PUT

/api/atlas/v2/orgs/{orgId}/logIntegrations/{id}

Actualiza una integración de registro a nivel de organización.

DELETE

/api/atlas/v2/orgs/{orgId}/logIntegrations/{id}

Remueve una integración de registro a nivel de la organización.

Nota

Los puntos de conexión a nivel de organización están disponibles en la versión preliminar de la Atlas Administration API. Para usarlos, establezca el encabezado Accept en application/vnd.atlas.preview+json.

Las integraciones a nivel de organización solo admiten el tipo de integración OTEL_LOG_EXPORT y el tipo de registro EVENTS.

Las respuestas ocultan los valores de encabezado. Cuando actualiza una integración, enviar un valor redactado sin cambios deja el valor almacenado en su lugar. Proporcione un valor de encabezado completo solo cuando lo cambie.

El siguiente ejemplo crea una integración OpenTelemetry a nivel de proyecto que exporta eventos de la fuente de actividad:

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \ --header "Content-Type: application/json" \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --include \ --request POST "https://cloud.mongodb.com/api/atlas/v2/groups/{PROJECT-ID}/logIntegrations?pretty=true" \ --data '{ "type": "OTEL_LOG_EXPORT", "logTypes": ["EVENTS"], "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs", "otelSuppliedHeaders": [ { "name": "Authorization", "value": "Bearer token123" } ] }'

El siguiente ejemplo crea una integración OpenTelemetry a nivel de organización que exporta eventos de la fuente de actividad:

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \ --header "Content-Type: application/json" \ --header "Accept: application/vnd.atlas.preview+json" \ --include \ --request POST "https://cloud.mongodb.com/api/atlas/v2/orgs/{ORG-ID}/logIntegrations?pretty=true" \ --data '{ "type": "OTEL_LOG_EXPORT", "logTypes": ["EVENTS"], "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs", "otelSuppliedHeaders": [ { "name": "Authorization", "value": "Bearer token123" } ] }'

El punto final devuelve la integración creada:

{ "id": "66d9f3e1a2b3c4d5e6f70819", "type": "OTEL_LOG_EXPORT", "logTypes": ["EVENTS"], "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs", "otelSuppliedHeaders": [ { "name": "Authorization", "value": "<redacted>" } ]}

Atlas entrega eventos a su destino como cargas útiles JSON a través de OTLP/HTTP. Cada evento exportado es un registro de OTLP. El recurso del registro incluye un atributo service.name establecido en mongodb-atlas-events, que identifica el flujo de eventos de la fuente de actividad, para que su recopilador de OTel pueda enrutar estos eventos por separado de otra telemetría. Atlas omite los atributos con valores nulos de los eventos exportados.

Cada evento exportado incluye los siguientes campos:

Campo
Descripción

timeUnixNano

Momento en que ocurrió el evento, en nanosegundos desde el Unix epoch.

severityText

Gravedad del evento como texto, como INFO. Corresponde a la gravedad del evento que se muestra en la fuente de actividad.

severityNumber

Gravedad del evento como una enumeración de número de gravedad OTLP, por ejemplo SEVERITY_NUMBER_INFO.

body.stringValue

Objeto de evento codificado en JSON. Contiene el ID del evento (_id), el tipo de evento (eventType), la hora de creación en milisegundos desde el Unix epoch (createdDate), el ID del proyecto (projectId, cuando corresponda) y los detalles específicos del evento (eventPayload). El objeto source identifica qué inició el evento, como un sourceType de USER y un objeto sourceInfo con el username.

mongodb.event.id Atributo

Identificador único del evento. Utilice este campo para desduplicar eventos.

mongodb.event.type Atributo

Tipo de evento de la fuente de actividad. Para ver la lista de tipos de eventos, consulte Tipos de eventos de alerta de Atlas.

mongodb.event.payload.encoding Atributo

Codificación de la carga útil del evento en body.stringValue, como json.

mongodb.org.id Atributo

ID de la organización donde ocurrió el evento. Siempre presente para exportaciones a nivel de organización. Estar presente en algunos eventos a nivel de proyecto.

mongodb.project.id Atributo

ID del Proyecto donde ocurrió el evento. Siempre presente para las exportaciones a nivel de proyecto. Participar en algunos eventos a nivel de organización.

El siguiente ejemplo muestra un evento de proyecto exportado:

{ "timeUnixNano": "1788896817574000000", "severityNumber": "SEVERITY_NUMBER_INFO", "severityText": "INFO", "body": { "stringValue": "{\"_id\":\"6aa06631ba29fc2b0f206c32\",\"eventType\":\"/events/mms/alerts/alert_config_added_audit\",\"projectId\":\"62abb98d95a82610b74debc5\",\"createdDate\":1788896817574,\"resources\":[],\"eventPayload\":\"{\\\"targetAlertConfigId\\\": \\\"6aa06631ba29fc2b0f206c30\\\", \\\"targetAlertConfigEventType\\\": \\\"HOST_DOWN\\\", \\\"targetAlertConfigType\\\": \\\"HOST\\\"}\",\"source\":{\"sourceType\":\"USER\",\"sourceInfo\":{\"username\":\"Atlas Admin\"}}}" }, "attributes": [ { "key": "mongodb.event.id", "value": { "stringValue": "6aa06631ba29fc2b0f206c32" } }, { "key": "mongodb.event.type", "value": { "stringValue": "/events/mms/alerts/alert_config_added_audit" } }, { "key": "mongodb.project.id", "value": { "stringValue": "62abb98d95a82610b74debc5" } }, { "key": "mongodb.event.payload.encoding", "value": { "stringValue": "json" } } ]}
  • Casi en tiempo real. En condiciones normales, Atlas entrega eventos casi en tiempo real. Los agrupar se vuelcan aproximadamente una vez por minuto.

  • Entrega al menos una vez. Atlas podría entregar el mismo evento más de una vez. Desduplicar eventos utilizando el campo mongodb.event.id único.

  • Almacenamiento en búfer durante interrupciones del servicio. Si su destino no está disponible, Atlas almacena en búfer los eventos y reintenta la entrega. Atlas conserva los eventos no entregados durante un máximo de siete días. Los eventos que no se entregan después de siete días se borran permanentemente.

  • No hay repetición automática, recuperación de datos atrasados o alertas de fallo. El lanzamiento inicial no reproduce automáticamente los eventos después de fallos persistentes y no rellena los eventos históricos que se produjeron antes de configurar la integración. Para hacer una solicitud de reentrega de eventos después de un error persistente, póngase en contacto con Soporte de MongoDB.

Destino
Límites

Datadog

Datadog acepta hasta 5 MB y 1,000 eventos por solicitud.

Splunk

Splunk ingesta eventos agrupando a través del HTTP Event Collector (HEC). Si un evento en una agrupar está mal formado, Splunk rechaza la agrupar completa.

OpenTelemetry

La entrega depende de la disponibilidad y configuración de su colector OTel. Los puntos de conexión deben usar HTTPS con un certificado firmado por una autoridad de certificación (CA) pública. Las URL de punto final pueden tener hasta 2,048 caracteres. Puede configurar hasta 10 encabezados con un tamaño combinado de hasta 2 KB.

La exportación de eventos no tiene un SKU independiente ni un cargo por funcionalidad. Sin embargo, la exportación de eventos puede generar cargos por transferencia de datos, que varían según el destino, la región y el proveedor de nube. Para obtener más información, consulte Costos de transferencia de datos.