db.serverStatus()

項目一覧

db.serverStatus()

データベースプロセスの状態の概要を示すドキュメントを返します。

このコマンドは、データベースコマンド serverStatus にラッパーを提供します。

互換性

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

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

デフォルトでは、db.serverStatus() 出力から以下が除外されます:

デフォルトで除外されるフィールドを含めるには、最上位フィールドを指定し、コマンドで 1 に設定します。デフォルトで含まれるフィールドを除外するには、フィールドを指定して 0 に設定します。最上位フィールドまたは埋め込みフィールドのいずれかを指定できます。

たとえば、次の操作は、出力内の repl、metrics、および locks 情報を抑制します。

db.serverStatus( { repl: 0,  metrics: 0, locks: 0 } )

次の例では、出力にすべての repl 情報が含まれます。

db.serverStatus( { repl: 1 } )

db.serverStatus()によって報告された統計は、 mongodサーバーを再起動するとリセットされます。 db.serverStatus()コマンドは、サーバーイベントによって初期化されるまで、いくつかの統計情報を報告しません。

たとえば、 mongodサーバーを再起動すると、 db.serverStatus()はfindAndModifyの値を返しません。

db.serverStatus().metrics.commands.findAndModify
// No results returned

アップデートクエリを実行すると、 db.serverStatus()に対する後続の呼び出しに期待されるメトリクスが表示されます。

{
   "arrayFilters" : NumberLong(0),
   "failed" : NumberLong(0),
   "pipeline" : NumberLong(0),
   "total" : NumberLong(1)
}

カウンターの増加が始まる前に特定のオブジェクトが照会された場合、db.serverStatus() メソッドはエラーを返します。

ドキュメントの更新がまだない場合：

db.serverStatus().metrics.commands.update.pipeline

次の値を返します。

TypeError: db.serverStatus(...).metrics.commands.update is undefined :
@(shell):1:1

デフォルトでは、 mirroredReads情報は出力に含まれていません。 mirroredReads情報を返すには、包含を明示的に指定する必要があります。

db.serverStatus( { mirroredReads: 1 } )

この関数の出力の完全なドキュメントについては、「serverStatus 出力」を参照してください。

戻る

db.serverCmdLineOpts

db.setLogLevel