/ /

Comandos de base de datos

Diagnósticos

Docs Home

Manual de base de datos

Referencia

Comandos de base de datos

Diagnósticos

collStats (comando de base de datos)

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

collStats

El comando devuelve una variedad de estadísticas de almacenamiento para una colección collStats determinada.

Tip

mongoshEn, este comando también se puede ejecutar a través del Método auxiliar. Se puede accederstats() a campos específicos de collStats dataSize() la salida medianteestimatedDocumentCount() losisCapped() métodoslatencyStats() storageSize()totalIndexSize() totalSize() auxiliares,,,,, y.

Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Para ejecutar collStats, utiliza el método db.runCommand( { <command> } ).

Compatibilidad

Este comando 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.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     collStats: <string>,
     scale: <int>
   }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
`collStats`	string	El nombre de la colección objetivo.
`scale`	Int	Opcional. El factor de escala para los distintos tamaños de datos (excepto aquellos que especifican la unidad de medida en el nombre del campo). El valor predeterminado es 1 para mostrar los datos de tamaño en bytes. Para mostrar kilobytes en lugar de bytes, especifique un valor de `scale` de `1024`. Si se especifica un factor de escala no entero, MongoDB utiliza la parte entera del factor especificado. Por ejemplo, si se especifica un factor de escala de `1023.999`, MongoDB utiliza `1023` como factor de escala. El factor de escala redondea los valores de tamaño afectados a números enteros. A partir de la versión 4.2, la salida incluye el `scaleFactor` utilizado para escalar los valores de tamaño.

Nota

A partir de la 4.2 versión, MongoDB elimina el motor de almacenamiento1 MMAPv. Junto con este cambio, MongoDB elimina la1 opción específica de collStats MMAPv.verbose

Comportamiento

Tamaños escalados

A menos que el nombre de la métrica lo especifique (como "bytes currently in the cache"), los valores relacionados con el tamaño se muestran en bytes y pueden ser anulados por scale.

El factor de escala redondea los valores de tamaño afectados a números enteros.

Precisión tras un apagado inesperado

Después de un apagado incorrecto de un mongod usando el motor de almacenamiento Wired Tiger, las estadísticas de tamaño informadas por pueden ser collStats inexactas.

La cantidad de deriva depende del número de operaciones de inserción, actualización o eliminación realizadas entre el último punto de control y el apagado no limpio. Los puntos de control suelen ocurrir cada 60 segundos. Sin embargo, las instancias mongod que se ejecutan con configuraciones --syncdelay no por defecto pueden tener puntos de control más o menos frecuentes.

Ejecuta validate en cada colección en el mongod para restaurar las estadísticas después de un apagado no limpio.

Después de un apagado no limpio:

validate actualiza la estadística de recuento en la collStats salida con el último valor.
Otras estadísticas, como la cantidad de documentos insertados o eliminados en la collStats salida, son estimaciones.

Índices en curso

A partir de MongoDB,4.2 el incluye información sobre los índices en construcción. Para más detalles,collStats consulte:

collStats.nindexes
collStats.indexDetails
collStats.indexBuilds
collStats.totalIndexSize
collStats.indexSizes

Restricción del estado del set de réplicas

Para que se ejecuten en un nodo del set de réplicas, las operaciones collStats requieren que el nodo esté en estado PRIMARY o SECONDARY. Si el nodo se encuentra en otro estado, como STARTUP2, la operación falla.

Colecciones inexistentes

Si ejecutacollStatspara una colección inexistente, entonces, dependiendo de la implementación de su base de datos, collStatspodría devolver 0 valores en los campos de salida en lugar de devolver un error.

Por ejemplo:

db.runCommand( { collStats : "nonExistentCollection" } )

Ejemplo de salida con valores 0 en los campos:

{
   ns: 'test.nonExistentCollection',
   size: 0,
   count: 0,
   ...
}

Ejemplo

La siguiente operación ejecuta el comando en collStats la restaurants colección, especificando una escala de 1024 bytes:

db.runCommand( { collStats : "restaurants", scale: 1024 } )

El siguiente documento proporciona una representación de la collStats salida. Los campos de salida pueden variar según la configuración de la colección y el motor de almacenamiento.

