db.collection.latencyStats() (método mongosh)

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as 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 do MongoDB específica da linguagem.

Definição

db.collection.latencyStats(options)

db.collection.latencyStats() returns latency statistics for a given collection. It is a wrapper around $collStats.

Este método tem o formato:

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

The histograms argument is an optional boolean. If histograms: true then latencyStats() adds latency histograms to the return document.

Dica

$collStats

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

Observação

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

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

Saída

latencyStats() returns a document containing a field latencyStats, containing the following fields:

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.
`transactions`	Estatísticas de latência para transações de banco de dados.

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

Nome do campo

Descrição

latency

A latência total, em microssegundos.

ops

O número total de operações realizadas na coleção 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 mais baixos entre 2048 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 tem os seguintes campos:

micros: o limite inferior 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: o número de operações com latência inferior ou igual a micros.

Por exemplo, se collStats retornar o seguinte histograma:

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

This indicates that there were [1]:

10 operações com 2 microssegundos ou menos
1 operação na faixa de [2, 4) microssegundos
1 operação na faixa de [4096, 6144) microssegundos
1000 operações no intervalo de [16384, 24576) microssegundos
100 operações no intervalo de [49152, 65536) microssegundos

[1]	A notação do símbolo `(` nesta página significa que o valor é exclusivo. A notação do símbolo `]` nesta página significa que o valor é inclusivo.

Exemplos

You can run latencyStats() in mongosh as follows:

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" : Long(16),
          "count" : Long(6)
        },
        {
          "micros" : Long(512),
          "count" : Long(1)
        }
      ],
      "latency" : Long(747),
      "ops" : Long(7)
    },
    "writes" : {
      "histogram" : [
        {
          "micros" : Long(64),
          "count" : Long(1)
        },
        {
          "micros" : Long(24576),
          "count" : Long(1)
        }
      ],
      "latency" : Long(26845),
      "ops" : Long(2)
    },
    "commands" : {
      "histogram" : [ ],
      "latency" : Long(0),
      "ops" : Long(0)
    }
  }
}

Voltar

db.collection.isCapped

db.collection.mapReduce()