Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Orientações para monitoramento e alertas do Atlas

O MongoDB Atlas possui um conjunto robusto de métricas, telemetria e logs integrados que você pode utilizar diretamente no Atlas ou integrar à sua pilha de observabilidade e alertas de terceiros. Isso permite que você monitore e gerencie suas implantações do Atlas e responda a incidentes de forma proativa e em tempo real.

Monitorar seu sistema permite que você:

  • Compreender a integridade e o status do seu cluster

  • Saiba como as operações em execução no cluster estão afetando o banco de dados

  • Saiba se o seu hardware tem restrição de recursos

  • Executar otimização de volume de trabalho e query

  • Detecte e reaja a problemas em tempo real para melhorar a pilha do seu aplicativo

O Atlas fornece várias métricas para monitoramento e alertas. Você pode acompanhar a integridade, a disponibilidade, o consumo e o desempenho de suas implantações em dashboards e por meio de API. Você também pode visualizar várias métricas de cluster, monitorar o desempenho do banco de dados, configurar alertas e notificações de alerta, e baixar logs de atividades.

Métricas

As métricas de implantação oferecem perspicácia sobre o desempenho do hardware e a eficiência das operações do banco de dados. O Atlas coleta métricas para seus servidores, bancos de dados e processos do MongoDB e armazena os dados de métricas em vários níveis de granularidade. Para cada nível de granularidade, o Atlas calcula as métricas como médias das métricas relatadas no próximo nível de granularidade mais refinado. Muitas métricas têm um equivalente em relatórios de pico.

Você pode monitorar métricas na IU do Atlas usando a visualização de métricas, o Real-Time Performance Panel, o Query Profiler, o Performance Advisor e a página de Namespace Insights. Você também pode usar a Atlas CLI ou a API de administração do Atlas para canalizar métricas para uma ferramenta de sua escolha.

Alertas

O Atlas oferece alertas para mais de 200 tipos de eventos, permitindo que você personalize os alertas para um monitoramento preciso. O Atlas emite alertas para as condições do banco de dados e do servidor que você ajusta nas suas configurações de alerta. Quando uma condição aciona um alerta, o Atlas exibe um símbolo de aviso no cluster e envia notificações de alerta.

Você pode usar a UI do Atlas , a API de administração do Atlas , o Atlas CLI e o recurso Terraform integrado para configurar alertas e a notificação de alerta .

Monitoramento

As visualizações de monitoramento do Atlas fornecem insights sobre várias métricas principais, incluindo desempenho de hardware e eficiência da operação de banco de dados . Ferramentas como painéis de desempenho em tempo real para visibilidade de rede e operações, analisadores de query para rastrear tendências de eficiência e sugestões de índice automatizadas permitem monitorar e solucionar problemas com mais eficiência, gerando maior eficiência operacional. Por exemplo, esses gráficos podem ajudá-lo a entender o impacto das reinicializações e das eleições do servidor no desempenho do banco de dados .

Registros

O Atlas fornece registros para cada processo no cluster. Cada processo mantém uma conta de sua atividade em seu próprio arquivo de log.

Você pode baixar registros usando a UI do Atlas , o Atlas CLI e a API de administração do Atlas . Para saber mais, consulte Orientação para Auditoria e Registro do Atlas.

Single-region deployments have no unique considerations for integrations with third-party alerting tools, such as Datadog and Prometheus. See All Deployment Paradigm Recommendations.

Em clusters multirregionais, considere os possíveis custos de transferência de dados associados ao envio de logs e métricas entre regiões. Recomendamos que você configure o seu sistema de logs e auditoria para minimizar as transferências de dados entre regiões, possivelmente mantendo os logs locais na região onde são gerados.

As seguintes recomendações se aplicam a todos os paradigmas de implantação.

Para monitorar o desempenho do seu cluster ou banco de dados, você pode visualizar métricas do cluster, como taxa de transferência histórica, desempenho e métricas de utilização. A tabela a seguir lista algumas (mas não todas as) categorias importantes de métricas a serem monitoradas:

