MongoDB聚合：$indexStats

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

返回有关集合中每个索引使用情况的统计信息。如果运行时有访问控制，请至少以 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_"
   }
}