Importante
A funcionalidade descrita nesta página não é atualmente suportada em clusters Atlas Infinite durante a visualização pública. Para os recursos suportados na visualização pública, consulte Disponibilidade da 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
É necessário ter um cluster
M10+para exportar registros. A exportação de registro não está disponível para clusters de nível gratuito ou compartilhado. Esse requisito não se aplica à exportação de evento do Feed de atividades, que é compatível com 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 registro se origina no plano de controle do Atlas no AWS
us-east-1, independentemente da região do cluster ou do provedor de nuvem. Se o seu cluster não estiver no AWSus-east-1, você incorrerá em cobranças 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 registros e se recupera sem intervenção manual:
Nova tentativa e disjuntor
Quando a entrega de registro para seu coletor externo falha, o Atlas tenta novamente automaticamente com backoff exponencial para até 3 tentativas por padrão. O atraso da 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 pia tem seu próprio disjuntor independente, portanto, os problemas com uma integração não afetam os outros.
dead letter queue (DLQ)
Quando as tentativas se esgotam ou os erros não podem ser repetidos (como credenciais inválidas), o Atlas enfileira eventos de registro com falha em uma dead letter queue (DLQ) com uma retenção de 7dias. O DLQ evita a perda de dados enquanto o coletor não está disponível.
Aviso
Registros com mais de 7 dias são excluídos permanentemente do DLQ. Se o coletor permanecer inacessível por mais de 7 dias, esses registros 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 coletor enquanto os registros estiverem em fila no DLQ, os registros em fila usarão a nova configuração quando forem reproduzidos. Por exemplo, se você alterar o destino de um bucket S3 para outro, os registros em fila 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 Project Owner quando:
A exportação de registro encontra erros não repetíveis (registros enfileirados no DLQ).
A exportação de registro falha após várias tentativas de repetição (registros enfileirados no DLQ).
A repetição da exportação de registro 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 guias Open Alerts ou Closed Alerts da página Project Alerts. Para saber mais sobre o ciclo de vida de alerta informativos, 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 registros em fila foram entregues.
Você pode personalizar destinatários de alerta e métodos de notificação nas configurações de alerta do seu projeto. Para 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 |
|---|---|
Exporte | |
Exporte | |
Exporte | |
Exporte | |
Exporte | |
Exporte |
Todos os destinos suportados podem exportar eventos da Lista de atividades no nível do projeto. A exportação de evento em nível de organização suporta apenas OpenTelemetry.