{
  "ns" : <string>,
  "size" : <number>,
  "timeseries" : {
     "bucketsNs" : <bucketName>,
     "bucketCount" : <number>,
     "avgBucketSize" : <number>,
     "numBucketInserts" : <number>,
     "numBucketUpdates" : <number>,
     "numBucketsOpenedDueToMetadata" : <number>,
     "numBucketsClosedDueToCount" : <number>,
     "numBucketsClosedDueToSize" : <number>,
     "numBucketsClosedDueToTimeForward" : <number>,
     "numBucketsClosedDueToTimeBackward" : <number>,
     "numBucketsClosedDueToMemoryThreshold" : <number>,
     "numCommits" : <number>,
     "numWaits" : <number>,
     "numMeasurementsCommitted" : <number>,
     "avgNumMeasurementsPerCommit": <number>
  },
  "count" : <number>,
  "avgObjSize" : <number>,
  "numOrphanDocs" : <number>,      // Available starting in MongoDB 6.0
  "storageSize" : <number>,
  "freeStorageSize" : <number>,
  "capped" : <boolean>,
  "max" : <number>,
  "maxSize" :  <number>,
  "wiredTiger" : {
     "metadata" : {
        "formatVersion" : <num>
     },
     "creationString" : <string>
     "type" :  <string>,
     "uri" :  <string>,
     "LSM" : {
        "bloom filter false positives" : <number>,
        "bloom filter hits" : <number>,
        "bloom filter misses" : <number>,
        "bloom filter pages evicted from cache" : <number>,
        "bloom filter pages read into cache" : <number>,
        "bloom filters in the LSM tree" : <number>,
        "total size of bloom filters" : <number>,
        "chunks in the LSM tree" : <number>,
        "highest merge generation in the LSM tree" : <number>,
        "queries that could have benefited from a Bloom filter that did not exist" : <number>,
        "sleep for LSM checkpoint throttle" : <number>,
        "sleep for LSM merge throttle" : <number>
        "total size of bloom filters" : <number>
     },
     "block-manager" : {
         "allocations requiring file extension" : <number>,
         "blocks allocated" : <number>,
         "blocks freed" : <number>,
         "checkpoint size" : <number>,
         "file allocation unit size" : <number>,
         "file bytes available for reuse" : <number>,
         "file magic number" : <number>,
         "file major version number" : <number>,
         "file size in bytes" : <number>,
         "minor version number" : <number>
     },
     "btree" : {
         "btree checkpoint generation" : <number>,
         "column-store fixed-size leaf pages" : <number>,
         "column-store internal pages" : <number>,
         "column-store variable-size RLE encoded values" : <number>,
         "column-store variable-size deleted values" : <number>,
         "column-store variable-size leaf pages" : <number>,
         "fixed-record size" : <number>,
         "maximum internal page key size" : <number>,
         "maximum internal page size" : <number>,
         "maximum leaf page key size" : <number>,
         "maximum leaf page size" : <number>,
         "maximum leaf page value size" : <number>,
         "maximum tree depth" : <number>,
         "number of key/value pairs" : <number>,
         "overflow pages" : <number>,
         "pages rewritten by compaction" : <number>,
         "row-store empty values" : <number>,
         "row-store internal pages" : <number>,
         "row-store leaf pages" : <number>
     },
     "cache" : {
        "bytes currently in the cache" : <number>,
        "bytes dirty in the cache cumulative" : <number>,
        "bytes read into cache" : <number>,
        "bytes written from cache" : <number>,
        "checkpoint blocked page eviction" : <number>,
        "data source pages selected for eviction unable to be evicted" : <number>,
        "eviction walk passes of a file" : <number>,
        "eviction walk target pages histogram - 0-9" : <number>,
        "eviction walk target pages histogram - 10-31" : <number>,
        "eviction walk target pages histogram - 128 and higher" : <number>,
        "eviction walk target pages histogram - 32-63" : <number>,
        "eviction walk target pages histogram - 64-128" : <number>,
        "eviction walks abandoned" : <number>,
        "eviction walks gave up because they restarted their walk twice" : <number>,
        "eviction walks gave up because they saw too many pages and found no candidates" : <number>,
        "eviction walks gave up because they saw too many pages and found too few candidates" : <number>,
        "eviction walks reached end of tree" : <number>,
        "eviction walks started from root of tree" : <number>,
        "eviction walks started from saved location in tree" : <number>,
        "hazard pointer blocked page eviction" : <number>,
        "in-memory page passed criteria to be split" : <number>,
        "in-memory page splits" : <number>,
        "internal pages evicted" : <number>,
        "internal pages split during eviction" : <number>,
        "leaf pages split during eviction" : <number>,
        "modified pages evicted" : <number>,
        "overflow pages read into cache" : <number>,
        "page split during eviction deepened the tree" : <number>,
        "page written requiring cache overflow records" : <number>,
        "pages read into cache" : <number>,
        "pages read into cache after truncate" : <number>,
        "pages read into cache after truncate in prepare state" : <number>,
        "pages read into cache requiring cache overflow entries" : <number>,
        "pages requested from the cache" : <number>,
        "pages seen by eviction walk" : <number>,
        "pages written from cache" : <number>,
        "pages written requiring in-memory restoration" : <number>,
        "tracked dirty bytes in the cache" : <number>,
        "unmodified pages evicted" : <number>
     },
     "cache_walk" : {
        "Average difference between current eviction generation when the page was last considered" : <number>,
        "Average on-disk page image size seen" : <number>,
        "Average time in cache for pages that have been visited by the eviction server" : <number>,
        "Average time in cache for pages that have not been visited by the eviction server" : <number>,
        "Clean pages currently in cache" : <number>,
        "Current eviction generation" : <number>,
        "Dirty pages currently in cache" : <number>,
        "Entries in the root page" : <number>,
        "Internal pages currently in cache" : <number>,
        "Leaf pages currently in cache" : <number>,
        "Maximum difference between current eviction generation when the page was last considered" : <number>,
        "Maximum page size seen" : <number>,
        "Minimum on-disk page image size seen" : <number>,
        "Number of pages never visited by eviction server" : <number>,
        "On-disk page image sizes smaller than a single allocation unit" : <number>,
        "Pages created in memory and never written" : <number>,
        "Pages currently queued for eviction" : <number>,
        "Pages that could not be queued for eviction" : <number>,
        "Refs skipped during cache traversal" : <number>,
        "Size of the root page" : <number>,
        "Total number of pages currently in cache" : <number>
     },
     "compression" : {
        "compressed page maximum internal page size prior to compression" : <number>,
        "compressed page maximum leaf page size prior to compression " : <number>,
        "compressed pages read" : <number>,
        "compressed pages written" : <number>,
        "page written failed to compress" : <number>,
        "page written was too small to compress" : 1
     },
     "cursor" : {
        "bulk loaded cursor insert calls" : <number>,
        "cache cursors reuse count" : <number>,
        "close calls that result in cache" : <number>,
        "create calls" : <number>,
        "insert calls" : <number>,
        "insert key and value bytes" : <number>,
        "modify" : <number>,
        "modify key and value bytes affected" : <number>,
        "modify value bytes modified" : <number>,
        "next calls" : <number>,
        "open cursor count" : <number>,
        "operation restarted" : <number>,
        "prev calls" : <number>,
        "remove calls" : <number>,
        "remove key bytes removed" : <number>,
        "reserve calls" : <number>,
        "reset calls" : <number>,
        "search calls" : <number>,
        "search near calls" : <number>,
        "truncate calls" : <number>,
        "update calls" : <number>,
        "update key and value bytes" : <number>,
        "update value size change" : <num>
     },
     "reconciliation" : {
        "dictionary matches" : <number>,
        "fast-path pages deleted" : <number>,
        "internal page key bytes discarded using suffix compression" : <number>,
        "internal page multi-block writes" : <number>,
        "internal-page overflow keys" : <number>,
        "leaf page key bytes discarded using prefix compression" : <number>,
        "leaf page multi-block writes" : <number>,
        "leaf-page overflow keys" : <number>,
        "maximum blocks required for a page" : <number>,
        "overflow values written" : <number>,
        "page checksum matches" : <number>,
        "page reconciliation calls" : <number>,
        "page reconciliation calls for eviction" : <number>,
        "pages deleted" : <number>
     },
     "session" : {
        "object compaction" : <number>,
     },
     "transaction" : {
        "update conflicts" : <number>
     }
  },
  "nindexes" : <number>,
  "indexDetails" : {
     "_id_" : {
        "metadata" : {
           "formatVersion" : <number>
        },
        ...
     },
     ...
  },
  "indexBuilds" : [            // Available starting in MongoDB 4.2
     <string>,
  ],
  "totalIndexSize" : <number>,
  "totalSize" : <number>,
  "indexSizes" : {
          "_id_" : <number>,
          "<indexName>" : <number>,
          ...
  },
  "scaleFactor" : <number> // Available starting in MongoDB 4.2
  "ok" : <number>
}

