Docs Menu
Docs Home
/
MongoDB マニュアル
/
参照
/
mongosh メソッド
/
コレクション

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()は返されるドキュメントにレイテンシ ヒストグラムを追加します。

Tip

以下も参照してください。

$collStats

出力

latencyStats()は、次のフィールドを含むフィールドlatencyStatsを含むドキュメントを返します。

フィールド名
説明
reads
読み取りリクエストのレイテンシ統計
writes
書込み (write) リクエストのレイテンシ統計
commands
データベースコマンドのレイテンシ統計

これらの各フィールドには、次のフィールドを含む埋め込みドキュメントが含まれています。

フィールド名
説明
latency
合計レイテンシをマイクロ秒単位で示す 64 ビットの整数。
ops
起動以降にコレクションで実行された操作の合計数を示す 64 ビットの整数。
histogram

それぞれがレイテンシ範囲を表す埋め込みドキュメントの配列。 各ドキュメントは、前のドキュメントの範囲の 2 倍をカバーします。 2048マイクロ秒から約1秒の間の低い値の場合、ヒストグラムには半ステップが含まれます。

このフィールドは、 latencyStats: { histograms: true }オプションでのみ存在します。 ゼロのcountがある空の範囲は出力から省略されます。

各ドキュメントには、次のフィールドが含まれます。

フィールド名
説明
micros

現在のレイテンシ範囲の包括的下限をマイクロ秒単位で提供する64ビット整数。

ドキュメントの範囲は、前のドキュメントのmicros値（排他的）とこのドキュメントのmicros値（包括的）の間です。

count
レイテンシがmicros以下の操作の数を表す 64 ビットの整数。

たとえば、 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) }
]

これは、次のことがあったことを示しています。

  • マイクロ秒以下を使用する10 操作2

  • 範囲 [ 2 、 4 ）マイクロ秒の1操作

  • 範囲 [ 4096 、 6144 ）マイクロ秒の1操作

  • 範囲 [ 16384 、 24576 ）マイクロ秒の1000操作

  • 範囲 [ 49152 、 65536 ）マイクロ秒の100操作

[1]
  • このページの(記号表記は、値が排他的であることを意味します。
  • このページの]記号表記は、値が包括的であることを意味します。

例

latencyStats()次のように、mongosh で を実行できます。

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

項目一覧