数据库分析器

全局和每个数据库的分析设置

slowms 和 sampleRate 分析设置为全局设置，设置后会影响进程中的所有数据库。

通过 profile 命令或 db.setProfilingLevel() shell 助手方法设置时，分析级别和过滤器设置在数据库级别设置。设置为命令行或配置文件选项时，分析级别和 filter 设置会影响整个进程。

指定慢速操作的阈值

默认情况下，慢操作阈值为 100 毫秒。

根据 workingMillis记录慢操作，这是 MongoDB 处理该操作所花费的时间。这意味着等待锁和流量控制等因素不会影响操作是否超过慢操作阈值。

要更改慢操作阈值，请通过以下方式指定所需的阈值：

• 使用 profile 命令或db.setProfilingLevel() Shell 助手方法来设置 slowms 的值。

• 启动时通过命令行设置 --slowms 参数的值。

• 在配置文件中设置 slowOpThresholdMs 的值。

以下示例将当前连接数据库的分析级别设置为 1 并将 mongod 实例的慢操作阈值设置为 20 毫秒：

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

分析级别为 1 会导致分析器记录慢于 slowms 阈值的擦作。

您可以使用 db.setProfilingLevel() 来为 mongos 配置 slowms 和 sampleRate。对于 mongos，slowms 和 sampleRate 配置设置仅影响诊断日志而不影响分析器，因为在 mongos 上无法使用分析。[1]

以下示例设置 mongos 实例的慢操作阈值，用于将慢操作记录到 20：

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

用于读写操作的分析器条目和诊断日志消息（即 mongod/mongos 日志消息）包括：

• planCacheShapeHash 帮助识别具有相同计划缓存查询结构的慢查询。

  从 MongoDB 8.0 开始，预先存在的 queryHash 字段被重命名为 planCacheShapeHash。如果正在使用早期版本的 MongoDB，您将看到 queryHash 而不是 planCacheShapeHash。

• planCacheKey 更深入地了解慢查询的查询计划缓存。

现在，副本集的从节点会记录应用时间超过慢操作阈值的 oplog 条目。这些慢 oplog 消息：

• 在diagnostic log中针对从节点记录。

• 记录在 REPL 组件下，该组件将含有文本 applied op: <oplog entry> took <num>ms。

• 不依赖日志级别（系统级别或组件级别）

• 不依赖于分析级别。

• 受 slowOpSampleRate 影响。

分析器不会捕获慢 oplog 条目。

分析慢操作的随机样本

要仅对所有慢操作中一个随机采样的子集进行分析，请按照以下方式指定所需采样率：[2]

• 使用 profile 命令或db.setProfilingLevel() Shell 助手方法来设置 sampleRate 的值。

• 在启动时通过命令行，为 mongod 设置 --slowOpSampleRate 的值，为 mongos 设置 --slowOpSampleRate 的值。

• 在配置文件中设置 slowOpSampleRate 的值。

默认情况下，sampleRate 设置为 1.0，即对所有慢操作进行分析。当 sampleRate 设置在 0 和 1 之间时，分析级别为 1 的数据库仅分析基于 sampleRate 随机采样的一部分慢操作。

以下示例将当前连接数据库的分析级别设置为 1，并将分析器设置为对所有慢速操作进行 42% 的采样：

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

修改后的样本率值也适用于系统日志。

您可以使用 db.setProfilingLevel() 来为 mongos 配置 slowms 和 sampleRate。对于 mongos，slowms 和 sampleRate 配置设置仅影响诊断日志而不影响分析器，因为在 mongos 上无法使用分析。[1]

例如，以下设置了 mongos 实例用于记录慢速操作的采样率：

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

设置过滤器以确定要进行分析的操作

您可以设置筛选器，控制要分析和记录的操作。您可以通过以下一种方式设置分析筛选器：

• 使用 profile 命令或 db.setProfilingLevel() Shell 助手方法设置 filter 值。

• 在配置文件中设置 filter 的值。

对于 mongod 实例，该 filter 既影响诊断日志，也会影响剖析器（如果启用）。

对于 mongos 实例，filter 仅影响诊断日志而不影响分析器，因为 mongos 无法使用分析。

以下 db.setProfilingLevel() 示例为当前连接数据库设置的配置文件级别：

• 将分析级别设置为 2，