Salida

collStats.ns: El espacio de nombres de la colección actual, que sigue el formato [database].[collection].

collStats.size

El tamaño total sin comprimir en memoria de todos los registros de una colección. El size campo totalIndexSize no incluye el tamaño de los índices asociados a la colección, que se informa en el campo.

El argumento scale afecta a este valor. La compresión de datos no lo afecta.

collStats.timeseries

timeseries aparece cuando se ejecuta el comando en collStats una colección de series de tiempo.

Este documento contiene datos para uso diagnóstico interno.

collStats.count: El número de objetos o documentos en esta colección.

collStats.avgObjSize: Tamaño promedio de un objeto en la colección. El argumento scale no afecta este valor.

collStats.numOrphanDocs: El número de documentos huérfanos en la colección.
Novedades en la versión 6.0.

collStats.storageSize

La cantidad total de almacenamiento asignada a esta colección para el almacenamiento de documentos. El scale argumento afecta a este valor.

Si los datos de la colección están comprimidos (que es el), el tamaño de almacenamiento refleja el tamaño comprimido y puede ser menor que el default for WiredTiger valor collStats.size de.

storageSize no incluye el tamaño del índice. Consulte para conocer el tamaño del índice.totalIndexSize

collStats.freeStorageSize

No disponible para el motor de almacenamiento en memoria

