db.colección.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 el comando de base de datos, consulte el campo latencyStats devuelto por el comando collStats.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Definición

db.collection.latencyStats(options)

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

Este método tiene la forma:

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

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

Tip

$collStats

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

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

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Salida

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

Nombre de campo	Descripción
`reads`	Estadísticas de latencia para solicitudes de lectura.
`writes`	Estadísticas de latencia para solicitudes de guardado.
`commands`	Estadísticas de latencia para comandos de bases de datos.
`transactions`	Estadísticas de latencia para transacciones de bases de datos.

Cada uno de estos campos contiene un documento incrustado con los siguientes campos:

Nombre de campo

Descripción

latency

Un número entero de 64 bits que indica la latencia total combinada en microsegundos.

ops

Un número entero de 64 bits que indica el número total de operaciones realizadas en la colección desde el inicio.

histogram

Un arreglo de documentos incrustados, cada uno representando un rango de latencia. Cada documento cubre el doble del rango del documento anterior. Para valores más bajos entre 2048 microsegundos y aproximadamente 1 segundo, el histograma incluye medias pasos.

Este campo solo existe si se utiliza la opción latencyStats: { histograms: true }. Los rangos vacíos con un valor count igual a cero no se incluyen en la salida.

Cada documento tiene los siguientes campos:

Nombre de campo	Descripción
`micros`	Un entero de 64bits que da el límite inferior inclusivo del rango de latencia actual en microsegundos. El rango del documento abarca entre el valor `micros` del documento anterior, exclusivo, y el valor `micros` de este documento, inclusivo.
`count`	Un entero de 64 bits que muestra el número de operaciones con una latencia menor o igual a `micros`.

Por ejemplo, si collStats devuelve el siguiente 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) }
]

Esto indica que hubo [1]:

10 operaciones que requieren 2 microsegundo o menos
1 operación en el rango [2, 4) microsegundos
1 operación en el rango [4096, 6144) microsegundos
1000 operaciones en el rango [16384, 24576) microsegundos
100 operaciones en el rango [49152, 65536) microsegundos

[1]	La notación de símbolo `(` en esta página significa que el valor es exclusivo. La notación del símbolo `]` en esta página indica que el valor es inclusivo.

Ejemplos

Puedes ejecutar latencyStats() en de la siguiente mongosh manera:

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

latencyStats() devuelve un documento como el siguiente:

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

Volver

db.collection.isCapped

db.collection.mapReduce