Definición
$indexStatsDevuelve estadísticas sobre el uso de cada índice en la colección. Si se ejecuta con control de acceso, autentíquese como un usuario con al menos el rol de
clusterMonitor.La etapa
$indexStatstoma un documento vacío y tiene la siguiente sintaxis:{ $indexStats: { } }Para cada índice, el documento de retorno incluye los siguientes campos:
Campo de salidaDescripciónnameNombre del índice.
Especificación de clave de índice.
See also: spec.
El nombre de host y el puerto del proceso
mongod.Métricas de uso del índice para el host asociado host, que incluyen:
ops: el número de operaciones de usuario que utilizaron el índice. Este valor excluye las operaciones internas, como la eliminación por índices TTL o las operaciones de división y migración de fragmentos. Esta exclusión también cubre el acceso al índice desde la replicación, como la aplicación de oplog y la creación de índices durante la sincronización inicial.since: el tiempo desde el cual MongoDB recopiló las estadísticas
ADVERTENCIA: El campo
accessesinforma métricas de uso de índice solo para el nodo donde se ejecuta la query. Para obtener estadísticas más completas sobre el uso de índices, ejecuta$indexStatsen cada nodo del clúster.El nombre del fragmento asociado con el anfitrión
Solo disponible para un clúster fragmentado.
El documento de especificación detallada para el índice, que incluye la clave del índice y las propiedades del índice.
La opción de índice
hiddensolo se incluye si el valor estrue.Indica si el índice se está compilando actualmente.
Solo disponible si
true.
Comportamiento
Accede a Campo
Las estadísticas reportadas por el campo accesos solo se aplican al nodo donde se ejecuta la query y solo incluyen el acceso al índice impulsado por solicitudes de usuario. El campo accesses excluye las siguientes operaciones internas:
Eliminación mediante índices TTL
Operaciones de división y migración de fragmentos
Acceso al índice desde la replicación, como la aplicación de oplog y la creación de índices durante la sincronización inicial
Restricciones
$indexStatsdebe ser la primera etapa en un pipeline de agregación.$indexStatsno se permite en las transacciones.
Consideraciones sobre el restablecimiento de las estadísticas del índice
Ejemplos
El siguiente ejemplo utiliza la colección movies del conjunto de datos de muestra sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en su implementación, consulte Cargar el conjunto de datos de muestra.
Cree los siguientes índices en la colección movies:
db.movies.createIndex( { year: 1, title: 1 } )db.movies.createIndex( { rated: 1, year: 1 } )db.movies.createIndex( { metacritic: 1 }, { partialFilterExpression: { rated: "R" } })Ejecutar algunas consultas contra la colección:
db.movies.find( { rated: "R" } )db.movies.find( { year: 1994 } ).sort( { title: 1 } )db.movies.find( { metacritic: { $gt: 90 } } )La siguiente operación de agregación devuelve un documento que contiene estadísticas de uso para cada índice en la colección movies:
db.movies.aggregate( [ { $indexStats: { } } ] )[ { name: 'year_1_title_1', key: { year: 1, title: 1 }, host: ..., accesses: ..., spec: { v: 2, key: { year: 1, title: 1 }, name: 'year_1_title_1' } }, { name: 'rated_1_year_1', key: { rated: 1, year: 1 }, host: ..., accesses: ..., spec: { v: 2, key: { rated: 1, year: 1 }, name: 'rated_1_year_1' } }, { name: 'metacritic_1', key: { metacritic: 1 }, host: ..., accesses: ..., spec: { v: 2, key: { metacritic: 1 }, name: 'metacritic_1', partialFilterExpression: { rated: 'R' } } }, { name: '_id_', key: { _id: 1 }, host: ..., accesses: ..., spec: { v: 2, key: { _id: 1 }, name: '_id_' } }, { name: 'cast_text_fullplot_text_genres_text_title_text', key: { _fts: 'text', _ftsx: 1 }, host: ..., accesses: ..., spec: ... }]Para utilizar el controlador de MongoDB Node.js para agregar una etapa de $indexStats a una canalización de agregación, utilice el Operador $indexStats en un objeto de canalización.
El siguiente ejemplo crea una etapa de pipeline que retorna un documento que contiene estadísticas de uso para cada índice de la colección. A continuación, el ejemplo ejecuta la pipeline de agregación:
const pipeline = [{ $indexStats: {} }];
const cursor = collection.aggregate(pipeline);return cursor;