Operações do cluster do Atlas e métricas de conexão

  • opcounters

  • Tempos de execução da operação

  • Executores de query e segmentação de query

  • Conexões

  • Queues

  • Digitalização e Pedido

Métricas de hardware

  • CPU do sistema normalizado

  • CPU de processo normalizada

  • Latência do disco

  • IOPS de Disco

  • Espaço livre em disco

  • Memória do sistema

  • Trocar o uso

Métricas de replicação

  • atraso de replicação

  • janela de replicação de registro

  • Headroom de replicação

  • Oplog GB/hora

  • OpCounters - Repl

Você pode usar a UI do Atlas , a Atlas Administration API e o Atlas CLI para visualizar as métricas do Atlas cluster. Além disso, o Atlas oferece integrações internas com ferramentas de terceiros, como Datadog e Prometheus, e você também pode aproveitar a Atlas Administration API para integrar-se a outras ferramentas de métricas personalizadas.

Para saber mais, consulte Revisar métricas de cluster.

O Atlas se integra à sua pilha de observabilidade existente, permitindo que você receba alertas e tome decisões baseadas em dados sem precisar substituir suas ferramentas atuais ou alterar seus fluxos de trabalho. O Atlas pode enviar notificações de alerta com ferramentas de terceiros, como Microsoft Teams, PagerDuty, DataDog, Opsgenie, Splunk On‑Call e outras ferramentas para oferecer visibilidade tanto do desempenho do banco de dados quanto da pilha completa no mesmo local.

Configure alertas e notificações para eventos de segurança, como tentativas de login mal‑sucedidas, padrões de acesso incomuns e violações de dados. Em ambientes de desenvolvimento e teste, recomendamos configurar alertas para clusters que estiveram inativos por sete ou mais dias para ajudar a identificar quais clusters podem ser desligados para economizar custos.

Ao visualizar alertas na UI do Atlas, recomendamos que você use os filtros disponíveis para limitar os resultados por host, conjunto de réplicas, cluster, shard e muito mais, para ajudar a focar nos alertas mais críticos.

No mínimo, recomendamos configurar os seguintes alertas. Essas recomendações de alertas fornecem uma linha de base, mas você deve ajustá-las com base nas características do volume de trabalho. Onde as condições de "alta prioridade" forem especificadas na tabela a seguir, recomendamos que você configure vários alertas para a mesma condição, um para um nível de gravidade de baixa prioridade e outro para um nível de gravidade de alta prioridade . Isso permite que você defina as configurações de notificação de alerta para cada um separadamente.

O Atlas configura alguns alertas por padrão. Para saber mais sobre as configurações padrão para alertas, consulte Configurações padrão para alertas.

Condição
Limite de alerta recomendado: baixa prioridade
Limite de alerta recomendado: alta prioridade
Insights Chave

Oplog window

< 24h por 5 minutos

< 1h por 10 minutos

Monitore a janela de oplog de replicação, juntamente com o headroom de replicação, para determinar se o secundário pode precisar de uma ressincronização completa em breve. A janela de oplog geralmente ajuda a determinar com antecedência a resiliência dos secundários às interrupções planejadas e não planejadas.

Election events

> 3 por uma hora, notificar após 5 minutos

> 30 por uma hora, notificar após 5 minutos

Monitore os eventos de eleição, que ocorrem quando um nó primário é desativado e um nó secundário é eleito como o novo nó primário. Eventos de eleição frequentes podem interromper operações e impactar a disponibilidade, causando indisponibilidade temporária de gravação e possível rollback de dados. Manter os eventos de eleição ao mínimo garante operações de gravação consistentes e desempenho estável do cluster.

Read IOPS

> 4000 por 2 minutos

> 9000 por 5 minutos

Monitore se o IOPS de disco se aproxima do IOPS máximo provisionado. Determine se o cluster pode lidar com volumes de trabalho futuros.

Write IOPS

> 4000 por 2 minutos

> 9000 por 5 minutos

Monitore se o IOPS de disco se aproxima do IOPS máximo provisionado. Determine se o cluster pode lidar com volumes de trabalho futuros.

