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.
Tipos de log suportados
O Atlas suporta a exportação dos seguintes tipos de log:
mongodlogsmongoslogsmongod-auditlogsmongos-auditlogs
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.
Considerações
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 OwnerouOrganization Ownerpara 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-1Web Services, independentemente da região do seu cluster ou do provedor de nuvem. Se o seu cluster não estiver em AWSus-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.
Tratamento de falhas e recuperação automática
O Atlas lida automaticamente com falhas na exportação de log e se recupera sem intervenção manual:
Repetir e Disjuntor
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.
Fila de mensagens não entregues (DLQ)
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.
Monitoramento e alertas
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.
Destinos de exportação suportados
A tabela a seguir resume os serviços externos que o Atlas suporta para exportação de log:
Destino | Descrição |
|---|---|
Exportar | |
Exporte | |
Exporte | |
Exporte | |
Exporte | |
Exporte |
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.