ping (Verificação de Conectividade)
Última atualização: 2026-10-09
ping (Verificação de Conectividade)
ping verifica se o servidor MongoDB está acessível e responsivo, retornando { ok: 1 } em caso de sucesso. É o comando mais simples de health check, usado para verificar conexões na inicialização de scripts ou como sonda de monitoramento. Equivalente a db.adminCommand({ ping: 1 }).
| Categoria | Monitoramento e Diagnóstico |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.adminCommand({ ping: 1 })▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// ping: autoverificação de conectividade
const res = db.adminCommand({ ping: 1 })
if (res.ok === 1) {
print("Conexão MongoDB OK")
} else {
print("Falha na conexão: " + res.errmsg)
}Saída：
Conexão MongoDB OK📌 Notas
- { ok: 1 } significa que a conexão está saudável
- Funciona contra replica sets/clusters fragmentados (qualquer membro alcançável)
- ping não faz E/S de dados; custo desprezível
🏷️ Tags Relacionados
💡 Casos Relacionados
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO ping pode medir latência?
ANão diretamente. Cronometre você mesmo db.runCommand({ ping: 1 }), ou use a API de monitoramento de servidor do driver.
QO que ping retorna?
AEm caso de sucesso retorna { ok: 1 }; servidores inacessíveis levantam um erro de rede ou retornam ok: 0.
Qping vs hello?
Aping apenas verifica acessibilidade; hello informa papel do servidor, versão e topologia.
