数据库分析器

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

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

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

指定慢速操作的阈值

默认情况下，慢操作阈值为 100 毫秒。要更改慢操作阈值，请通过以下方式指定所需的阈值：

• 使用 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 } )

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

• queryHash 帮助识别具有相同查询结构的慢查询。

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

从版本 4.2 开始，副本集的从节点现在会记录应用时间超过慢操作阈值时长的 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 实例启用分析。

但是，从 MongoDB 4.0 开始，您可以在 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 } )

显示最近的五个事件

在已启用分析的数据库上，show profile 中的mongosh 辅助程序会显示5 个至少用了1 毫秒执行的最新操作。从 运行show profile mongosh：

show profile

system.profile集合

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

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

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

1. 禁用分析。

2. 删除 system.profile 集合。

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

4. 重新启用分析。

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

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

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

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