$indexStats (Estatísticas de Índice)
Última atualização: 2026-10-09
$indexStats (Estatísticas de Índice)
$indexStats retorna estatísticas de uso por índice — nome, contagem de acessos, falhas e horário do último uso — um documento por índice. Use-o para encontrar índices não utilizados ou avaliar taxas de acerto. Os contadores se acumulam na instância mongod e são zerados na reinicialização; coleções fragmentadas reportam por shard.
| Categoria | Avançado e Diagnóstico |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $indexStats: {} }
Retorno:Um documento de estatísticas por índice
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $indexStats: uso de cada índice em orders
db.orders.aggregate([
{ $indexStats: {} }
])
Saída:
// Um documento por índice com name, accesses etc.
📌 Notas
- Os contadores se acumulam desde a inicialização do mongod e são zerados na reinicialização
- Para tamanho e estrutura de índice, use $collStats
- Coleções fragmentadas emitem uma linha por shard
🏷️ Tags Relacionados
💡 Casos Relacionados
Backup e recuperação, segurança e operações
Fundamentos e princípios da indexação
Tipos de índice e recursos avançados
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
Q$indexStats pode encontrar índices não utilizados?
ASim, índices com accesses igual a 0 que ficam sem uso por muito tempo são candidatos a remoção.
QOs contadores são zerados?
ASim, reiniciar o mongod zera os contadores.
Q$indexStats aceita parâmetros?
ANão, basta usar { $indexStats: {} }.