db.collection.latencyStats（）

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 收集方法 > db.collection.latencyStats（）

在本页面

定义
输出量
例子

定义¶

db.collection.latencyStats（选项）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

db.collection.latencyStats()返回给定集合的延迟统计信息。它是一个包装 $collStats。

此方法的形式为：

复制

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

该histograms参数是可选的布尔值。如果这样，则将延迟直方图添加到返回文档中。histograms: truelatencyStats()

也可以看看

$collStats

输出¶

latencyStats()返回包含一个field的文档latencyStats，该文档包含以下字段：

栏位名称	描述
`reads`	读取请求的延迟统计信息。
`writes`	写入请求的延迟统计信息。
`commands`	数据库命令的延迟统计信息。

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

栏位名称描述

latency 一个64位整数，以毫秒为单位给出总的组合延迟。

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

histogram

一组嵌入式文档，每个文档代表一个等待时间范围。每个文档覆盖先前文档范围的两倍。对于2048微秒和大约1秒之间的较高值，直方图包括半步。

该字段仅在给定选项的情况下存在。从输出中忽略具有零的空范围。latencyStats: { histograms: true }count

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

栏位名称	描述
`micros`	一个64位整数，以毫秒为单位给出当前等待时间范围的上限时间。该文档的范围介于上一个文档的 `micros`值（不`micros`包括此值）和该文档的值（包括不包括在内）之间。
`count`	一个64位整数，给出延迟小于或等于的操作数`micros`。

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

复制

histogram: [
  { micros: NumberLong(1), 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次操作，
1次操作，其范围是（1、2]微秒，
1次操作，范围为（3072，4096]微秒，
（12288，16384]范围内的1000次操作
（32768，49152]范围内的100次操作。

例子¶

您可以latencyStats()在mongo shell中运行，如下所示：

复制

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)
    }
  }
}