indexStats() (Estatísticas de Uso de Índice)
Última atualização: 2026-10-09
indexStats() (Estatísticas de Uso de Índice)
indexStats() informa estatísticas de uso por índice, ex.: `db.users.indexStats()` — contagens de acesso, totais de acerto/erro e mais para cada índice. Ele ajuda a encontrar índices nunca usados para remover, reduzindo amplificação de escrita e armazenamento. Observe que os contadores acumulam desde a última inicialização do servidor ou reconstrução do índice.
| Categoria | Índice e Administração |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.indexStats()Retorno：Matriz de estatísticas de índice com name, accesses, hits, misses.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// indexStats: vê com que frequência cada índice é usado
const stats = db.users.indexStats()
stats.forEach(s => print(s.name + ': ' + s.accesses.ops + ' ops'))Saída：
_id_: 120 ops
age_1: 45 ops
email_1: 3 ops📌 Notas
- Considere remover índices com zero acessos para reduzir a amplificação de escrita
- Os contadores são zerados no reinício do servidor ou reconstrução do índice
- Exige que a coleta de métricas do servidor esteja habilitada
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO indexStats pode revelar índices não utilizados?
ASim — índices com accesses.ops zero ou quase zero raramente são usados e são candidatos à remoção.
QQuando os contadores de indexStats começam?
AEles acumulam desde a última inicialização do servidor ou reconstrução do índice.
QQual o benefício de remover índices não utilizados?
AMenos amplificação de escrita durante inserções/atualizações e disco e memória liberados.