Latência de leitura

> 20ms por 5 minutos

> 50 s por 5 minutos

Monitore a latência do disco para acompanhar a eficiência da leitura e gravação do disco.

Latência de gravação

> 20ms por 5 minutos

> 50ms por mais de 5 minutos

Monitore a latência do disco para acompanhar a eficiência da leitura e gravação do disco.

Trocar o uso

> 2GB por 15 minutos

> 2GB por 15 minutos

Monitore a memória para determinar se é necessário atualizar para uma camada de cluster superior. Essa métrica representa o valor médio durante o período especificado pela granularidade da métrica.

Anfitrião inativo

15 minutos

24 horas

Monitore seus hosts para detectar imediatamente o tempo de inatividade. Um host inativo por mais de 15 minutos pode impacto a disponibilidade, enquanto o tempo de inatividade superior a 24 horas é crítico, colocando em risco a acessibilidade aos dados e o desempenho dos aplicação .

Não primário

5 minutos

5 minutos

Monitore o status dos seus conjuntos de réplicas para identificar instâncias onde não há nó primary. A falta de um primary por mais de 5 minutos pode interromper as operações de gravação e impacto a funcionalidade do aplicação .

Ativo ausente mongos

15 minutos

15 minutos

Monitore o status dos processos mongos ativos para garantir o roteamento eficaz das queries em clusters fragmentados. Um mongos ausente pode interromper o roteamento de queries.

Falhas na Página

> 50/segundo por 5 minutos

> 100/segundo por 5 minutos

Monitore as falhas da página para determinar se deve aumentar sua memória. Essa métrica exibe a taxa média de falhas de página nesse processo por segundo durante o período de amostra selecionado. Em ambientes não Windows, isso se aplica somente a falhas de páginas rígidas.

atraso de replicação

> 240 segundo por 5 minutos

> 1 hora por 5 minutos

Monitore o atraso da replicação para determinar se o secundário pode sair do oplog.

Falha no backup

Qualquer ocorrência

none

Monitore as operações de backup para garantir a integridade dos dados. Um backup com falha pode comprometer a disponibilidade dos dados.

Backup restaurado

Qualquer ocorrência

none

Verifique os backups restaurados para garantir a integridade dos dados e a funcionalidade do sistema.

Falha no snapshot fallback

Qualquer ocorrência

none

Monitore as operações de snapshot de fallback para garantir a redundância de dados e a capacidade de recuperação.

Cronograma de backup atrasado

> 12 horas

> 12 horas

Verifique os agendamentos de backup para garantir que estejam no caminho certo. Atrasar pode correr o risco de perda de dados e comprometer os planos de recuperação.

Leituras enfileiradas

> 0-10

> 10+

Monitore as leituras em fila para garantir a recuperação eficiente de dados. Altos níveis de leituras em fila podem indicar restrições de recursos ou gargalos de desempenho, exigindo otimização para manter a capacidade de resposta do sistema.

Gravações em fila

> 0-10

> 10+

Monitore as gravações em fila para manter o processamento de dados eficiente. Altos níveis de gravações em fila podem indicar restrições de recursos ou gargalos de desempenho, exigindo otimização para manter a capacidade de resposta do sistema.

Reinicia a última hora

> 2

> 2

Acompanhe o número de reinicializações na última hora para detectar problemas de instabilidade ou configuração. As reinicializações frequentes podem indicar problemas subjacentes que exigem pesquisa imediata para manter a confiabilidade e o tempo de atividade do sistema.

Qualquer ocorrência

none

Monitore as eleições primárias para garantir operações de cluster estáveis. Eleições frequentes podem indicar problemas de rede ou restrições de recursos, afetando potencialmente a disponibilidade e o desempenho do banco de dados.

Manutenção não é mais necessária

Qualquer ocorrência

none

Revise as tarefas de manutenção desnecessárias para otimizar recursos e minimizar as interrupções.

Manutenção iniciada

Qualquer ocorrência

none

