Database Profiler

グローバルおよびデータベースごとのプロファイリング設定

slowms と sampleRate は、プロセス内のすべてのデータベースに影響するグローバル設定です。

プロファイリング レベルとフィルターは、profileまたはdb.setProfilingLevel()で設定するとデータベースレベルの設定になります。コマンドライン オプションまたは構成ファイルオプションとして設定すると、 プロセス全体に影響します。

低速操作のしきい値を指定

デフォルトでは、低速操作のしきい値は 100 ミリ秒です。

低速操作は、MongoDB でその操作にかかった時間である workingMillis に基づいてログに記録されます。つまり、ロック待ちやフロー制御などの要因は、操作が低速操作のしきい値を超えるかどうかに影響しません。

低速操作のしきい値を変更するには、次のいずれかを使用します。

• profile コマンドまたは db.setProfilingLevel() シェルヘルパー メソッドを使用して slowms の値を設定します。

• スタートアップ時にコマンドラインから --slowms の値を設定します。

• 構成ファイルで slowOpThresholdMs の値を設定します。

次の例では、現在接続されているデータベースのプロファイリング レベルを1 に設定し、mongod インスタンスにおける低速操作のしきい値を 20 ミリ秒に設定します。

db.setProfilingLevel( 1, { slowms: 20 } )

プロファイリング レベルが 1 の場合、プロファイラーは slowms のしきい値よりも遅い操作を記録します。

mongos の場合、db.setProfilingLevel() を使用して slowms と sampleRate を構成します。これらの設定はプロファイラーではなく、mongos の診断ログにのみ影響します。プロファイリングは mongos では利用できません。[1]

次の例では、低速操作のログを 20 に記録するため、mongos インスタンスの低速操作のしきい値を設定します。

db.setProfilingLevel( 0, { slowms: 20 } )

プロファイラー エントリと読み取り操作および書込み (write ) 操作の 診断ログ メッセージ（mongod/mongos ログ メッセージなど）には次のものが含まれます。

• planCacheShapeHash プランキャッシュクエリシェイプが同じスロークエリを特定するのに役立ちます。

  MongoDB 8.0 以降では、既存の queryHashフィールドはplanCacheShapeHash という名前の新しいフィールドに重複します。 以前のバージョンのMongoDBを使用している場合は、queryHashフィールドのみが表示されます。 今後のMongoDBバージョンでは、非推奨の queryHashフィールドが排除されます。代わりに planCacheShapeHashフィールドを使用する必要があります。

• planCacheKey 低速クエリのクエリプラン キャッシュに関する詳細なインサイトを提供します。

replica setのセカンダリ メンバーは、適用に低速操作しきい値よりも長い時間がかかるoplogをログに記録するようになりました。 これらの遅い oplog メッセージ:

• diagnostic logのセカンダリに対してログに記録されます。

• ログは、テキストapplied op: <oplog entry> took <num>msを含むREPLコンポーネントの下にあります。

• ログレベルに依存しない（システムレベルでもコンポーネントレベルでも）

• プロファイル レベルに依存しないでください。

• slowOpSampleRateの影響を受けます。

プロファイラーは遅い oplog エントリをキャプチャしません。

低速操作のランダム サンプルのプロファイリング

低速操作のランダムにサンプリングされたサブセットのみをプロファイリングするには、次のいずれかの方法で sampleRateを設定します。 []2

• profile コマンドまたは db.setProfilingLevel() シェルヘルパー メソッドを使用して sampleRate の値を設定します。

• スタートアップ時にコマンドラインから mongod の場合は --slowOpSampleRate の値、mongos の場合は --slowOpSampleRate の値を設定します。

• 構成ファイルで slowOpSampleRate の値を設定します。

デフォルトでは、sampleRate は 1.0 に設定されています。つまり、すべての低速操作がプロファイリングされます。sampleRate が 0 と 1 の間に設定されている場合、プロファイリング レベルが 1 のデータベースは、sampleRate に基づいてランダムにサンプリングされた割合で低速操作をプロファイリングします。

次の例では、プロファイリング レベルを 1 に設定し、低速操作の 42% をサンプルようにプロファイルを設定します。

db.setProfilingLevel( 1, { sampleRate: 0.42 } )

変更されたサンプル レート値はシステム ログにも適用されます。

mongos の場合、slowms と sampleRate は 診断ログのみに影響し、プロファイラー には影響しません。[]1 mongosロギングのサンプリング レートを設定するには、次の手順に従います。

db.setProfilingLevel( 0, { sampleRate: 0.42 } )

プロファイルされた操作を決定するためにフィルターを設定する

どの操作をプロファイリングしてログに記録するかを制御するには、次のいずれかの方法でフィルターを設定します。

• profile コマンドまたは db.setProfilingLevel()。

