Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Diagnóstico

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.

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

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

Saiba mais

Voltar

shardConnPoolStats

Próximo

validar