profile

定义

profile

已更改在版本中5.0.

对于mongod 实例，此命令启用、禁用或配置 数据库分析器。分析器捕获并记录运行中 mongod 实例上写操作、游标和数据库命令的性能数据。如果分析器被禁用，则该命令配置如何将缓慢的操作记录到诊断日志中。

在 mongod 上，如果 数据库分析器级别 为 2，则在分析器中启用完整日志记录，并在 诊断日志 中。

在 数据库分析器级别 1 时，以下设置会修改分析器和 诊断日志：

• slowms

• sampleRate

• filter

如果 数据库分析器级别 为 0，则 数据库分析器 被禁用。在级别 0 时，以下设置仅修改诊断日志

• slowms

• sampleRate

• filter

对于 mongos 实例，该命令仅配置如何将操作写入诊断日志。您不能在 数据库分析器 上启用 mongos 实例，因为 mongos 没有任何分析器可以写入的集合。

从 MongoDB 5.0 开始，使用 profile 命令或 db.setProfilingLevel() 包装方法对 数据库分析器 的 level、slowms、sampleRate 或 filter 进行更改将记录在 日志文件 中。在 mongos 上，您可以设置 profile 级别为

0 以设置诊断日志的 slowms、sampleRate 和 filter；

• -1 以读取当前设置。

• 默认情况下分析器是关闭的。

注意

警告

分析可能会降低性能并在系统日志中暴露未加密的查询数据。在配置和启用生产部署中的分析器之前，仔细考虑任何性能和安全影响。

有关性能下降的更多信息，请参阅 分析器开销。

兼容性

此命令在以下环境中提供

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

• MongoDB Enterprise：基于订阅的自托管 MongoDB 版本

• MongoDB Community：源代码可用的免费使用和自托管 MongoDB 版本

语法

命令有以下语法

db.runCommand(
  {
    profile: <level>,
    slowms: <threshold>,
    sampleRate: <rate>,
    filter: <filter expression>
  }
)

命令字段

命令接受以下字段

{ <field1>: <expression1>, ... }

db.getProfilingStatus()和db.setProfilingLevel() shell方法是profile命令的包装器。

行为

执行 profile 命令时，会对受影响的数据库加写锁，同时启用或禁用性能分析器。这通常是一个短暂的操作。该锁会阻塞其他操作，直到 profile 命令执行完毕。

通过 mongos 连接到分片集群时，您可以对任何数据库运行 profile 命令。

示例

db.runCommand(
   {
     profile: 1,
     filter:
        {
           $or:
           [
              { millis: { $gte: 100 } },
              { user: "testuser@admin" }
           ]
        }
   }
)

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