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

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

db.collection.latencyStats(options)

Importante

Método mongosh

Esta página documenta un método mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.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.

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.

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

Nombre de campo

Descripción

latency

Un entero de 64bits que proporciona la latencia combinada total en microsegundos.

ops

Un entero de 64bits que indica 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 contiene los siguientes campos:

Nombre de campo	Descripción
`micros`	Un entero de 64bits que proporciona el límite de tiempo 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 64bits que indica 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:

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