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 processo do servidor
mongod. 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 pelo
mongodque acompanham as 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 logs são separados do log principal do MongoDB.MongoDB Router Logs Registros de diagnóstico escritos por cada processo de roteador do
mongosem um cluster fragmentado. Elas capturam o comportamento especÃfico do roteador, como roteamento de queries para fragmentos, atualizações de metadados de fragmentação e diagnóstico geral de processos.MongoDB Router Audit Logs Logs de auditoria emitidos por processos do roteador
mongos, 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 de status de exportação de log. Para saber mais, consulte Exportar eventos do feed de atividades para FERRAMENTAS externas.
Para saber mais sobre os logs do MongoDB, consulte Exibir e baixar registros do 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 do feed de atividades da organização
As integrações de OpenTelemetry no nÃvel da organização exportam eventos do feed de atividades em vez de logs do banco de dados. A exportação de eventos da organização oferece suporte apenas a destinos compatÃveis com OTel.
Acesso necessário
Para exportar eventos da organização, você deve ter acesso a Organization Owner ao Atlas.
Procedimento
Para exportar eventos da organização para um ponto de extremidade OTel, siga 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 campo OTLP Endpoint, insira a URL do seu ponto de extremidade OTel conforme aparece na sua conta de provedor OTel. O ponto de extremidade deve usar HTTPS com um certificado assinado por uma Autoridade Certificadora (CA) pública.
Nos campos OTLP Header, insira os cabeçalhos e valores que seu ponto de extremidade 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 log falham ou são recuperadas por meio de alertas padrão que estão habilitados para todos os projetos.
alerta padrão
Os seguintes alertas estão habilitados por padrão para todos os projetos com External Log Sinks:
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 para todos os usuários com a função Project Owner e log o alerta no Project Activity Feed. Esses alertas não aparecem nas abas Open Alerts ou Closed Alerts da página Project Alerts. Você pode personalizar os destinatários das notificações e os métodos nas configurações do Project Alerts. Para aprender mais sobre o ciclo de vida do alerta informativo, consulte Fluxo de trabalho de alertas.
Eventos do feed de atividades
Além dos alertas, o Atlas log os seguintes eventos informativos para o 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 evento, consulte Visualizar feed de atividades.
Para obter mais informações sobre como configurar notificações de alerta, consulte Configurar um alerta.