$collStats (Estatísticas da Coleção)
Última atualização: 2026-10-09
$collStats (Estatísticas da Coleção)
$collStats retorna estatísticas de armazenamento da coleção — contagem de documentos, tamanho dos dados, informações de índice e detalhes do mecanismo de armazenamento — como um único documento. Use-o para planejamento de capacidade e monitoramento de crescimento. Selecione as estatísticas por campos como latencyStats, storageStats, count e queryExecStats. Os valores são aproximados, não exatos em tempo real.
| Categoria | Avançado e Diagnóstico |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $collStats: { latencyStats: { histograms: <bool> }, storageStats: {}, count: {}, queryExecStats: {} } }⚙️ Parâmetros
| storageStats | Retorna estatísticas de armazenamento (documentos, tamanhos de dados e índices, etc.). |
|---|---|
| count | Retorna estatísticas de contagem de documentos. |
| queryExecStats | Retorna estatísticas de execução de consultas. |
| latencyStats | Retorna estatísticas de latência, opcionalmente com histogramas. |
Retorno：Um único documento com estatísticas da coleção
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $collStats: armazenamento e contagem da coleção orders
db.orders.aggregate([
{ $collStats: { storageStats: {}, count: {} } }
])Saída：
// Um documento contendo count e storageStats📌 Notas
- As estatísticas são aproximadas, não exatas em tempo real
- $indexStats cobre apenas o uso de índices; $collStats é mais amplo
- Coleções fragmentadas retornam uma visão agregada
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
Q$collStats mostra tamanhos de índice?
ASim, storageStats inclui totalIndexSize e os tamanhos por índice.
QOs valores são em tempo real?
ANão, alguns vêm de metadados do mecanismo de armazenamento e são aproximados.
QComo $collStats difere de db.stats?
Adb.stats é em nível de banco de dados; $collStats mira uma coleção e emite um documento estruturado.
