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.
Destinos suportados
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.
Destino | Eventos do projeto | Eventos da organização |
|---|---|---|
Sim | No | |
Sim | No | |
Sim | No | |
Sim | No | |
Sim | Sim | |
Sim | No |
Acesso necessário
Para configurar a exportação de eventos para um projeto, você deve ter acesso
Project Ownerao projeto.Para configurar a exportação de eventos 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:
Você pode combinar Events com tipos de log do sistema na mesma integração ou criar integrações separadas para logs e eventos.
Configurar a 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.
Configure a exportação de evento com a API
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 |
|---|---|---|
|
| Cria uma integração de log no nível do projeto. |
|
| Retorna todas as integrações de log no nível do projeto. |
|
| Retorna uma integração de log em nível de projeto. |
|
| Atualizar uma integração de log em nível de projeto. |
|
| remover uma integração de log no nível do projeto. |
|
| Cria uma integração de log no nível da organização. |
|
| Retorna todas as integrações de log no nível da organização. |
|
| Retorna uma integração de log em nível de organização. |
|
| Atualiza uma integração de log em nível de organização. |
|
| 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.
Exemplo: Criar uma integração de exportação de eventos de projeto
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" } ] }'Exemplo: Criar uma integração de exportação de eventos da organização
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>" } ]}Formato de evento
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 |
|---|---|
| Hora em que o evento ocorreu, em nanossegundos desde a Era UNIX. |
| Gravidade do evento como texto, como |
| Severidade do evento como uma enumeração de número de severidade OTLP, como |
| Objeto de evento codificado em JSON. Contém o ID do evento ( |
| Identificador exclusivo para o evento. Use este campo para desduplicar eventos. |
| Tipo de evento do feed de atividades. Para a lista de tipos de evento, consulte Tipos de evento de alerta do Atlas. |
| Codificação do payload do evento em |
| 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. |
| 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" } } ]}Comportamento de entrega
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.idexclusivo.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.
Limites de destino
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. |
Preços
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.