Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

top (comando de banco de dados)

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ância do mongod . Executar top em uma instância 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
  • 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.

insert

Estatísticas de uso para operações do insert. Os campos insert.time e insert.count também atualizam writeLock.time e incremento writeLock.count.

update

Estatísticas de uso para operações do update. Os campos update.time e update.count também atualizam writeLock.time e incremento writeLock.count.

remove

Estatísticas de uso para operações do delete. Os campos remove.time e remove.count também atualizam writeLock.time e incremento writeLock.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 } }}