MongoDB聚合：$indexStats

返回有关集合中每个索引使用情况的统计信息。如果运行时有访问控制，请至少以 clusterMonitor 角色的用户身份进行验证。

语法

{ $indexStats: { } }

对于每个索引，返回文件包括以下字段：

字段	含义
name	索引名称
key	索引规格
host	mongod 进程的主机名和端口。
accesses	使用索引的统计：ops 是使用索引的操作次数。since 是 MongoDB 收集统计数据的时间。
shard	主机分片相关的名称，只适用于分片集群。版本4.2.4后支持
spec	索引的完整规范文件，其中包括索引密钥规范文件。从 MongoDB 4.4 开始提供的隐藏索引选项只有在值为 true 时才会包含。4.2.4后支持
building	指示当前是否正在建立索引。仅在为 true 时可用。4.2.4后支持

索引的统计信息将在 mongod 重启或索引删除和恢复时重置。

应用

访问字段

所报告的统计数据访问次数 字段报告的统计数据只包括用户请求驱动的索引访问。它不包括内部操作，如通过 TTL 索引进行删除或块分割和迁移操作。

限制

• $indexStats 必须是聚合管道的第一阶段。
• 事务中不允许使用 $indexStats。

索引修改重置统计数据

修改现有索引（参见 collMod 命令）会重置该索引的统计数据。

例子

集合orders包含以下文档：

{ "_id" : 1, "item" : "abc", "price" : 12, "quantity" : 2, "type": "apparel" }
{ "_id" : 2, "item" : "jkl", "price" : 20, "quantity" : 1, "type": "electronics" }
{ "_id" : 3, "item" : "abc", "price" : 10, "quantity" : 5, "type": "apparel" }

在集合上创建以下两个索引：

db.orders.createIndex( { item: 1, quantity: 1 } )
db.orders.createIndex( { type: 1, item: 1 } )

针对数据集运行一些查询：

db.orders.find( { type: "apparel"} )
db.orders.find( { item: "abc" } ).sort( { quantity: 1 } )

要查看orders集合中索引使用情况的统计信息，运行以下聚合操作：

db.orders.aggregate( [ { $indexStats: { } } ] )

操作返回一个文档，其中包含每个索引的使用统计信息：

{
   "name" : "item_1_quantity_1",
   "key" : { "item" : 1, "quantity" : 1 },
   "host" : "examplehost.local:27018",
   "accesses" : {
      "ops" : NumberLong(1),
      "since" : ISODate("2020-02-10T21:11:23.059Z")
   },
   "shard" : "shardA",      // 运行在分片集群，MongoDB 4.2.4开始支持
   "spec" : {               // MongoDB 4.2.4开始支持
      "v" : 2,
      "key" : { "item" : 1, "quantity" : 1 },
      "name" : "item_1_quantity_1"
   }
}
{
   "name" : "item_1_price_1",
   "key" : { "item" : 1, "price" : 1 },
   "host" : "examplehost.local:27018",
   "accesses" : {
      "ops" : NumberLong(1),
      "since" : ISODate("2020-02-10T21:11:23.233Z")
   },
   "shard" : "shardA",      // 运行在分片集群，MongoDB 4.2.4开始支持
   "spec" : {               // MongoDB 4.2.4开始支持
      "v" : 2,
      "key" : { "item" : 1, "price" : 1 },
      "name" : "item_1_price_1"
   }
}
{
   "name" : "item_1",
   "key" : { "item" : 1 },
   "host" : "examplehost.local:27018",
   "accesses" : {
      "ops" : NumberLong(0),
      "since" : ISODate("2020-02-10T21:11:22.947Z")
   },
   "shard" : "shardA",      // 运行在分片集群，MongoDB 4.2.4开始支持
   "spec" : {               // MongoDB 4.2.4开始支持
      "v" : 2,
      "key" : { "item" : 1 },
      "name" : "item_1"
   }
}
{
   "name" : "_id_",
   "key" : { "_id" : 1 },
   "host" : "examplehost.local:27018",
   "accesses" : {
      "ops" : NumberLong(0),
      "since" : ISODate("2020-02-10T21:11:18.298Z")
   },
   "shard" : "shardA",      // 运行在分片集群，MongoDB 4.2.4开始支持 
   "spec" : {               // MongoDB 4.2.4开始支持
      "v" : 2,
      "key" : { "_id" : 1 },
      "name" : "_id_"
   }
}