db.collection.latencyStats()

在本页面

• 定义

• 输出

• 例子

定义

• db.collection. latencyStats(选项)

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

此方法具有以下形式：

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

histograms参数是可选的 boolean。如果histograms: true则latencyStats()将延迟直方图添加到 return 文档。

也可以看看

$collStats

输出

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

字段	描述
reads	读取请求的延迟统计信息。
writes	写请求的延迟统计信息。
commands	数据库命令的延迟统计信息。

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

字段	描述
latency	一个64位整数，以毫秒为单位给出总的组合延迟。
ops	一个64位整数，给出自启动以来对集合执行的操作总数。
histogram	嵌入式文档的 array，每个都代表一个延迟范围。每个文档涵盖以前文档范围的两倍。对于介于 2048 微秒和大约 1 秒之间的上限值，直方图包括 half-steps。 此字段仅在latencyStats: { histograms: true }选项的情况下存在。输出中省略了具有零count的空范围。 每个文档都包含以下字段： 字段 :描述 micros :一个64位整数，以毫秒为单位给出当前等待时间范围的上限时间。该文档的范围介于上一个文档的 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) } ] 这表示： 10 次操作占用 1 微秒或更少， 1 操作范围(1,2)微秒， 1 操作范围内的范围(3072,4096)微秒， 1000 次操作(12288,16384)和范围内的 100 次操作(32768,49152)。

例子

您可以在mongo shell 中运行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)
        }
    }
}

译者：李冠飞

校对：