db.collection.latencyStats()

Nesta página

Definição

Compatibilidade
Saída
Exemplos

O MongoDB 5.0 é o fim da vida útil a partir de de 2024 outubro. Esta versão da documentação não é mais suportada. Para atualizar sua 5.0 implantação do, consulte o MongoDB 6.0 procedimentos de atualização.

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 nem drivers específicos de linguagem, como Node.js.

Para o comando de banco de dados 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.

db.collection.latencyStats() retorna estatísticas de latência para uma determinada coleção. É um encapsulador de $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

Compatibilidade

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

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, 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

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 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 contém os seguintes campos:

Nome do campo	Descrição
`micros`	Um número inteiro de 64bits que fornece o limite de tempo 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`	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(0), 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 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

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

Voltar

db.collection.isCapped

db.collection.mapReduce()