Você pode configurar seus clusters do Atlas M10+ para exportar registros do sistema a cada minuto para OpenTelemetry (OTel).
Essa integração permite:
Especifique quais arquivos de log MongoDB você deseja exportar para o ponto de extremidade OTel. O Atlas suporta a exportação dos seguintes tipos de log:
mongodmongosmongod-auditmongos-audit
Configure até 10 caminhos de exportação, permitindo a você exportar logs para vários pontos de extremidade OTel simultaneamente.
Importante
Os registros podem conter informações confidenciais (incluindo PII). Você é responsável pelo armazenamento e tratamento dos seus logs no seu ponto de extremidade OTel. Para que o Atlas elimine determinadas informações antes de exportar registros, entre em contato com o Suporte do MongoDB.
Acesso necessário
Para exportar logs para um ponto de extremidade OTel, você deve ter Project Owner ou Organization Owner acesso ao Atlas.
Considerações
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.
Problemas ou novas tentativas de rede podem causar entradas de log duplicadas no ponto de extremidade OTel.
O Atlas força o TLS ao se conectar a pontos de extremidade OTLP e exige certificados assinados por uma Autoridade de Certificação (CA) pública. Certificados autoassinados não são permitidos.
Pré-requisitos
Você precisará de:
Um ponto de extremidade OTel existente.
URL e porta do ponto de extremidade.
Configuração de autenticação.
Um Atlas cluster
M10+executando o MongoDB 7.0 ou posterior.
Procedimento
Para exportar logs para um ponto de extremidade OTel, complete as etapas a seguir.
No Atlas, acesse a página Project Settings.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique no Ãcone ao lado de Project Overview.
A página Configurações do projeto é exibida.
No Atlas, acesse a página Project Integrations.
Clique na aba Integrations.
A página Integrações de projeto é exibida.
Conecte o Atlas ao seu ponto de extremidade OTel.
No campo OTLP Endpoint, insira a URL do seu ponto de extremidade OTel conforme ele aparece na sua conta do provedor OTel.
Nos campos OTLP Header, insira os cabeçalhos e valores que seu ponto de extremidade OTel exige para autenticação.
Em Log Type, selecione os tipos de logs que deseja exportar.
MongoDB Logs Registros de diagnóstico escritos por cada
mongodprocesso do servidor. Eles registram a inicialização e o desligamento do servidor , a configuração, as conexões, queries lentas, replicação, atividade de fragmentação e outros eventos operacionais.MongoDB Audit Logs Registros de auditoria emitidos por que acompanham ações de evento do sistema, como tentativas de autenticação, verificações de autorização , alterações de função e outras operações relevantes para a segurança. Esses registros são separados do registro principal do MongoDB
mongod.MongoDB Router Logs Registros de diagnóstico escritos por cada
mongosprocesso de roteador do em um cluster fragmentado. Elas capturam o comportamento especÃfico do roteador, como roteamento de queries para shards, atualizações de metadados de sharding e diagnóstico geral de processos.MongoDB Router Audit Logs Registros de auditoria emitidos pelos
mongosprocessos do roteador, registrando os mesmos tipos de eventos do sistema auditados, mas da perspectiva do roteador em uma implantação fragmentada.Events Eventos do Project Activity Feed, como eventos do ciclo de vida da integração e alterações no status de exportação de registro. Para saber mais, consulte Exportar eventos de feed de atividades para ferramentas externas.
Para saber mais sobre registros MongoDB , consulte Visualizar e baixar registros MongoDB .
Clique em Validate para confirmar que suas configurações e credenciais estão corretas antes de habilitar a exportação.
Clique em Save.
Exportar eventos de feed de atividades da organização
As integrações OpenTelemetry em nÃvel de organização exportam eventos de Feed de atividades em vez de registros de banco de dados . A exportação de evento da organização suporta apenas destinos compatÃveis com OTel.
Acesso necessário
Para exportar eventos da organização , você deve ter acesso Organization Owner ao Atlas.
Procedimento
Para exportar eventos da organização para um endpoint OTel, complete as etapas a seguir.
No Atlas, acesse a página Organization Settings.
Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.
Na barra lateral, clique em Organization Settings.
A página Configurações da organização é exibida.
No Atlas, acesse a página Organization Integrations.
Clique na aba Integrations.
A página Integrações da organização é exibida.
Conecte o Atlas ao seu ponto de extremidade OTel.
No campoOTLP Endpoint, insira a URL do seu endpoint OTel conforme ele aparece na sua conta do provedor OTel. O endpoint deve usar HTTPS com um certificado assinado por uma Autoridade de Certificação (CA) pública.
Nos campos OTLP Header, insira os cabeçalhos e os valores que o endpoint OTel exige para autenticação. Você pode especificar até 10 cabeçalhos com um tamanho combinado de até 2 KB.
Clique em Validate para confirmar que suas configurações e credenciais estão corretas antes de habilitar a exportação.
Clique em Save.
Alertas para falhas na exportação de logs
O Atlas notifica você automaticamente quando as exportações de registro falham ou se recuperam por meio de alertas padrão que estão habilitados para todos os projetos.
alerta padrão
Os alertas a seguir são ativados por padrão para todos os projetos com coletores de registro externos:
Esses alertas são informativos, o que significa que, quando a condição de alerta é atendida, o Atlas envia imediatamente notificações por e-mail a todos os usuários com a função Project Owner e registra o alerta no Project Activity Feed. Esses alertas não aparecem nas guias Open Alerts ou Closed Alerts da página Project Alerts. Você pode personalizar os destinatários e os métodos de notificação nas configurações Project Alerts. Para saber mais sobre o ciclo de vida de alerta informativos, consulte Fluxo de trabalho de alertas.
Eventos de lista de atividades
Além dos alertas, o Atlas registra os seguintes eventos informativos no Project Activity Feed:
Log export has recovered. Queued logs are ready to resume sending.
Log export has recovered. Queued logs are now being sent.
All queued logs have been delivered to sink.
Para visualizar esses eventos,consulte Visualizar Feed de atividades.
Para obter mais informações sobre como configurar notificações de alerta , consulte Configurar um alerta.