Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

principal

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Campos do evento
  • Exemplo
  • Saiba mais
top

top é um comando administrativo que retorna estatísticas de uso para cada coleção. Você pode usar top 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 . Executar top em uma instância do mongos retorna um erro.

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 .

Ao usar a Queryable Encryption, o comando top retorna apenas o nome da coleção.

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

Emita o comando top no banco de dados administrativo:

db.runCommand(
{
top: 1
}
)

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 commands.time e commands.count atualizam os campos writeLock ou os campos readLock .

Por exemplo, incremento das operações de agregação readLock.time e readLock.count. Incentivos de criação de índice writeLock.time e writeLock.count.

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
}
}
}

Voltar

shardConnPoolStats