principal
toptopé um comando administrativo que retorna estatísticas de uso para cada coleção. Você pode usartopmétricas para comparar o desempenho relativo de suas collections entre si.Importante
O comando
topdeve ser executado em uma instânciado mongod do . Executartopem 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 .
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 } } }