Docs Menu
Docs Home
/ /
Diagnósticos
Docs Home
/
Desarrollo
/
Comandos de base de datos
/
Diagnósticos
Docs Home
/
Desarrollo
/
Comandos de base de datos
/
Diagnósticos

collStats (comando de base de datos)

Definición

collStats

Obsoleto desde la versión 6.2.

En las versiones 6.2 y posteriores se utiliza el $collStats etapa de agregación.

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

Tip

En mongosh, este comando también se puede ejecutar mediante el método stats() auxiliar.collStats Se puede acceder a campos específicos de 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.

Comportamiento

Redacción

Al usar Queryable Encryption, $collStats la salida oculta cierta información para colecciones cifradas:

  • La salida omite "queryExecStats"

  • La salida omite "latencyStats"

  • La salida redacta "WiredTiger", si está presente, para incluir solo el campo url.

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 cierre inesperado de un mongod que utiliza el motor de almacenamiento Wired Tiger, las estadísticas de tamaño reportadas por collStats pueden ser 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:

Índices en curso

collStats Incluye información sobre los índices en construcción. Para más detalles, consulte:

Restricción del estado del set de réplicas

Para ejecutarse en un miembro del conjunto de réplicas, collStats las operaciones requieren que PRIMARY SECONDARY el miembro esté en estado o. Si el miembro está en otro estado,STARTUP2 como, la operación genera un error.

Colecciones inexistentes

Si ejecuta collStats para una colección inexistente, entonces, dependiendo de la implementación de su base de datos, collStats podrí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 collStats en la colección restaurants, especificando una escala de 1024 bytes:

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

El siguiente documento proporciona una representación de la salida collStats. 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" : [
     <string>,
  ],
  "totalIndexSize" : <number>,
  "totalSize" : <number>,
  "indexSizes" : {
          "_id_" : <number>,
          "<indexName>" : <number>,
          ...
  },
  "scaleFactor" : <number>
  "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 collStats comando en 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.

nindexes incluye índices que se están construyendo actualmente en su recuento.

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.

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.

collStats.totalIndexSize

Suma del espacio en disco utilizado por 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.

totalIndexSize incluye índices que se están construyendo actualmente en el tamaño total.

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.

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.

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 al usar el motor de almacenamiento WiredTiger. Al usar el cifrado consultable, los datos de WiredTiger se ocultan únicamente en el url campo.

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

Next

connPoolStats

En esta página