Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Exportar eventos do feed de atividades para ferramentas externas

Você pode transmitir eventos do feed de atividades do Atlas para FERRAMENTAS externas, incluindo DataDog, Splunk, armazenamento em nuvem gerenciado pelo cliente e qualquer destino compatível com OpenTelemetry (OTel). A exportação de evento permite o registro de auditar centralizado, a retenção de longo prazo e a integração com suas FERRAMENTAS de monitoramento e observabilidade existentes.

Você pode configurar a exportação de eventos nos seguintes níveis:

  • Projeto: exporta eventos do Project Activity Feed.

  • Organização: exporta eventos do Organization Activity Feed.

Ao contrário da exportação de logs do sistema, a exportação de eventos não requer um cluster M10+. A exportação de eventos oferece suporte a clusters de todos os tier, incluindo clusters gratuitos e de tier compartilhado.

Os destinos disponíveis dependem de você configurar a integração para um projeto ou uma organização. A exportação de eventos de projeto oferece suporte a todos os destinos de exportação de log. Na versão inicial, a exportação de eventos da organização oferece suporte apenas a destinos compatíveis com OTel.

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

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

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:

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

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.

Para configurar a exportação de eventos programaticamente, use os pontos de extremidade de integração de log da Atlas Administration API. Para exportar eventos, defina logTypes para incluir EVENTS.

Método
Endpoint
Descrição

POST

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

Cria uma integração de log no nível do projeto.

GET

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

Retorna todas as integrações de log no nível do projeto.

GET

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

Retorna uma integração de log em nível de projeto.

PUT

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

Atualizar uma integração de log em nível de projeto.

DELETE

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

remover uma integração de log no nível do projeto.

POST

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

Cria uma integração de log no nível da organização.

GET

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

Retorna todas as integrações de log no nível da organização.

GET

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

Retorna uma integração de log em nível de organização.

PUT

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

Atualiza uma integração de log em nível de organização.

DELETE

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

Remove uma integração de log no nível da organização.

Observação

Os pontos de extremidade no nível da organização estão disponíveis na versão de pré-visualização da Atlas Administration API. Para usá-los, defina o cabeçalho Accept como application/vnd.atlas.preview+json.

As integrações em nível de organização suportam apenas o tipo de integração OTEL_LOG_EXPORT e o tipo de log EVENTS.

As respostas ocultam os valores do cabeçalho. Ao atualizar uma integração, enviar um valor oculto de volta sem alterações mantém o valor armazenado no lugar. Forneça um valor de cabeçalho na íntegra apenas quando você o alterar.

O exemplo a seguir cria uma integração OpenTelemetry em nível de projeto que exporta eventos do feed de atividades:

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

O exemplo a seguir cria uma integração OpenTelemetry no nível da organização que exporta eventos do feed de atividades:

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

O ponto de extremidade retorna a integração criada:

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

O Atlas entrega eventos ao seu destino como cargas útil JSON via 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 eventos do feed de atividades, para que seu 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:

Campo
Descrição

timeUnixNano

Hora em que o evento ocorreu, em nanossegundos desde a Era UNIX.

severityText

Gravidade do evento como texto, como INFO. Corresponde à gravidade do evento exibida no feed de atividades.

severityNumber

Severidade do evento como uma enumeração de número de severidade OTLP, como SEVERITY_NUMBER_INFO.

body.stringValue

Objeto de evento codificado em JSON. Contém o ID do evento (_id), tipo de evento (eventType), hora de criação em milissegundos desde a Era UNIX (createdDate), ID do projeto (projectId, quando aplicável) e detalhes específicos do evento (eventPayload). O objeto source identifica o que iniciou o evento, como um sourceType de USER e um objeto sourceInfo com o username.

mongodb.event.id atributo

Identificador exclusivo para o evento. Use este campo para desduplicar eventos.

mongodb.event.type atributo

Tipo de evento do feed de atividades. Para a lista de tipos de evento, consulte Tipos de evento de alerta do Atlas.

mongodb.event.payload.encoding atributo

Codificação do payload do evento em body.stringValue, como json.

mongodb.org.id atributo

ID da organização onde o evento ocorreu. Sempre presente para exportações em nível de organização. Presente em alguns eventos de nível de projeto.

mongodb.project.id atributo

ID do projeto onde o evento ocorreu. Sempre presente para exportações em nível de projeto. Presente em alguns eventos em nível de organização.

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" } } ]}
  • Quase em tempo real. Em condições normais, o Atlas entrega eventos quase em tempo real. Os lotes são liberados aproximadamente uma vez por minuto.

  • Entrega pelo menos uma vez. O Atlas pode entregar o mesmo evento mais de uma vez. Remova a duplicidade de eventos usando o campo mongodb.event.id exclusivo.

  • Buffer durante interrupções. Se o seu destino estiver indisponível, o Atlas armazena eventos em buffer e tenta novamente a entrega. 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.

  • Sem repetição automática, preenchimento ou alertas de falha. A versão inicial não repete eventos automaticamente após falhas persistentes e não preenche eventos históricos que ocorreram antes de você configurar a integração. Para solicitação de nova entrega de eventos após uma falha persistente, entre em contato com o Suporte do MongoDB.

Destino
Limites

Datadog

O DataDog aceita até 5 MB e 1,000 evento por solicitação.

Splunk

O Splunk ingere eventos em lote por meio do HTTP Event Collector (HEC). Se um evento em um lote estiver malformado, o Splunk rejeitará todo o lote.

OpenTelemetry

A entrega depende da disponibilidade e configuração do seu OTel collector. Os pontos de extremidade devem usar HTTPS com um certificado assinado por uma Autoridade Certificadora (CA) pública. As URLs do ponto de extremidade podem ter até 2,048 caracteres. Você pode configurar até 10 cabeçalhos com um tamanho combinado de até 2 KB.

A exportação de evento não tem SKU separado ou cobrança por recurso. No entanto, a exportação de eventos pode incorrer em custos 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.