db.collection.latencyStats()

在此页面上

定义

兼容性
输出
示例

定义

db.collection.latencyStats(options)

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序（例如 Node.js）的相关文档。

对于数据库命令，请参阅 collStats命令返回的latencyStats字段。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

db.collection.latencyStats() 返回给定集合的延迟统计数据。它是 $collStats 的封装器。

此方法的形式为：

db.collection.latencyStats( { histograms: <boolean> } )

histograms 参数是可选的布尔值。如果 histograms: true，那么 latencyStats() 将延迟直方图添加到返回文档中。

提示

另请参阅：

$collStats

兼容性

此方法可用于以下环境中托管的部署：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

输出

latencyStats()返回包含字段latencyStats的文档，其中包含以下字段：

字段名称	说明
`reads`	读取请求的延迟统计信息。
`writes`	写入请求的延迟统计数据。
`commands`	数据库命令的延迟统计信息。
`transactions`	数据库事务的延迟统计信息。

其中每个字段都包含一个包含以下字段的嵌入文档：

字段名称

说明

latency

一个 64 位整数，以微秒为单位表示总组合延迟。

ops

一个 64 位整数，表示自启动以来对集合执行的操作总数。

histogram

嵌入式文档大量，每个文档代表一个延迟范围。每个文档的覆盖范围是前一个文档范围的两倍。对于介于2048微秒到大约1秒之间的较低值，直方图包括半步。

此字段仅在给定 latencyStats: { histograms: true } 选项时存在。输出中将省略带有零 count 的空范围。

每个文档都包含以下字段：

字段名称	说明
`micros`	一个64位整数，给出当前延迟范围的包含时间下限（以微秒为单位）。文档的范围介于上一文档的 `micros` 值（不含）和本文档的 `micros` 值（含）之间。
`count`	一个 64 位整数，表示延迟小于或等于 `micros` 的操作次数。

例如，如果 collStats 返回以下直方图：

histogram: [
  { micros: NumberLong(0), count: NumberLong(10) },
  { micros: NumberLong(2), count: NumberLong(1) },
  { micros: NumberLong(4096), count: NumberLong(1) },
  { micros: NumberLong(16384), count: NumberLong(1000) },
  { micros: NumberLong(49152), count: NumberLong(100) }
]

这表明有 [1]：

10操作用时2微秒或更短
1操作，范围[ 2 , 4 ) 微秒
1操作，范围[ 4096 , 6144 ) 微秒
在 [ 16384 , 24576 ) 微秒范围执行1000次操作
在 [ 49152 , 65536 ) 微秒范围执行100次操作

[1]	此页上的 `(` 符号表示表示该值不包含在内。本页中的 `]` 符号表示该值包含在内。

示例

您可以按如下方式在 mongosh 中运行 latencyStats()：

db.data.latencyStats( { histograms: true } ).pretty()

latencyStats() 返回如下文档：

{
  "ns" : "test.data",
  "localTime" : ISODate("2016-11-01T21:56:28.962Z"),
  "latencyStats" : {
    "reads" : {
      "histogram" : [
        {
          "micros" : NumberLong(16),
          "count" : NumberLong(6)
        },
        {
          "micros" : NumberLong(512),
          "count" : NumberLong(1)
        }
      ],
      "latency" : NumberLong(747),
      "ops" : NumberLong(7)
    },
    "writes" : {
      "histogram" : [
        {
          "micros" : NumberLong(64),
          "count" : NumberLong(1)
        },
        {
          "micros" : NumberLong(24576),
          "count" : NumberLong(1)
        }
      ],
      "latency" : NumberLong(26845),
      "ops" : NumberLong(2)
    },
    "commands" : {
      "histogram" : [ ],
      "latency" : NumberLong(0),
      "ops" : NumberLong(0)
    }
  }
}

后退

db.collection.isCapped

来年

db.collection.mapReduce