db.コレクション.latencyStats()（mongoshメソッド）

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

データベースコマンドについては、 collStatsコマンドによって返されるlatencyStatsフィールドを参照してください。

MongoDB API ドライバーについては、各言語の MongoDB ドライバードキュメントを参照してください。

定義

db.collection.latencyStats(options)

db.collection.latencyStats()は、指定されたコレクションのレイテンシ統計を返します。これは$collStatsを囲むラッパーです。

このメソッドの形式は次のとおりです。

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

histograms引数は任意のブール値です。 histograms: trueの場合、 latencyStats()は返されるドキュメントにレイテンシヒストグラムを追加します。

Tip

$collStats

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

出力

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

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

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

フィールド名

説明

latency

合計レイテンシをマイクロ秒単位で示す 64 ビットの整数。

ops

起動以降にコレクションで実行された操作の合計数を示す 64 ビットの整数。

histogram

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

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

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

フィールド名	説明
`micros`	現在のレイテンシ範囲の包括的下限をマイクロ秒単位で提供する64ビット整数。ドキュメントの範囲は、前のドキュメントの`micros`値（排他的）とこのドキュメントの`micros`値（包括的）の間です。
`count`	レイテンシが`micros`以下の操作の数を表す 64 ビットの整数。

たとえば、 collStatsが次のヒストグラムを返す場合、次のようになります。

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

This indicates that there were [1]:

マイクロ秒以下を使用する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" : Long(16),          "count" : Long(6)        },        {          "micros" : Long(512),          "count" : Long(1)        }      ],      "latency" : Long(747),      "ops" : Long(7)    },    "writes" : {      "histogram" : [        {          "micros" : Long(64),          "count" : Long(1)        },        {          "micros" : Long(24576),          "count" : Long(1)        }      ],      "latency" : Long(26845),      "ops" : Long(2)    },    "commands" : {      "histogram" : [ ],      "latency" : Long(0),      "ops" : Long(0)    }  }}

戻る

db.collection.isCapped

db.collection.mapReduce