La cantidad de almacenamiento disponible para reutilización. El argumento scale afecta este valor.

El campo solo está disponible si el almacenamiento está disponible para su reutilización (es decir, es mayor que cero).

collStats.nindexes

Número de índices de la colección. Todas las colecciones tienen al menos un índice en el campo _id.

A partir de MongoDB,4.2 nindexes incluye en su recuento aquellos índices que se están construyendo actualmente.

collStats.indexDetails

Un documento que reporta datos del motor de almacenamiento WiredTiger para cada índice de la colección. Otros motores de almacenamiento devolverán un documento vacío.

Los campos en este documento son los nombres de los índices, mientras que los valores son documentos que contienen estadísticas del índice proporcionadas por el motor de almacenamiento. Estas estadísticas son para uso diagnóstico interno.

A partir de MongoDB,4.2 indexDetails contiene detalles sobre los índices que se están construyendo actualmente, incluidas advertencias y errores.

collStats.indexBuilds: Una matriz que contiene los nombres de los índices que se están creando en la colección. Una vez que se completa la creación de un índice, este no aparece indexBuilds en.
Nuevo en la versión 4.2.

collStats.totalIndexSize

El tamaño total de todos los índices. El argumento scale afecta a este valor.

Si un índice utiliza default for WiredTiger compresión de prefijo (que es), el tamaño devuelto refleja el tamaño comprimido para dichos índices al calcular el total.

A partir de MongoDB,4.2 totalIndexSize incluye en su total el tamaño de los índices que se están construyendo actualmente.

collStats.totalSize: La suma de y.storageSize totalIndexSizeEl scale argumento afecta este valor.

collStats.indexSizes

Este campo especifica la clave y el tamaño de cada índice existente en la colección. El argumento scale afecta a este valor.

Si un índice utiliza default for WiredTiger compresión de prefijo (que es), el tamaño devuelto refleja el tamaño comprimido.

A partir de MongoDB,4.2 indexSizes incluye los tamaños de los índices que se están construyendo actualmente.

collStats.scaleFactor

El valor scale utilizado por el comando.

Si especificó un factor de escala no entero, MongoDB usa la parte entera del factor especificado. Por ejemplo, si especifica un factor de escala de 1023.999, MongoDB usa 1023 como factor de escala.

Nuevo en la versión 4.2.

collStats.capped: Este campo será "verdadero" si la colección está limitada.

collStats.max: Muestra el número máximo de documentos que pueden estar presentes en una colección limitada.

collStats.maxSize: Muestra el tamaño máximo de una colección limitada.

collStats.wiredTiger

wiredTiger solo aparece cuando se utiliza el motor de almacenamiento WiredTiger.

Este documento contiene datos informados directamente por el motor WiredTiger y otros datos para uso de diagnóstico interno.

collStats.inMemory

inMemory Sólo aparece cuando se utiliza el motor de almacenamiento en memoria.

Este documento contiene datos informados directamente por el motor de almacenamiento y otros datos para uso de diagnóstico interno.

Volver

buildInfo

connPoolStats