Acompanhe o início das tarefas de manutenção para assegurar que as atividades planejadas prossigam sem contratempos. A supervisão adequada contribui para manter o desempenho do sistema e reduzir o tempo de inatividade durante a manutenção.

Manutenção programada

Qualquer ocorrência

none

Monitore a manutenção programada para se preparar para possíveis impactos no sistema.

> 5% para 5 minutos

> 20% para 5 minutos

Monitore o roubo de CPU em clusters AWS EC2 com desempenho dimensionável para identificar quando o uso da CPU excede a linha de base garantida devido a núcleos compartilhados. Altas porcentagens de roubo indicam que o saldo de crédito da CPU está esgotado, o que afeta o desempenho.

CPU

> 75% para 5 minutos

> 75% para 5 minutos

Monitore o uso da CPU para determinar se os dados são recuperados do disco em vez da memória.

Uso da partição do disco

> 90%

> 95% para 5 minutos

Monitore o uso da partição de disco para garantir disponibilidade de armazenamento suficiente. Altos níveis de uso podem levar à degradação do desempenho e possíveis interrupções do sistema.

To learn more, see Configure and Resolve Alerts.

Observação

Eventos de alerta de dimensionamento automático

For production environments, we recommend configuring alerts for the Atlas Auto-Scaling category to maintain visibility into scaling actions. Atlas generates alerts for both reactive and predictive auto-scaling events, including:

  • Dimensionamento automático da camada do cluster iniciado (reativo)

  • Iniciado o dimensionamento automático de computação preditiva

  • O dimensionamento automático preditivo não foi iniciado devido ao tier máximo

  • Escalonamento automático de disco iniciado

These alerts help you track when Atlas automatically adjusts cluster resources in response to workload changes. To learn more about auto-scaling alerts and how to configure them, see Fix Auto-Scaling Issues.

O Atlas fornece várias ferramentas que permitem monitorar e melhorar de forma proativa o desempenho do seu banco de dados.

O Real-Time Performance Panel (RTPP) na IU do Atlas fornece perspicácia sobre o tráfego de rede atual, operações de banco de dados e estatísticas de hardware dos hosts com uma granularidade de um segundo na IU do Atlas. Recomendamos que você use o RTPP para:

  • Identifique visualmente as operações relevantes do banco de dados

  • Avaliar os tempos de execução da consulta

  • Avalie a proporção de documentos digitalizados para documentos devolvidos

  • Monitore a carga e a taxa de transferência da rede

  • Descubra a possível latência de replicação em membros secundários de conjuntos de réplicas

  • Elimine as operações antes que elas sejam concluídas para liberar recursos valiosos

O RTPP não está disponível para monitorar a partir da Atlas Administration API, mas você pode ativar e desativar o RTPP a partir da Atlas Administration API com Atualizar configurações de um projeto.

Para aprender mais, consulte Monitorar o desempenho em tempo real.

O Analisador de query identifica queries lentas e gargalos e sugere o refinamento do índice e a restruturação da query para melhorar o desempenho do seu banco de dados. Ele fornece visibilidade das operações mais lentas em até sete dias na IU do Atlas, facilitando a identificação de tendências e outliers na eficiência da query. Recomendamos que você use esses dados para identificar e solucionar queries de baixo desempenho, reduzindo a sobrecarga de desempenho.

You can return log lines for slow queries that the Query Profiler identifies from the Atlas Administration API with Return Slow Queries.

To learn more, see Monitor Query Performance with the Query Profiler.

O Performance Advisor analisa automaticamente os logs em busca de queries de execução lenta e recomenda índices para criar e descartar. Ele analisa consultas lentas e fornece sugestões de índices para coleções individuais, classificadas por uma pontuação de impacto calculada, e adaptadas à sua carga de trabalho. É uma maneira fácil e imediata de implementar melhorias de alto impacto no desempenho. Recomendamos que você monitore regularmente, concentre-se em consultas lentas e ative o analisador de consultas seletivamente para minimizar a sobrecarga.

Você pode usar a UI do Atlas , o Atlas CLI e a API de administração do Atlas para visualizar queries lentas e sugestões para melhorar o desempenho de suas queries a partir do Performance Advisor.

