Você pode configurar seus clusters do M10+ Atlas 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 endpoint 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 registros para vários endpoints OTel simultaneamente.
Importante
Os registros podem conter informações confidenciais (incluindo PII). Você é responsável pelo armazenamento e tratamento dos seus logs no endpoint 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 registros para um endpoint OTel, você deve ter Project Owner acesso ou Organization Owner 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 registro duplicadas no endpoint OTel.
O Atlas impõe o TLS ao se conectar a endpoints 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 endpoint OTel existente.
URL e porta do endpoint.
Configuração de autenticação.
Um Atlas cluster
M10+executando o MongoDB 7.0 ou posterior.
Procedimento
Para exportar registros para um endpoint OTel, complete as etapas a seguir.
No Atlas, vá para 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 em Project Settings.
A página Configurações do projeto é exibida.
No Atlas, vá para a página Project Integrations.
Clique na aba Integrations.
A página Integrações de projeto é exibida.
Conecte o Atlas ao seu endpoint OTel.
No campo OTLP Endpoint, insira a URL do seu endpoint OTel conforme ele aparece na sua conta do provedor OTel.
Nos campos OTLP Header, insira os cabeçalhos e valores que seu endpoint 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 pelo que
mongodacompanham 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 registros são separados do registro principal do MongoDB .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 por
mongosprocessos do roteador, registrando os mesmos tipos de eventos do sistema auditados, mas da perspectiva do roteador em um sistema fragmentado.
Para saber mais, consulte Exibir e baixar logs 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.
Alertas para falhas na exportação de logs
Para garantir que você seja notificado se o Atlas parar de exportar logs para seu coletor externo, configure um alerta em nível de projeto:
No Atlas, vá para a página Project Alerts.
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.
Clique no ícone Alerts na barra de navegação.
Clique em Alerts sob o cabeçalho Project.
A página Alertas do projeto é exibida.
Selecione o destinatário, o método de notificação e a frequência do alerta.
Na seção Add Notification Method, selecione na lista de funções.
No menu suspenso Add Notifier, selecione a partir das opções descritas na tabela a seguir.
Opção de notificaçãoDescriçãoProjeto Atlas
Envia o alerta por e-mail ou mensagem de texto aos usuários com funções específicas no Projeto.
O Projeto Atlas é o destinatário de alerta padrão. Você pode configurar os roles para os quais o alerta é enviado e como ele é entregue. Você não pode adicionar um segundo projeto Atlas como destinatário.
O Projeto Atlas está disponível como uma opção na lista Add apenas se não estiver atualmente na lista de destinatários.
Marque as funções do Projeto que devem receber os alertas das caixas de seleção Select Role(s) ou marque All Roles para que todos os usuários do Projeto recebam o alerta.
Selecione SMS para enviar esses alertas para o número de celular configurado para cada usuário do Atlas Project na página Conta.
Selecione Email para enviar estes alertas para o endereço de e-mail configurado para cada usuário do Atlas Project em sua página Conta. Email está marcado por padrão.
Organização Atlas
Envia o alerta por e-mail ou mensagem de texto aos usuários com funções específicas na organização.
Marque os roles da organização que devem receber os alertas nas caixas de seleção Select Role(s) ou selecione All Roles para que todos os usuários da organização recebam o alerta.
Selecione SMS para enviar estes alertas para o número de celular configurado para cada usuário da Organização Atlas na página Conta.
Selecione Email para enviar esses alertas para o endereço de e-mail configurado para cada usuário Atlas organização página Conta. Email está marcado por padrão.
Atlas user
Envia o alerta por e-mail ou mensagem de texto para um Atlas user especificado.
Selecione SMS para enviar estes alertas para o número de celular configurado para o usuário do Atlas em sua página Conta.
Selecione Email para enviar esses alertas para o endereço de e-mail configurado para Atlas user na página Conta. Email está marcado por padrão.
Email
Envia o alerta para um endereço de e-mail.
SMS
Envia o alerta para um número de celular. O Atlas remove todas as pontuações e letras e usa somente os dígitos. Se você estiver fora dos Estados Unidos ou do Canadá, inclua
011e o código do país porque o Atlas usa o Twilio, com sede nos EUA, para enviar mensagens de texto. Como alternativa ao seu serviço fora dos EUA. use um número de telefone do Google voice.Por exemplo, digite
01164antes do número de telefone para enviar o alerta para um número de celular da Nova Zelândia.Slack
Envia o alerta para um canal do Slack. Insira o nome do canal e um token de API ou um token de Bot. Para criar um token de API, consulte o https://api.slack.com/web na página na sua conta do Slack. Para saber mais sobre os usuários bot no Slack, consulte https://api.slack.com/bot-users.
Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
Visualize ou edite o alerta por meio da UI do Atlas.
Acesse o query de alerta para a notificação na API de administração do Atlas.
PagerDuty
Envia o alerta para uma conta PagerDuty. Insira apenas a chave de serviço PagerDuty. Defina regras de escalonamento e atribuições de alerta diretamente no PagerDuty.
Os usuários podem confirmar os alertas PagerDuty apenas no dashboard do PagerDuty.
Todas as novas chaves do PagerDuty usam a API de eventos v2.
Se você tiver uma chave de API de eventos v1, poderá continuar a usar essa chave com o Atlas.
Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
Visualize ou edite o alerta por meio da UI do Atlas.
Acesse o query de alerta para a notificação na API de administração do Atlas.
Datadog
Envia o alerta para uma conta Datadog como um evento Datadog.
Quando o alerta é aberto pela primeira vez, o Atlas envia o alerta como um evento de "erro". Atualizações subsequentes são enviadas como eventos de "info". Quando o alerta é fechado, o Atlas envia um evento de "sucesso".
Insira sua chave API do DataDog em API Key e clique em Validate Datadog API Key.
Insira sua região de API .
O Atlas é compatível com as seguintes regiões do Datadog na UI do Atlas:
US1US3US5EU1AP1
O Datadog utiliza
US1por padrão.Para saber mais sobre as regiões de Datadog, consulte Sites de Datadog.
Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
Visualize ou edite o alerta por meio da UI do Atlas.
Acesse o query de alerta para a notificação na API de administração do Atlas.
(Opcional) Para habilitar o rastreamento de métricas do banco de dados , alterne Send Database Metrics para On.
(Opcional) Para habilitar o rastreamento de métricas de latência de coleção, alterne Send Collection Latency Metrics para On.
(Opcional) Para habilitar o rastreamento de métricas de forma de query , alterne Send Query Shape Metrics para On.
Clique em Save.
VictorOps
Envia o alerta para uma conta VictorOps.
Insira a chave API alfanumérica da VictorOps para integrar o ponto de extremidade VictorOps com alertas. Adicione traços à chave API para que ela corresponda ao formato
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Por exemplo,489f7he7-790b-9896-a8cf-j4757def1161. Insira uma chave de roteamento opcional para direcionar alertas para um grupo VictorOps específico. Clique em Post Test Alert para testar a configuração do VictorOps. Defina as regras de roteamento e escalonamento diretamente no VictorOps.Essa opção está disponível apenas para alertas que exigem confirmação. Você pode receber alertas informativos deste serviço de monitoramento de terceiros no Atlas. No entanto, você deve resolver esses alertas no serviço externo. Confirme os alertas VictorOps no dashboard do VictorOps.
Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
Visualize ou edite o alerta por meio da UI do Atlas.
Acesse o query de alerta para a notificação na API de administração do Atlas.
Opsgenie
Envia o alerta para uma conta Opsgenie. Insira apenas a chave API Opsgenie. Defina regras de escalonamento e atribuições de alerta diretamente no Opsgenie.
Essa opção está disponível apenas para alertas que exigem confirmação. Você pode receber alertas informativos deste serviço de monitoramento de terceiros no Atlas. No entanto, você deve resolver esses alertas no serviço externo. Confirme os alertas do Opsgenie no dashboard do Opsgenie.
Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
Visualize ou edite o alerta por meio da UI do Atlas.
Acesse o query de alerta para a notificação na API de administração do Atlas.
Equipes da Microsoft
Envia o alerta para um canal do Microsoft Teams como um Cartão adaptativo.
Para enviar notificações de alerta para um canal do Microsoft Teams, você deve criar um webhook de entrada do Microsoft Teams. Após criar o webhook, você pode utilizar o URL gerado automaticamente para configurar sua integração do Microsoft Teams no Atlas.
Para configurar a integração, consulte Integração com o Microsoft Teams.
Quando você visualiza ou edita o alerta para uma notificação do Microsoft Teams, a URL aparece parcialmente oculta.
Webhook
Envia uma solicitação POST HTTP para um endpoint para processamento programático. O corpo da solicitação contém um documento JSON que usa o mesmo formato do recurso de alertas de API de administração do Atlas.
Essa opção estará disponível somente se você tiver definido as configurações de Webhook na página Integrações.
Quando você exibe ou edita o alerta de uma notificação de webhook, o URL aparece parcialmente redigido, e o segredo aparece completamente redigido.
No campo Webhook URL, especifique a URL de destino para alertas baseados em webhook.
(Opcional) Se você configurar sua integração do webhook com um segredo, no campo Webhook Secret, especifique o segredo de autenticação para alertas baseados em webhook.
Na seção Recurrence, defina o alerta para acionar quando a condição de falha na exportação de registro durar mais de
60minutos e para reenviar a cada10080minutos (7 dias) até que o problema seja resolvido.Dessa forma, você será notificado se as falhas na exportação de log persistirem por um longo período, evitando notificações excessivas para problemas transitórios.
Clique em Save.
Para obter mais detalhes sobre a configuração de alertas, consulte Configurar um alerta.