db.setProfilingLevel()（mongoshメソッド）

定義

db.setProfilingLevel(level, options)

バージョン5.0で変更。

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

注意

db.setProfilingLevel() でプロファイリングレベルに加えられた変更は保持されません。サーバーを再起動すると、0（デフォルト）、または operationProfiling.mode 設定もしくは --profile コマンドラインオプションで設定された値に戻ります。

If the database profiler level is 1 or 2 (specifically, the database profiler is enabled), the slowms and sampleRate affect the behavior of both the profiler and the diagnostic log.

If the database profiler level is 0 (specifically, database profiler is disabled), the slowms and sampleRate, affect only the diagnostic log.

mongosインスタンスでは、このメソッドは slowms の設定、 sampleRate の設定、および filter 構成設定を行い、操作を診断ログに書き込む方法を構成します。mongos にはプロファイラーが書き込みできるコレクションがないため、mongos インスタンスでデータベースプロファイラーを有効にすることはできません。mongosインスタンスの profile レベルは 0 である必要があります。

You can specify a filter on both mongod and mongos instances to control which operations are logged by the profiler. When you specify a filter for the profiler, the slowms, and sampleRate options are not used for profiling and slow-query log lines.

db.setProfilingLevel() provides a wrapper around the profile command.

MongoDB5.0 以降では、コマンドまたはラッパーメソッドを使用してデータベースプロファイラlevel 、slowms 、sampleRate 、またはに加えられた変更は、filter profiledb.setProfilingLevel()log fileに記録されます。

互換性

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

MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、サポートされていないコマンドを参照してください。

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

構文

The db.setProfilingLevel() method has the following form:

db.setProfilingLevel(<level>, <options>)

パラメーター

Parameter

タイプ

説明

レベル

integer

データベースプロファイラーレベルを設定します。次のプロファイラーレベルを使用できます。

0

プロファイラーはオフになっており、データは収集されません。これはデフォルトのプロファイラーレベルです。

1

プロファイラーは、slowms の値よりも長い時間がかかる操作やフィルターに一致する操作のデータを収集します。

フィルターが設定されている場合、

slowmsおよびsampleRateオプションはプロファイリングには使用されません。
プロファイラーは、フィルターに一致する操作のみをキャプチャします。

2

プロファイラーは、すべての操作のデータを収集します。レベル 2 に設定すると、プロファイラーはslowms と filter のユーザーが指定した値を無視します。

Because profiling is not available on mongos, db.setProfilingLevel() cannot be used to set the profiling level to a value other than 0 on a mongos instance.

options

ドキュメントまたは整数

Optional. Accepts an integer or an options document. If an integer value is passed as the options argument instead of a document, the value is assigned to slowms. The following options are available:

slowms	デフォルト:100 型: 整数低速操作時間のしきい値（ミリ秒単位）。操作が実行される時間がこのしきい値より長いと、低速とみなされます。 `logLevel`が`0`に設定されている場合、MongoDB は `slowOpSampleRate` で決定されたレートで低速操作を診断ログに記録します `logLevel`設定を引き上げると、レイテンシに関係なく、すべての操作が診断ログに表示されます。ただし、セカンダリによる低速の oplog エントリメッセージのログ記録は除きます。セカンダリでは、低速の oplog`logLevel` エントリのみがログに記録されます。を引き上げても、すべての oplog エントリがログに記録されるわけではありません。 `mongod` インスタンスの場合、この設定は診断ログと（有効になっている場合）プロファイラーの両方に影響します。 `mongos` インスタンスの場合、プロファイリングは `mongos` では利用できないため、設定は診断ログにのみ影響し、プロファイラーには影響しません。この引数は、構成ファイルオプション `slowOpThresholdMs` と同じ設定に影響します。
sampleRate	デフォルト: 1.0 型: double プロファイリングまたはログに記録する必要がある低速操作の割合。`sampleRate` は、両端を含む 0 から 1 までの値を受け入れます。 `mongod` インスタンスの場合、この設定は診断ログと（有効になっている場合）プロファイラーの両方に影響します。 `mongos` インスタンスの場合、プロファイリングは `mongos` では利用できないため、設定は診断ログにのみ影響し、プロファイラーには影響しません。この引数は、構成オプション `slowOpSampleRate` と同じ設定に影響します。
フィルター	型: オブジェクトどの操作をプロファイリングしてログ記録するかを制御するフィルター式。フィルター式のフィールドは、プロファイラー出力内の任意のフィールドにできます。 `mongod` インスタンスの場合、この設定は診断ログと（有効になっている場合）プロファイラーの両方に影響します。 `mongos` インスタンスの場合、プロファイリングは `mongos` では利用できないため、設定は診断ログにのみ影響し、プロファイラーには影響しません。 For an example of a filter used to control logged operations, see Set a Filter to Determine Profiled Operations. プロファイリングフィルターが設定されている場合、slowms オプションおよび sampleRate オプションは診断ログまたはプロファイラーに影響しません。

