Exportar eventos de feed de atividades para ferramentas externas

Destinos suportados

Os destinos disponíveis dependem se você configura a integração para um projeto ou uma organização. A exportação de evento do projeto permite todos os destinos de exportação de registros. Na versão inicial, a exportação de evento da organização suporta apenas destinos compatíveis com OTel.

Acesso necessário

• Para configurar a exportação de evento para um projeto, você deve ter acesso Project Owner ao projeto.

• Para configurar a exportação de evento para uma organização, você deve ter acesso Organization Owner à organização.

Configurar exportação de eventos do projeto

Para exportar eventos em nível de projeto, siga o procedimento de configuração do seu destino e selecione Events em Log Type quando solicitado:

• Amazon Web Services S3

• Armazenamento de blobs Azure

• Datadog

• Google Cloud Platform Armazenamento do Google Cloud Platform

• OpenTelemetry

• Splunk

Você pode combinar o Events com tipos de registro do sistema na mesma integração ou criar integrações separadas para registros e eventos.

Configurar exportação de eventos da organização

As integrações no nível da organização exportam apenas eventos e oferecem suporte apenas a destinos compatíveis com OTel. Para configurar uma integração no nível da organização, consulte Exportar eventos do feed de atividades da organização.

Configurar a exportação de eventos com a API

Para configurar a exportação de evento programaticamente, use os endpoints de integração de registros da API de administração do Atlas . Para exportar eventos, defina logTypes para incluir EVENTS.

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"
         }
       ]
     }'

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"
         }
       ]
     }'

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

Formato do evento

O Atlas entrega eventos ao seu destino como cargas úteis JSON por OTLP/HTTP. Cada evento exportado é um registro de log OTLP. O recurso do registro inclui um atributo service.name definido como mongodb-atlas-events, que identifica o fluxo de evento do Feed de atividades, para que o coletor OTel possa rotear esses eventos separadamente de outras telemetrias. O Atlas omite atributos com valores nulos de eventos exportados.

Cada evento exportado inclui os seguintes campos:

O exemplo a seguir mostra um evento de projeto 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" }
    }
  ]
}

Comportamento de entrega

• Quase em tempo real. Em condições normais, o Atlas fornece eventos quase em tempo real. Os lotes são liberados aproximadamente uma vez por minuto.

• Entrega pelo menosuma vez. O Atlas pode realizar o mesmo evento mais de uma vez. Deduplicar eventos usando o campomongodb.event.id exclusivo.

• Buffering durante interrupções. Se o seu destino não estiver disponível, o Atlas armazenará em buffer os eventos e tentará a entrega novamente. O Atlas retém eventos não entregues por até sete dias. Os eventos que permanecem não entregues após sete dias são excluídos permanentemente.

• Nenhum alerta automático de repetição, preenchimento ou falha. A versão inicial não reproduz automaticamente os eventos após falhas persistentes e não preenche os eventos históricos que ocorreram antes de você configurar a integração. Para solicitar a devolução de eventos após uma falha persistente, entre em contato com o Suporte do MongoDB.

Limites de destino

Preços

A exportação de eventos não tem SKU separada ou cobrança por funcionalidade. No entanto, a exportação de eventos pode incorrer em cobranças de transferência de dados , que variam de acordo com o destino, a região e o provedor de nuvem. Para saber mais, consulte Custos de transferência de dados.

Saiba mais

• Veja o feed de atividades

• Exportar registros do sistema para serviços externos

• Tipos de evento do Atlas

• Especificação da API de administração do Atlas