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 registros para serviços externos

Importante

O recurso descrito nesta página não é suportado atualmente em cluster Atlas Infinite durante a visualização pública. Para os recursos suportados na visualização pública, consulte Disponibilidade de Visualização Pública.

Você pode configurar seus clusters do Atlas M10+ para exportar registros do sistema a cada minuto para um serviço externo. A exportação de registros para um serviço externo permite o gerenciamento centralizado de registros, a retenção de longo prazo e a integração com suas ferramentas de monitoramento e observabilidade existentes.

O Atlas suporta a exportação dos seguintes tipos de log:

Você pode especificar quais tipos de log deseja exportar e configurar até 10 caminhos de exportação para enviar logs para vários destinos simultaneamente.

Importante

Os registros podem conter informações confidenciais (incluindo PII). Você é responsável pelo armazenamento e tratamento dos seus registros em seu serviço externo. Para que o Atlas elimine determinadas informações antes de exportar registros, entre em contato com o Suporte do MongoDB.

  • Você deve ter um cluster M10+ para exportar logs. A exportação de log não está disponível para clusters de tier gratuito ou compartilhado. Este requisito não se aplica à exportação de eventos do feed de atividades, que oferece suporte a clusters de todos os níveis.

  • Você deve ter acesso Project Owner ou Organization Owner para configurar a exportação de log.

  • Cada host Atlas normalmente produz 1 GB de registros por dia. A exportação de logs gera um custo de transferência de dados. O custo exato da transferência de dados varia dependendo do destino, da região e do provedor de nuvem.

  • A saída de log origina-se do plano de controle do Atlas na Amazon us-east-1 Web Services, independentemente da região do seu cluster ou do provedor de nuvem. Se o seu cluster não estiver em AWS us-east-1, você incorre em custos de transferência de dados entre regiões ou entre nuvens, além dos custos de saída da Internet. Para saber mais sobre os custos de transferência de dados, consulte Custos de Transferência de Dados.

  • Problemas ou novas tentativas de rede podem causar entradas de registro duplicadas em seu serviço externo.

O Atlas lida automaticamente com falhas na exportação de log e se recupera sem intervenção manual:

Quando a entrega de log para seu coletor externo falha, o Atlas tenta novamente automaticamente com retirada exponencial por até 3 tentativas por padrão. O atraso de nova tentativa começa em 1 segundo e dobra até um máximo de 10 segundos entre as tentativas.

Após 5 falhas consecutivas, um disjuntor abre para evitar sobrecarregar seu coletor com solicitações repetidas. O disjuntor permanece aberto por 5 minutos antes de tentar uma gravação de teste. Se o teste for bem-sucedido, a operação normal é retomada. Se falhar, o disjuntor reabre.

Cada configuração de sink tem seu próprio disjuntor independente, portanto, problemas com uma integração não afetam as outras.

Quando as novas tentativas são esgotadas ou os erros não são repetíveis (como credenciais inválidas), o Atlas enfileira os eventos de log com falha em uma fila de mensagens não entregues (DLQ) com uma retenção de 7dias. O DLQ evita a perda de dados enquanto seu sink está indisponível.

Aviso

Os logs com mais de 7 dias são excluir permanentemente da DLQ. Se o seu coletor permanecer inacessível por mais de 7 dias, esses logs não poderão ser recuperados.

Quando a conectividade é restaurada e o disjuntor fecha, o Atlas reproduz automaticamente os logs enfileirados do DLQ para o seu coletor. Nenhuma intervenção manual é necessária.

Aviso

Se você modificar a configuração do sink enquanto os logs estiverem na fila do DLQ, os logs na fila usarão a nova configuração quando forem reproduzidos novamente. Por exemplo, se você alterar o destino de um bucket S3 para outro, os logs enfileirados serão enviados para o novo bucket em vez do destino original.

O Atlas fornece alertas padrão que enviam automaticamente notificações por e-mail para usuários do Project Owner quando:

  • A exportação de log encontra erros não recuperáveis (log enfileirado na DLQ).

  • A exportação de log falha após várias tentativas de repetição (logs na fila em DLQ).

  • A reprodução da exportação de log falha ao entregar registros.

Esses alertas são informativos, o que significa que eles aparecem apenas no feed de atividades do projeto e não aparecem nas abas Open Alerts ou Closed Alerts da página Project Alerts. Para aprender mais sobre o ciclo de vida do alerta informativo, consulte Fluxo de trabalho de alertas.

Além disso, o feed de atividades do projeto registra os seguintes eventos informativos:

  • Exportação de log recuperada (logs enfileirados prontos para serem retomados).

  • Exportação de log recuperada (o log em fila está sendo enviado agora).

  • Todos os logs na fila foram entregues.

Você pode personalizar os destinatários do alerta e os métodos de notificação nas configurações de alerta do seu projeto. Para obter detalhes, consulte Configurar um alerta.

A tabela a seguir resume os serviços externos que o Atlas suporta para exportação de log:

Destino
Descrição

Exportar mongod, mongos e logs de auditoria para um AWS S3 bucket. Suporta Pontos de Acesso Multirregionais (MRAPs).

Exporte mongod, mongos e logs de auditar para um contêiner do Azure Blob Storage.

Exporte mongod, mongos e logs de auditar para o Datadog para análise de registros e painéis em tempo real.

Exporte mongod, mongos e registros de auditar para um bucket do Google Cloud Storage.

Exporte mongod, mongos e logs de auditar para um ponto de extremidade OpenTelemetry (OTel) para observabilidade independente do fornecedor.

Exporte mongod, mongos e logs de auditar para Splunk Cloud ou Splunk Enterprise para pesquisa e análise centralizada de log.

Todos os destinos compatíveis podem exportar eventos do feed de atividades em nível de projeto. A exportação de eventos no nível da organização suporta apenas o OpenTelemetry.