Você pode retornar linhas de log para queries lentas que o Performance Advisor identifica na Atlas Administration API com Retornar queries lentas. Para retornar índices sugeridos e mais com a Atlas Administration API, consulte Performance Advisor.

Para saber mais, consulte Monitorar e melhorar consultas lentas com o Performance Advisor.

A página Namespace Insights na IU do Atlas permite que você monitore o desempenho e as métricas de uso da coleção. Ela exibe métricas (como o número de operações CRUD na coleção) e estatísticas (como o tempo médio de execução de consultas) para determinados hosts e tipos de operação para as coleções que você fixar para monitoramento. Isso proporciona uma visibilidade mais detalhada do desempenho da coleção, que pode ser utilizada para otimizar o desempenho do banco de dados, resolver problemas e tomar decisões sobre dimensionamento, indexação e ajuste de consultas.

Para saber mais, consulte Monitorar a latência de consulta no nível de coleção com o Namespace Insights.

O Feed de Atividades da Organização e o Feed de Atividades do Projeto na IU do Atlas listam todos os eventos que ocorrem para uma determinada organização ou projeto do Atlas, respectivamente. Você pode filtrar cada feed de atividades por tipo de evento e faixa de tempo para monitorar eventos como atualizações de acesso à API, alterações de configuração de alerta e muito mais. Isso permite revisar os registros de atividades da sua organização ou projeto no nível de granularidade desejado.

Os eventos de dimensionamento automático, incluindo ações reativas e preditivas de dimensionamento automático, são registrados no Feed de atividades. Filtre esses eventos para distinguir entre o dimensionamento reativo que o uso atual de recursos aciona e o dimensionamento preditivo que os padrões de demanda cíclica projetados acionam. Essa visibilidade ajuda você a entender quando e por que o Atlas ajusta os recursos do cluster automaticamente.

You use the Atlas UI, Atlas CLI, and Atlas Administration API to retrieve events from each activity feed. To learn more, see View Activity Feed.

O Atlas retém os últimos 30 dias de mensagens de log e mensagens de auditoria de eventos do sistema. Você pode baixar os logs do Atlas a qualquer momento até o final de seus períodos de retenção usando a IU do Atlas, a API de administração do Atlas e o Atlas CLI.

To learn more, see View and Download MongoDB Logs.

Você também pode exportar registros para um bucket do AWS S3. Ao configurar esse recurso, o Atlas exporta de mongod, mongos e logs de auditar para um bucket do AWS S3 a cada minuto.

Os exemplos seguintes demonstram como permitir o monitoramento usando as ferramentas do Atlas para automação.

Execute o seguinte comando para recuperar a quantidade de espaço usado e livre no disco especificado. Essa métrica pode ser utilizada para verificar se o sistema está ficando sem espaço disponível.

atlas metrics disks describe atlas-lnmtkm-shard-00-00.ajlj3.mongodb.net:27017 data \
--granularity P1D \
--period P1D \
--type DISK_PARTITION_SPACE_FREE,DISK_PARTITION_SPACE_USED \
--projectId 6698000acf48197e089e4085 \

Execute o comando a seguir para criar uma notificação de alerta para um endereço de e-mail quando seu sistema não tiver um primary.

atlas alerts settings create \
--enabled \
--event "NO_PRIMARY" \
--matcherFieldName CLUSTER_NAME \
--matcherOperator EQUALS \
--matcherValue ftsTest \
--notificationType EMAIL \
--notificationEmailEnabled \
--notificationEmailAddress "myName@example.com" \
--notificationIntervalMin 5 \
--projectId 6698000acf48197e089e4085

Execute o seguinte comando para habilitar o limite de operação lenta gerenciado pelo Atlas para o seu projeto.

atlas performanceAdvisor slowOperationThreshold enable --projectId 56fd11f25f23b33ef4c2a331

Execute o seguinte comando para baixar um arquivo compactado que contém os registros MongoDB para o host especificado em seu projeto.

atlas logs download cluster0-shard-00-00.a1b2c.mongodb.net mongodb.gz