principal
top
top
é um comando administrativo que retorna estatísticas de uso para cada coleção. Você pode usartop
métricas para comparar o desempenho relativo de suas collections entre si.Importante
O comando
top
deve ser executado em uma instânciado mongod do . Executartop
em uma instância do mongos retorna um erro.
Definição
Para cada coleção, top
retorna a quantidade de time
, em microssegundos, que cada evento leva para ser executado e um count
de quantas vezes cada evento foi executado. As métricas time
e count
são redefinidas somente depois que você reiniciar sua instância mongod
.
Redação
Ao usar a Queryable Encryption, o comando top
retorna apenas o nome da coleção.
Compatibilidade
Esse comando está disponível em implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
Importante
Este comando não é suportado em instâncias sem servidor. Para obter mais informações, consulte Comandos não suportados.
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Sintaxe
Emita o comando top
no banco de dados administrativo:
db.runCommand( { top: 1 } )
Campos do evento
O comando top
retorna estatísticas de uso para os seguintes campos de evento:
Campo | Descrição |
---|---|
total | A combinação de todas as operações readLock e writeLock . |
readLock | Estatísticas de uso para operações que usam travas de leitura. Essas operações incluem, entre outras, queries e agregações. |
writeLock | Estatísticas de uso para operações que utilizam bloqueios de gravação. Essas operações incluem, entre outras, inserção, atualização e remoção de documentos. |
queries | Estatísticas de uso para operações de query como find . Os campos queries.time e queries.count também atualizam readLock.time e incremento readLock.count . |
getmore | Estatísticas de uso para operações do getMore . Os campos getmore.time e getmore.count também atualizam readLock.time e incremento readLock.count . |
insert | Estatísticas de uso para operações do insert . Os campos insert.time e insert.count também atualizam readLock.time e incremento readLock.count . |
update | Estatísticas de uso para operações do update . Os campos update.time e update.count também atualizam readLock.time e incremento readLock.count . |
remove | Estatísticas de uso para operações do delete . Os campos remove.time e remove.count também atualizam readLock.time e incremento readLock.count . |
commands | Estatísticas de uso para operações como agregações, criação de índice e remoção de índice. Dependendo do tipo de comando, os campos Por exemplo, incremento das operações de agregação |
Exemplo
A saída do comando top
se assemelha à seguinte saída:
{ "totals" : { note: "all times in microseconds", "records.users" : { "total" : { "time" : 305277, "count" : 2825 }, "readLock" : { "time" : 305264, "count" : 2824 }, "writeLock" : { "time" : 13, "count" : 1 }, "queries" : { "time" : 305264, "count" : 2824 }, "getmore" : { "time" : 0, "count" : 0 }, "insert" : { "time" : 0, "count" : 0 }, "update" : { "time" : 0, "count" : 0 }, "remove" : { "time" : 0, "count" : 0 }, "commands" : { "time" : 0, "count" : 0 } } }