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

Importante

Método mongosh

Esta página documenta una Método mongosh. Esta no es la documentación para comandos de base de datos ni para controladores específicos del lenguaje, como Node.js.

Para el comando de base de datos, consulte el campo latencyStats devuelto por el collStats dominio.

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() devuelve estadísticas de latencia para una colección determinada. Es un contenedor $collStats de.

Este método tiene la forma:

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

El argumento histograms es un booleano opcional. Si histograms: true entonces latencyStats() añade histogramas de latencia al documento de retorno.

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

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

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() devuelve un documento que contiene un campo,latencyStats que contiene los siguientes campos:

Nombre de campo	Descripción
`reads`	Estadísticas de latencia para solicitudes de lectura.
`writes`	Estadísticas de latencia para solicitudes de escritura.
`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

La latencia total, en microsegundos.

ops

El número total de operaciones realizadas en la colección desde el inicio.

histogram

Una matriz de documentos incrustados, cada uno representando un rango de latencia. Cada documento cubre el doble del rango del documento anterior. Para valores inferiores, entre 2048 microsegundos y aproximadamente 1 segundo, el histograma incluye semitonos.

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`	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`	El número de operaciones con 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 había 1[]:

10 operaciones que toman 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 del símbolo `(` en esta página significa que el valor es exclusivo. La notación del símbolo `]` en esta página significa que el valor es inclusivo.

Ejemplos

Puede 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