db.setProfilingLevel()

Syntax语法

The db.setProfilingLevel() method has the following form:db.setProfilingLevel()方法具有以下形式：

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

Parameters参数

Returns返回值

The method returns a document that contains the previous values of the settings.该方法返回包含设置的先前值的文档。

{
   "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" : NumberLong("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" : NumberLong("6755946491040235540")
      }
   }
}

Where:

• was is the previous level setting.是先前的level设置。
• slowms is the previous slowms setting.是先前的slowms设置。
• sampleRate is the previous sampleRate setting.是先前的sampleRate设置。
• filter is the previous filter setting. (New in MongoDB 4.4.2)是先前的filter设置。（MongoDB 4.4.2新增）
• note is a string explaining the behavior of filter. 是解释filter行为的字符串。This field only appears in the output when filter is also present. (New in MongoDB 4.4.2)仅当filter也存在时，此字段才会出现在输出中。（MongoDB 4.4.2新增）

To view the current profiling level, see db.getProfilingStatus().要查看当前的分析级别，请参阅db.getProfilingStatus()。

Enable Profiler and Set Slow Operation Threshold and Sample Rate启用探查器并设置慢速操作阈值和采样率

The following example sets for a mongod instance:以下示例为mongod实例设置：

• the profiling level to 1,将剖析级别设置为1，
• the slow operation threshold slowms to 20 milliseconds, and慢操作阈值slowms至20毫秒
• the sampleRate to 0.42.将sampleRate设置为0.42。

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

The method returns a document with the previous values for the settings.该方法返回一个文档，其中包含设置的先前值。

To view the current profiling level, see db.getProfilingStatus().要查看当前的分析级别，请参阅db.getProfilingStatus()。

Disable Profiler and Set Slow Operation Threshold and Sample Rate禁用探查器并设置慢速操作阈值和采样率

The following example sets for a mongod or mongos instance:以下示例为mongod或mongos实例设置：

• the profiling level to 0,将剖析级别设置为0，
• the slow operation threshold slowms to 20 milliseconds, and慢操作阈值slowms至20毫秒
• the sampleRate to 0.42.将sampleRate设置为0.42。

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

The method returns a document with the previous values for the settings.该方法返回一个文档，其中包含设置的先前值。

To view the current profiling level, see db.getProfilingStatus().要查看当前的分析级别，请参阅db.getProfilingStatus()。

Set a Filter to Determine Profiled Operations设置筛选器以确定分析的操作

The following example sets for a mongod instance:以下示例为mongod实例设置：

• the profiling level to 2,
• a filter of { op: "query", millis: { $gt: 2000 } }, which causes the profiler to only record query operations that took longer than 2 seconds.{ op: "query", millis: { $gt: 2000 } }的筛选器，这将导致探查器只记录花费超过2秒的query操作。

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

The method returns a document with the previous values for the settings.该方法返回一个文档，其中包含设置的先前值。

To view the current profiling level, see db.getProfilingStatus().要查看当前的分析级别，请参阅db.getProfilingStatus()。