db.setProfilingLevel（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 数据库方法 > db.setProfilingLevel（）

在本页面

定义
行为
例子

定义¶

db.setProfilingLevel（level，options ）¶

该方法配置数据库探查器级别，slowms和sampleRate。

如果数据库探查器级别为 1或2（即，启用了数据库探查器），则减慢速度和 sampleRate会影响探查器和的行为。diagnostic log

如果数据库探查器级别为 0（即禁用了数据库探查器），则速度减慢和 sampleRate仅影响诊断日志。

虽然分析是上不可用mongos情况下，在MongoDB中4.0开始，你可以运行 db.setProfilingLevel()在mongos设定 slowms和采样率的诊断日志。也就是说，对于一个mongos实例，必须0为level指定。

db.setProfilingLevel()提供围绕profile命令的包装。

语法¶

该db.setProfilingLevel()方法具有以下形式：

复制

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

参数¶

参数类型描述

水平

整数

配置数据库探查器级别。提供以下探查器级别：

水平	描述
`0`	探查器已关闭，并且不收集任何数据。这是默认的探查器级别。
`1`	剖析器收集的数据花费的时间超过的值`slowms`。
`2`	探查器收集所有操作的数据。

由于无法在上使用概要分析mongos， db.setProfilingLevel()因此不能用于将概要分析级别设置0为mongos实例以外的值。

选项

文件或整数

可选的。接受整数或期权文件。如果将整数值作为options参数而不是文档作为参数传递，则该值将分配给slowms。提供以下选项：

慢速	默认值：100 类型：整数该慢的操作时间阈值，单位为毫秒。运行时间超过此阈值的操作被认为是缓慢的。当`logLevel`设置为`0`，MongoDB的记录速度慢，在所确定的速度诊断日志操作 `slowOpSampleRate`。从MongoDB 4.2开始，副本集的辅助副本将记录所有花费比慢操作阈值更长的时间来应用的oplog条目消息，而不管采样率如何。在更高的`logLevel`设置下，所有操作都将在诊断日志中显示，而不管其等待时间如何，但以下情况除外：次要对象记录慢速oplog条目消息。辅助节点仅记录慢速操作日志条目；增加`logLevel`不会记录所有操作日志条目。对于`mongod`实例，该设置会影响诊断日志和探查器（如果启用）。对于`mongos`情况下，该设置会影响诊断日志，而不是探查，因为分析是不可用的`mongos`。注意此参数影响与配置文件选项相同的设置`slowOpThresholdMs`。
采样率	默认值：1.0 类型：双应当分析或记录的慢速操作的一部分。 `sampleRate`接受0到1之间的值（包括0和1）。对于`mongod`实例，该设置会影响诊断日志和探查器（如果启用）。对于`mongos`情况下，该设置会影响诊断日志，而不是探查，因为分析是不可用的`mongos`。注意此参数影响与配置选项相同的设置 `slowOpSampleRate`。

返回¶

该方法返回一个包含先前设置值的文档。

单机版
副本集成员
mongos实例

复制

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

复制

{
   "was" : 0,
   "slowms" : 100,
   "sampleRate" : 1,
   "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,
   "ok" : 1,
   "operationTime" : Timestamp(1572991499, 2),
   "$clusterTime" : {
      "clusterTime" : Timestamp(1572991499, 2),
      "signature" : {
         "hash" : BinData(0,"nhCquIxUw7thlrBudXe3PnsnvP0="),
         "keyId" : NumberLong("6755946491040235540")
      }
   }
}

哪里：

was是上一个级别的设置。
slowms是先前的 减慢设置。
sampleRate是先前的 sampleRate设置。

要查看当前配置文件级别，请参阅db.getProfilingStatus()。

行为¶

重要

分析可能会影响性能并与系统日志共享设置。在生产部署上配置和启用探查器之前，请仔细考虑所有性能和安全隐患。

有关潜在性能下降的更多信息，请参见Profiler Overhead。

例子¶

启用Profiler并设置慢速操作阈值和采样率¶

以下示例为mongod实例设置：

该分析级别来1，
慢速操作阈值减慢到20毫秒，并且
的采样率来 0.42。

复制

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

该方法返回具有先前设置值的文档。

要查看当前配置文件级别，请参阅db.getProfilingStatus()。

禁用Profiler并设置慢速操作阈值和采样率¶

以下示例为mongod或 mongos实例设置：

该分析级别来0，
慢速操作阈值减慢到20毫秒，并且
的采样率来 0.42。

复制

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

该方法返回具有先前设置值的文档。

要查看当前配置文件级别，请参阅db.getProfilingStatus()。