• { op: "query", millis: { $gt: 2000 } } 的筛选器，这会导致分析器仅记录耗时超过 2 秒的 query 操作。

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

检查分析级别

要查看分析级别，请在 mongosh 中运行以下示例：

db.getProfilingStatus()

Shell 返回类似于以下内容的文档：

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

was 字段指示当前分析级别。

slowms 字段表示操作时间阈值（毫秒），超过该阈值的操作将被视为慢。

sampleRate字段表示应分析的慢速操作的百分比。

禁用性能分析

要禁用分析，请在 mongosh 中运行以下示例：

db.setProfilingLevel(0)

为整个 mongod 实例启用性能分析

对于开发和测试环境，可以对整个 mongod 实例启用数据库分析。分析级别可应用于 mongod 实例提供的所有数据库。

要为 mongod 实例启用分析，请在启动时将以下选项传递给 mongod。

mongod --profile 1 --slowms 15 --slowOpSampleRate 0.5

或者，您可以在配置文件中指定 operationProfiling。

这会将分析级别设为 1，将慢速操作定义为持续时间超过 15 毫秒的操作，并指定仅应分析 50% 的慢速操作。[2]

slowms 和 slowOpSampleRate 还会影响当 logLevel 设置为 0 时诊断日志中记录的操作。slowms 和 slowOpSampleRate 还可用于配置 mongos 的诊断日志。[2]

数据库分析与分片

无法在 mongos 实例上启用分析。要在分片集群中启用分析，必须为集群中的每个 mongod 实例启用分析。

但是，您可以在 mongos 上设置 --slowms 和 slowOpSampleRate，以便为慢操作配置诊断日志。

分析器数据查询示例

本部分将展示 system.profile 集合上的查询示例。有关查询输出的详细信息，请参阅数据库分析器输出。

要返回 system.profile 集合中最近的 10 个日志条目，请运行与以下类似的查询：

db.system.profile.find().limit(10).sort( { ts : -1 } ).pretty()

要返回除命令操作 ($cmd) 以外的所有操作，请运行类似以下内容的查询：

db.system.profile.find( { op: { $ne : 'command' } } ).pretty()

要返回特定集合的操作，请运行类似于以下内容的查询。此示例会返回 mydb 数据库中 test 集合的操作：

db.system.profile.find( { ns : 'mydb.test' } ).pretty()

要返回耗时超过 5 毫秒的操作，请运行：

db.system.profile.find( { millis : { $gt : 5 } } ).pretty()

要返回特定时间范围的操作，请运行：

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2012-12-09T03:00:00Z"),
      $lt: new ISODate("2012-12-09T03:40:00Z")
   }
} ).pretty()

以下示例会查看时间范围，抑制输出中的 user 字段，使其更易于阅读，并按每个操作运行所需的时长对结果进行排序：

db.system.profile.find( {
   ts : {
      $gt: new ISODate("2011-07-12T03:00:00Z"),
      $lt: new ISODate("2011-07-12T03:40:00Z")
   }
}, { user: 0 } ).sort( { millis: -1 } )

显示最近的五个事件

在启用分析的数据库上，mongosh 中的 show profile 辅助命令会显示最近 5 个执行耗时至少为 1 毫秒的操作。从 mongosh 运行 show profile：

show profile

system.profile 集合

system.profile 集合是一个固定大小集合，默认大小为 1 MB。这种大小的集合通常可以存储数千个分析文档，但某些应用程序每次操作可能会使用或多或少的分析数据。如果需要更改 system.profile 集合的大小，请按照以下步骤操作。

更改主节点上的 system.profile 集合的大小

要更改主节点上的 system.profile 集合的大小，您必须：

1. 禁用分析。

2. 删除 system.profile 集合。

3. 创建一个新的 system.profile 集合。

4. 重新启用分析。

例如，要创建一个新的 system.profile 集合，大小为 4000000 字节 (4 MB)，请在 mongosh 中使用以下操作序列：

db.setProfilingLevel(0)
db.system.profile.drop()
db.createCollection( "system.profile", { capped: true, size:4000000 } )
db.setProfilingLevel(1)

更改从节点上的 system.profile 集合的大小

要更改从节点 system.profile 集合的大小，必须停止从节点，让其独立运行，然后执行上述步骤。完成后，作为副本集的节点重新独立运行。有关更多信息，请参阅对自管理副本集节点执行维护。