$collStats
¶3.4版的新功能。
返回有关集合或视图的统计信息。
该$collStats
阶段具有以下原型形式:
该$collStats
阶段接受带有以下可选字段的自变量文档:
栏位名称 | 描述 |
---|---|
latencyStats |
将延迟统计信息添加到返回文档中。 |
latencyStats.histograms |
将延迟直方图信息添加到latencyStats if中的嵌入文档中true 。 |
storageStats |
将存储统计信息添加到退货文档中。
|
count |
将集合中的文档总数添加到返回文档中。 注意 该计数基于集合的元数据,该数据为分片群集提供了快速但有时不准确的计数。 查看计数字段 3.6版的新功能。 |
对于副本集中的集合或
群集中的非分片集合,$collStats
输出单个文档。对于分片
集合,
$collStats
每个分片输出一个文档。输出文档包括以下字段:
栏位名称 | 描述 |
---|---|
ns |
请求的集合或视图的名称空间。 |
shard |
输出文档对应的分片名称。 仅在 3.6版的新功能。 |
host |
产生输出文档的mongod进程的主机名和端口。 3.6版的新功能。 |
localTime |
MongoDB服务器上的当前时间,表示为自Unix纪元以来的UTC毫秒。 |
latencyStats |
与收集或视图的请求延迟相关的统计信息的收集。有关此文档的详细信息,请参见 latencyStats文档。 仅在指定选项时存在。 |
storageStats |
与集合的存储引擎相关的统计信息的集合。有关此文档的详细信息,请参见storageStats文档。 各种大小的数据均按指定的因子进行缩放(那些在字段名称中指定度量单位的大小除外)。 仅在 如果应用于视图,则返回错误。 |
count |
集合中的文档总数。此数据也可在中找到 注意 该计数基于集合的元数据,该数据为分片群集提供了快速但有时不准确的计数。 仅在指定选项时存在。如果应用于视图,则返回错误。 |
$collStats
必须是聚合管道的第一阶段,否则管道会返回错误。
latencyStats
文件¶该latencyStats
嵌入文档的输出,如果你指定只存在latencyStats
选项。
栏位名称 | 描述 |
---|---|
reads |
读取请求的延迟统计信息。 |
writes |
写入请求的延迟统计信息。 |
commands |
数据库命令的延迟统计信息。 |
这些字段中的每个字段都包含一个嵌入的文档,其中包含以下字段:
栏位名称 | 描述 | ||||||
---|---|---|---|---|---|---|---|
latency |
一个64位整数,以毫秒为单位给出总的组合延迟。 | ||||||
ops |
一个64位整数,给出自启动以来对集合执行的操作总数。 | ||||||
histogram |
一组嵌入式文档,每个文档代表一个等待时间范围。每个文档覆盖先前文档范围的两倍。对于2048微秒和大约1秒之间的较高值,直方图包括半步。 该字段仅在给定选项的情况下存在
。从输出中忽略具有零的空范围。 每个文档都包含以下字段:
例如,如果 这表明有:
|
例如,如果在集合上$collStats
使用该选项运行:latencyStats: {}
matrices
该查询返回的结果类似于以下内容:
storageStats
文件¶该storageStats
嵌入文档的输出,如果你指定只存在storageStats
选项。
本文档的内容取决于使用的存储引擎。请参阅输出以获取本文档的参考。
例如,如果使用WiredTiger Storage Engine
在集合上运行$collStats
该选项:storageStats: {}
matrices
该查询返回的结果类似于以下内容:
进行中的索引
从MongoDB 4.2开始,返回的storageStats
内容包含有关正在构建的索引的信息。有关详细信息,请参见:
在视图上执行$collStats
该storageStats
选项会
导致错误。
count
字段¶3.6版的新功能。
count
如果指定count
选项,则该字段仅存在于输出中
。
例如,如果在集合上$collStats
使用该选项运行:count: {}
matrices
该查询返回类似于以下内容的结果:
注意
该计数基于集合的元数据,该数据为分片群集提供了快速但有时不准确的计数。
集合中的文档总数也可作为
storageStats.count
时指定的。有关更多信息,请参阅storageStats文档。storageStats: {}