プロファイル

定義

profile

バージョン 5.0 での変更。

mongodインスタンスの場合、 コマンドはデータベースプロファイラを有効化、無効化、または構成します。 プロファイラーは、実行中のmongodインスタンスでの書き込み操作、カーソル、データベースコマンドのパフォーマンスに関するデータをキャプチャして記録します。 プロファイラーが無効の場合、 コマンドは、低速操作を診断ログに記録する方法を構成します。

mongodでは、データベースプロファイラー レベルが2の場合、プロファイラーとdiagnostic logで完全なログ記録が有効になります。

データベースプロファイラー レベル1では、次の設定によってプロファイラーとdiagnostic logの両方が変更されます。

• slowms

• sampleRate

• フィルター

データベースプロファイラー レベルが0の場合、データベースプロファイラーは無効になります。 レベル0では、次の設定によって診断ログのみが変更されます。

• slowms

• sampleRate

• フィルター

mongosインスタンスの場合、このコマンドは操作を診断ログに書き込む方法のみを構成します。 にはプロファイラーが書き込みできるコレクションがないため、 インスタンスで データベースプロファイラ mongosmongosを有効にすることはできません。

MongoDB 700}5.0 以降では、 コマンドまたはlevel slowmssampleRatefilterラッパーdb.setProfilingLevel() メソッドを使用して データベースプロファイラーprofilelog file 、 、 、または に加えられた変更は、 に記録されます .

mongosでは、 profileレベルを次のように設定できます。

• 0 診断ログのslowms 、 sampleRate 、 filterを設定する。

• -1 現在の設定を読み取るには

プロファイラーはデフォルトでオフになっています。

警告

プロファイリングにより、パフォーマンスが低下し、暗号化されていないクエリ データがシステム ログに公開されることがあります。プロファイラーを本番環境に設定して有効にする前に、パフォーマンスとセキュリティへの影響を慎重に検討してください。

パフォーマンス低下の可能性の詳細については、「プロファイラーのオーバーヘッド」を参照してください。

互換性

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

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

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

このコマンドの構文は、次のとおりです。

db.runCommand(
  {
    profile: <level>,
    slowms: <threshold>,
    sampleRate: <rate>,
    filter: <filter expression>
  }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

{ <field1>: <expression1>, ... }

db.getProfilingStatus()とdb.setProfilingLevel() shell メソッドはprofileコマンドのラッパーを提供します。

動作

profileコマンドは、プロファイラーを有効または無効にする間に影響を受けるデータベースの書込みロック（write lock）を取得します。 これは通常、短い操作です。 ロックは、 profileコマンドが完了するまで他の操作をブロックします。

mongosを介してシャーディングされたクラスターに接続すると、任意のデータベースに対してprofileコマンドを実行できます。

例

db.runCommand(
   {
     profile: 1,
     filter:
        {
           $or:
           [
              { millis: { $gte: 100 } },
              { user: "testuser@admin" }
           ]
        }
   }
)

db.runCommand(
   {
      profile: 1,
      filter: "unset"
   }
)