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

定義

db.setProfilingLevel(level, options)

バージョン5.0で変更。

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

注意

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

データベースプロファイラレベルが 1または2 の場合（具体的には、データベースプロファイラが有効になっている場合）、 slowms と sampleRate はプロファイラーとdiagnostic log の両方の動作に影響します。

データベースプロファイラレベルが 0（具体的には、データベースプロファイラが無効）の場合、 slowms と sampleRate は診断ログのみに影響します。

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

mongod インスタンスと mongos インスタンスの両方にフィルターを指定して、プロファイラーによってログに記録する操作を制御できます。プロファイラーに filter を指定すると、 slowms オプションおよび sampleRate オプションはプロファイリングおよび低速クエリログ行には使用されません。

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

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

互換性

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

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

重要

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

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

構文

db.setProfilingLevel()メソッドの形式は次のとおりです。

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

パラメーター

Parameter

タイプ

説明

レベル

integer

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

0

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

1

プロファイラーは、slowms しきい値を超える操作、または指定されたフィルターに一致する操作のデータを収集します。

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

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

2

プロファイラーは、すべての操作のデータを収集します。

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

プロファイリングはmongos では利用できないため、を使用してインスタンスでプロファイリングdb.setProfilingLevel() レベルを0 mongos以外の値に設定することはできません。

options

ドキュメントまたは整数

任意。整数またはオプションドキュメントを受け入れます。ドキュメントではなく整数値がoptions 引数として渡される場合、その値は slowms に割り当てられます。次のオプションを使用できます。

slowms	デフォルト:100 型: 整数低速操作時間のしきい値（ミリ秒単位）。操作が実行される時間がこのしきい値より長いと、低速とみなされます。低速操作は、MongoDB でその操作にかかった時間である `workingMillis` に基づいてログに記録されます。つまり、ロック待ちやフロー制御などの要因は、操作が低速操作のしきい値を超えるかどうかに影響しません。 `logLevel`が`0`に設定されている場合、MongoDB は `slowOpSampleRate` で決定されたレートで低速操作を診断ログに記録します `logLevel`設定を引き上げると、レイテンシに関係なく、すべての操作が診断ログに表示されます。ただし、セカンダリによる低速の oplog エントリメッセージのログ記録は除きます。セカンダリでは、低速の oplog`logLevel` エントリのみがログに記録されます。を引き上げても、すべての oplog エントリがログに記録されるわけではありません。 `mongod` インスタンスの場合、この設定は診断ログと（有効になっている場合）プロファイラーの両方に影響します。 `mongos` インスタンスの場合、プロファイリングは `mongos` では利用できないため、設定は診断ログにのみ影響し、プロファイラーには影響しません。この引数は、構成ファイルオプション `slowOpThresholdMs` と同じ設定に影響します。
slowingprogms	バージョン8.3の新機能。デフォルト:5000 型: 整数進行中のクエリの低速操作時間のしきい値（ミリ秒単位）。MongoDB は、実行時間がこのしきい値より長い時間がかかる操作を、低速進行中のクエリとして記録します。MongoDB は、クエリ操作が時間しきい値を超えた時点で、クエリを進行中の低速クエリとしてログに記録します。この引数は、構成ファイルオプション `slowOpInProgressThresholdMs` と同じ設定に影響します。
sampleRate	デフォルト: 1.0 型: double プロファイリングまたはログに記録する必要がある低速操作の割合。`sampleRate` は、両端を含む 0 から 1 までの値を受け入れます。 `mongod` インスタンスの場合、この設定は診断ログと（有効になっている場合）プロファイラーの両方に影響します。 `mongos` インスタンスの場合、プロファイリングは `mongos` では利用できないため、設定は診断ログにのみ影響し、プロファイラーには影響しません。この引数は、構成オプション `slowOpSampleRate` と同じ設定に影響します。
フィルター	型: オブジェクトどの操作をプロファイリングしてログ記録するかを制御するフィルター式。フィルター式のフィールドは、プロファイラー出力内の任意のフィールドにできます。 `mongod` インスタンスの場合、この設定は診断ログと（有効になっている場合）プロファイラーの両方に影響します。 `mongos` インスタンスの場合、プロファイリングは `mongos` では利用できないため、設定は診断ログにのみ影響し、プロファイラーには影響しません。 MongoDB 8.0 以降では、フィルターパラメータとして `workingMillis` を指定して、MongoDB がその操作に費やした時間に基づいて操作をログに記録できます。ログ記録操作を制御するために使用されるフィルターの例については、「プロファイルされた操作を決定するためにフィルターを設定する」を参照してください。プロファイリングフィルターが設定されている場合、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インスタンスに設定します。

プロファイリングレベルを1 に設定し、
低速操作のしきい値 slowms を20 ミリ秒に設定し、
sampleRate を0.42 に設定します。

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

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

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

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

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

プロファイリングレベルを0 に設定し、
低速操作のしきい値 slowms を20 ミリ秒に設定し、
sampleRate を0.42 に設定します。

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

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

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

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

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

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

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

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

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

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

filterデータベースプロファイラを有効にせずにを設定できます。次の例では、プロファイリングレベルが 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