• filter 構成ファイル内の。

mongod の場合、filter は有効になっている場合、診断ログとプロファイラー の両方に影響します。mongos の場合、filter は診断ログにのみ影響します。

次の例では、2 秒以上かかる query 操作のみをログに記録するフィルターで、プロファイリング レベル 1 を設定します。

db.setProfilingLevel( 1, { filter: { op: "query", millis: { $gt: 2000 } } } )

プロファイリング レベルの確認

プロファイリング レベル を表示するには、mongosh で を実行します。

db.getProfilingStatus()

shellは、次のようなドキュメントを返します。

{ "was" : 0, "slowms" : 100, "sampleRate" : 1.0, "ok" : 1 }

返されたドキュメントには、次の内容が含まれます。

• was: 現在のプロファイリング レベル。

• slowms:操作時間のしきい値（ミリ秒単位）。

• sampleRate: プロファイリング中の 低速 操作の割合。

プロファイリングの無効化

プロファイリングを無効にするには、mongosh: で を実行します。

db.setProfilingLevel(0)

mongod インスタンス全体のプロファイリングを有効にする

開発環境とテスト環境では、 mongod インスタンス全体に対してプロファイリングを有効にできます。プロファイリング レベルは、そのインスタンス上のすべてのデータベースに適用されます。

スタートアップ時に次のオプションを mongod に渡します。

mongod --profile 1 --slowms 15 --slowOpSampleRate 0.5

または、operationProfiling を構成ファイルで指定します。

これにより、プロファイリング レベルが 1 に設定され、15 ミリ秒より長く続く操作が低速と定義され、 低速 操作の 50% がプロファイリングされます。[2]

slowms と slowOpSampleRate も、logLevel が 0 の場合に診断ログに記録される操作に影響します。どちらの設定も mongos の診断ログも構成します。[2]

データベース プロファイリングとシャーディング

インスタンスではプロファイリングを有効に できませんmongos 。シャーディングされたクラスターでプロファイリングを有効にするには、クラスター内の各 mongod インスタンスで有効にします。

低速操作の診断ログを構成するには、--slowms と slowOpSampleRate を mongos で設定できます。

プロファイラーのデータ クエリの例

このセクションでは、system.profile コレクションのクエリの例を示します。クエリ出力の詳細については、「データベースプロファイラー出力」を参照してください。

最新の 10ログエントリを返します。

db.system.profile.find().limit(10).sort( { ts : -1 } ).pretty()

コマンド操作を除くすべての操作を返します（$cmd）。

db.system.profile.find( { op: { $ne : 'command' } } ).pretty()

特定のコレクションの操作を返します（この例ではmydb.test を使用します）。

db.system.profile.find( { ns : 'mydb.test' } ).pretty()

5 ミリ秒を超える時間がかかる操作を返すには以下を行います。

db.system.profile.find( { millis : { $gt : 5 } } ).pretty()

特定の時間範囲内の操作を返します。

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2012-12-09T03:00:00Z"),
      $lt: new ISODate("2012-12-09T03:40:00Z")
   }
} ).pretty()

時間範囲内の操作を返し、userフィールドを除外し、期間で並べ替えます。

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2011-07-12T03:00:00Z"),
      $lt: new ISODate("2011-07-12T03:40:00Z")
   }
}, { user: 0 } ).sort( { millis: -1 } )

最新の 5 つのイベントを表示する

プロファイリングが有効になっているデータベースでは、 mongoshのshow profileヘルパーには、実行に少なくとも1ミリ秒かかった5の最新の操作が表示されます。 mongosh show profileを実行します。

show profile

system.profile コレクション

system.profileコレクションは、デフォルトサイズが 1 メガバイトの上限付きコレクションで、通常数千のプロファイル ドキュメントを保存できます。サイズを変更する必要がある場合、以下の手順に従ってください。

プライマリの system.profile コレクションのサイズ変更

プライマリのsystem.profileコレクションのサイズを変更するには:

1. プロファイリングを無効にします。

2. system.profile コレクションを削除します。

3. 新しいsystem.profile コレクションを作成します。

4. プロファイリングを再度有効にします。

system.profile4000000例、:4mongosh に バイト（ MB）の新しい コレクションを作成するには、次のようにします。

db.setProfilingLevel(0)
db.system.profile.drop()
db.createCollection( "system.profile", { capped: true, size:4000000 } )
db.setProfilingLevel(1)

セカンダリの system.profile コレクションのサイズ変更

セカンダリ上のsystem.profileコレクションのサイズを変更するには、セカンダリを停止してスタンドアロンとして実行してから、上記の手順を行います。次に、レプリカセットメンバーとして再起動します。詳細は、自己管理型レプリカセットのノードのメンテナンスの実行 を参照してください。