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.
Destinos admitidos
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 |
Acceso requerido
Para configurar la exportación de eventos de un proyecto, se debe tener acceso
Project Owneral proyecto.Para configurar la exportación de eventos para una organización, debes tener acceso
Organization Ownera la organización.
Configurar exportación de eventos del proyecto
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.
Configurar la exportación de eventos de la organización
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.
Configurar la exportación de eventos con la API
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 |
|---|---|---|
|
| Crea una integración de registros a nivel de proyecto. |
|
| Devuelve todas las integraciones de registro a nivel de proyecto. |
|
| Devuelve una integración de registro a nivel de proyecto. |
|
| Actualiza una integración de registro a nivel de proyecto. |
|
| Remueve una integración de registro a nivel de Proyecto. |
|
| Crea una integración de registro a nivel de organización. |
|
| Devuelve todas las integraciones de registro a nivel de organización. |
|
| Devuelve una integración de registro a nivel de organización. |
|
| Actualiza una integración de registro a nivel de organización. |
|
| 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.
ejemplo: Crear una integración de exportación de eventos de proyecto
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" } ] }'Ejemplo: Crear una integración de exportación de eventos de organización
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>" } ]}Formato de evento
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 |
|---|---|
| Momento en que ocurrió el evento, en nanosegundos desde el Unix epoch. |
| Gravedad del evento como texto, como |
| Gravedad del evento como una enumeración de número de gravedad OTLP, por ejemplo |
| Objeto de evento codificado en JSON. Contiene el ID del evento ( |
| Identificador único del evento. Utilice este campo para desduplicar eventos. |
| Tipo de evento de la fuente de actividad. Para ver la lista de tipos de eventos, consulte Tipos de eventos de alerta de Atlas. |
| Codificación de la carga útil del evento en |
| 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. |
| 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" } } ]}Comportamiento de entrega
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.
Límites de destino
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. |
Precios
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.