戻り値

このメソッドは、前の設定値を含むドキュメントを返します。

{
   "was" : 2,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gt" : 20000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1
}

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gte" : 2000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991238, 1),
      "signature" : {
         "hash" : BinData(0,"hg6GnlrVhV9MAhwWdeHmHQ4T4qU="),
         "keyId" : Long("6755945537557495811")
      }
   },
   "operationTime" : Timestamp(1572991238, 1)
}

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "filter" : {
      "$and" : [
         {
            "op" : {
               "$eq" : "query"
            }
         },
         {
            "millis" : {
               "$gte" : 2000
            }
         }
      ]
   },
   "note" : "When a filter expression is set, slowms and sampleRate are not used for profiling and slow-query log lines.",
   "ok" : 1,
   "operationTime" : Timestamp(1572991499, 2),
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991499, 2),
      "signature" : {
         "hash" : BinData(0,"nhCquIxUw7thlrBudXe3PnsnvP0="),
         "keyId" : Long("6755946491040235540")
      }
   }
}

以下の条件に一致するもの。

was が、前のレベル設定です。
slowms が、前の slowms 設定です。
sampleRate が、前の sampleRate 設定です。
filter は、前のフィルター設定です。
note は、 filterの動作を説明する文字列です。このフィールドは、 filterも存在する場合にのみ出力に表示されます。

注意

filter フィールドと note フィールドは、前のレベル設定に存在していた場合にのみ出力に表示されます。

現在のプロファイリングレベルを表示するには、db.getProfilingStatus() を参照してください。

動作

警告

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

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

例

プロファイラーの有効化および低速操作のしきい値とサンプルレートの設定

次の例では、以下の値を mongodインスタンスに設定します。

the profiling level to 1,
the slow operation threshold slowms to 20 milliseconds, and
the sampleRate to 0.42.

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

この操作は、前の設定値を含むドキュメントを返します。

現在のプロファイリングレベルを表示するには、db.getProfilingStatus() を参照してください。

プロファイラーの無効化および低速操作のしきい値とサンプルレートの設定

次の例では、以下の値を mongod インスタンスまたは mongos インスタンス用に設定します。

the profiling level to 0,
the slow operation threshold slowms to 20 milliseconds, and
the sampleRate to 0.42.

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

この操作は、前の設定値を含むドキュメントを返します。

現在のプロファイリングレベルを表示するには、db.getProfilingStatus() を参照してください。

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

次の例では、以下の値を mongodインスタンスに設定します。

the profiling level to 1,
の{ op: "query", millis: { $gt: 2000 } } フィルターquery 2。これにより、プロファイラーは、秒以上かかった操作のみをレコード。

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

この操作は、前の設定値を含むドキュメントを返します。

現在のプロファイリングレベルを表示するには、db.getProfilingStatus() を参照してください。

プロファイラーを有効にせずにフィルターを設定する

You can set a filter without enabling the database profiler. The following example uses a filter with a profiling level of 0.

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

プロファイリングレベルが 0 のため、プロファイラーは無効になり、プロファイラーコレクションに一致する操作を記録しません。フィルターは、引き続き診断ログに適用されます。

この操作は、前の設定値を含むドキュメントを返します。

現在のプロファイリングレベルを表示するには、db.getProfilingStatus() を参照してください。

フィルターの設定解除

プロファイルフィルターをクリアするには、filter: "unset" オプションを指定して db.setProfilingLevel() を実行します。

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

この操作は、前の設定値を含むドキュメントを返します。

現在のプロファイリングレベルを表示するには、db.getProfilingStatus() を参照してください。

戻る

db.setLogLevel

db.shutdownServer