Monitorar o MongoDB: saúde e consultas lentas
O menu MongoDB monitora o banco de cada cliente: se está no ar, as consultas lentas em andamento, as réplicas e o cache. Ele aparece no cliente que tem a connection string cadastrada e é só leitura em todos os planos: o Kubepier não escreve nem apaga nada no banco.
O que faz
| Plano | O que mostra |
|---|---|
| Free | Se o banco está no ar ou fora, a latência do ping e a versão. |
| Pro e Team | Painel de saúde: ok, lento ou fora; conexões; operações por segundo (duas amostras com 1 segundo de intervalo); réplicas e atraso de replicação; uso do cache do WiredTiger; operações lentas em andamento; coleções com mais tempo de uso (top) e as maiores coleções. |
Quando o MongoDB fica lento ou fora do ar
| Estado | Quando |
|---|---|
| Fora do ar | O ping não responde em 5 segundos |
| Lento | Qualquer um: ping de 100 ms ou mais, alguma operação rodando há 5 segundos ou mais, réplica 10 segundos ou mais atrás do primário, ou cache do WiredTiger em 95% ou mais |
| Ok | Nenhum dos casos acima |
Os mesmos limites valem na web e no desktop, e a tela diz qual deles foi cruzado.
Limites e tempos
| Limite | Valor |
|---|---|
| Operações lentas listadas | até 30, rodando há 1 segundo ou mais |
| Top de coleções | 10 |
| Maiores coleções | as 10 maiores do banco cadastrado no cliente |
| Ping | sem resposta em 5 segundos = fora do ar |
O que nunca aparece nas consultas lentas
Nas operações lentas, o filtro e o comando ficam só com os campos e os operadores: todo valor vira "?". Documentos nunca são lidos.
Permissões necessárias do seu lado
| Painel | Papel do usuário do MongoDB |
|---|---|
| Status (Free) | Qualquer usuário que autentique (ping e buildInfo) |
| Servidor, réplicas, operações lentas e top | clusterMonitor no banco admin |
| Maiores coleções | read no banco cadastrado no cliente |
Cada painel cai sozinho quando falta o papel e mostra qual papel falta; os outros continuam. No MongoDB Atlas, use um usuário de banco com o papel clusterMonitor e read no banco.
O que não é aceito
- Qualquer escrita, apagar, rodar consulta ou ler documento.
- Painel completo no Free.
Rede e rota de conexão
No cadastro do MongoDB, escolha a Rota de conexão. Direta: libere os IPs de saída (no Atlas, em Network Access → IP Access List). Pelo cluster: para MongoDB em IP privado ou private endpoint; replica sets e mongodb+srv:// funcionam, resolvidos dentro do cluster. Na rota Direta, um host que resolve só para IP privado responde host_privado na hora, sem tentar conectar. Conexão encerrada pelo servidor (conexao_encerrada) em geral é firewall sem os IPs de saída, TLS ou porta errados, ou limite de conexões: libere os IPs ou troque para Pelo cluster.
Erros comuns
- "Precisa do papel clusterMonitor": dê o papel ao usuário da connection string.
- Fora do ar: o servidor não respondeu em 5 segundos: confira a connection string e, na web, os IPs de saída na Access List do Atlas.