对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/
开发中
/
mongosh 方法
Docs 主页
/
开发中
/
mongosh 方法
Docs 主页
/
开发中
/
mongosh 方法

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 开始，使用 levelslowmssampleRatefilter命令或profile 包装器方法对数据库分析器 、db.setProfilingLevel() 、 或 所做的更改将记录在log file 中。

兼容性

此方法可用于以下环境中托管的部署：

  • MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

重要

M0 和 Flex 集群不支持此命令。有关更多信息，请参阅不支持的命令。

语法

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

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

参数

Parameter
类型
说明

等级

整型

配置数据库分析器级别。以下分析器级别可用：

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 参数而不是文档传递，则该值将分配给 slowms。可以使用以下选项：

slowms

默认值：100
类型：整数

慢速操作时长阈值（以毫秒为单位）。运行时长超过此阈值的操作被视为慢速操作。

当 logLevel 设置为 0 时，MongoDB 会将慢速操作记录到诊断日志中，记录速度由 slowOpSampleRate 确定。

在较高的 logLevel 设置下，所有操作都会出现在诊断日志中，无论其延迟如何，但从节点(secondary node from replica set)记录慢速 oplog 条目消息的操作除外。从节点(secondary node from replica set)仅日志慢速 oplog 条目；增加 logLevel 不会日志所有 oplog 条目。

对于 mongod 实例，该设置会影响诊断日志，如果启用，还会影响分析器。

对于 mongos 实例，该设置仅影响诊断日志，不影响分析器，因为在 mongos 上无法进行分析。

此参数影响与配置文件选项 slowOpThresholdMs 相同的设置。

采样率

默认值：1.0
类型：double

应分析或记录的慢速操作的比例。sampleRate 接受 0 到 1（含）之间的值。

对于 mongod 实例，该设置会影响诊断日志，如果启用，还会影响分析器。

对于 mongos 实例，该设置仅影响诊断日志，不影响分析器，因为在 mongos 上无法进行分析。

此参数影响与配置选项 slowOpSampleRate 相同的设置。

筛选器

类型：对象

一个筛选器表达式，用于控制要分析和记录的操作。该筛选器表达式中的字段可以是分析器输出中的任何字段。

对于 mongod 实例，该设置会影响诊断日志，如果启用，还会影响分析器。

对于 mongos 实例，该设置仅影响诊断日志，不影响分析器，因为在 mongos 上无法进行分析。

如需用于控制已记录操作的过滤器示例，请参阅设置过滤器以确定已分析的操作。

设置分析过滤器时，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 实例：

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

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

要查看当前分析级别，请参阅 db.getProfilingStatus()。

禁用性能分析器并设置慢操作阈值和采样率

下面的示例为 mongod 或 mongos 实例进行了设置：

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
给本页内容打分

在此页面上