Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

db.collection.latencyStats()

Nesta página

  • Definição
  • Saída
  • Exemplos

Definição

db.collection.latencyStats(options)

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.

Para o comando do banco de dados, consulte o campo latencyStats retornado pelo comando collStats.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

db.collection.latencyStats() retorna estatísticas de latência para uma determinada collection. É um encapsulador $collStats.

Este método tem o formato:

db.collection.latencyStats( { histograms: <boolean> } )

O argumento histograms é um booleano opcional. Se histograms: true , então latencyStats() adiciona histogramas de latência ao documento de retorno.

Dica

Veja também:

$collStats

Saída

latencyStats() retorna um documento com um campo latencyStats, contendo os seguintes campos:

Nome do campo
Descrição
reads
Estatísticas de latência para solicitações de leitura.
writes
Estatísticas de latência para solicitações de escrita.
commands
Estatísticas de latência para comandos de banco de dados.

Cada um desses campos contém um documento incorporado com os seguintes campos:

Nome do campo
Descrição
latency
Um número inteiro de 64 bits que informa o total de latência combinada em microssegundos.
ops
Um inteiro de 64 bits que informa o número total de operações realizadas na collection desde a inicialização.
histogram

Um array de documentos incorporados, cada um representando uma faixa de latência. Cada documento cobre o dobro da faixa do documento anterior. Para valores superiores entre 2.048 microssegundos e aproximadamente 1 segundo, o histograma inclui meios-passos.

Este campo só existe com a opção latencyStats: { histograms: true }. Faixas vazias com count zero são omitidas da saída.

Cada documento contém os seguintes campos:

Nome do campo
Descrição
micros

Um número inteiro de 64 bits que fornece o limite de tempo superior inclusivo da faixa de latência atual em microssegundos.

O intervalo do documento se estende entre o valor micros do documento anterior, exclusive, e o valor micros deste documento, inclusive.

count
Um número inteiro de 64 bits que informa o número de operações com latência inferior ou igual a micros.

Por exemplo, se collStats retornar o seguinte histograma:

histogram: [
  { micros: NumberLong(1), count: NumberLong(10) },
  { micros: NumberLong(2), count: NumberLong(1) },
  { micros: NumberLong(4096), count: NumberLong(1) },
  { micros: NumberLong(16384), count: NumberLong(1000) },
  { micros: NumberLong(49152), count: NumberLong(100) }
]

Isso indica que houve:

  • 10 operações com 1 microssegundo ou menos,

  • 1 operação na faixa de (1, 2] microssegundos,

  • 1 operação na faixa de (3072, 4096] microssegundos,

  • 1000 operações na faixa (12288, 16384] e

  • 100 operações na faixa (32768, 49152].

Exemplos

Você pode executar latencyStats() no mongosh da seguinte maneira:

db.data.latencyStats( { histograms: true } ).pretty()

latencyStats() retorna um documento como o seguinte:

{
  "ns" : "test.data",
  "localTime" : ISODate("2016-11-01T21:56:28.962Z"),
  "latencyStats" : {
    "reads" : {
      "histogram" : [
        {
          "micros" : NumberLong(16),
          "count" : NumberLong(6)
        },
        {
          "micros" : NumberLong(512),
          "count" : NumberLong(1)
        }
      ],
      "latency" : NumberLong(747),
      "ops" : NumberLong(7)
    },
    "writes" : {
      "histogram" : [
        {
          "micros" : NumberLong(64),
          "count" : NumberLong(1)
        },
        {
          "micros" : NumberLong(24576),
          "count" : NumberLong(1)
        }
      ],
      "latency" : NumberLong(26845),
      "ops" : NumberLong(2)
    },
    "commands" : {
      "histogram" : [ ],
      "latency" : NumberLong(0),
      "ops" : NumberLong(0)
    }
  }
}
← db.collection.isCapped()
db.collection.mapReduce() →

Nesta página