数据库分析器

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

slowms 和 sampleRate 是影响进程中所有数据库的全局设置。

Profiling level 和 过滤器 是 数据库级 设置，当使用 profile 或 db.setProfilingLevel() 设立时。当设立为命令行或配置文件选项时，它们会影响整个进程。

指定慢速操作的阈值

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

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

要更改慢操作阈值，请使用以下方法之一：

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

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

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

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

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

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

对于mongos，使用db.setProfilingLevel()配置 slowms 和 sampleRate。这些设置仅影响 mongos 上的诊断日志，而不影响分析器。分析在mongos上不可用。[1]

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

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

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

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

  从MongoDB 8.0 开始，现有的 queryHash字段将复制到名为 planCacheShapeHash 的新字段中。 如果您使用的是早期MongoDB版本，则只能看到 queryHash字段。 未来的MongoDB版本将删除已弃用的 queryHash字段，您需要改用 planCacheShapeHash字段。

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

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

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

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

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

• 不依赖于分析级别。

• 受 slowOpSampleRate 影响。

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

分析慢操作的随机样本

要仅分析慢速操作的随机采样子集，请通过以下方式之一设立sampleRate：[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 } )

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

对于mongos、slowms 和 sampleRate，仅影响诊断日志，不影响分析器。[1] 要设立mongos 日志记录的采样率：

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

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

要控制分析和记录哪些操作，请通过以下方式之一设立过滤器：

• profile 命令或 db.setProfilingLevel()。

• filter配置文件中的 。

对于 mongod，filter 同时影响诊断日志和分析器（如果已启用）。对于mongos，filter 仅影响诊断日志。

以下示例使用仅记录耗时超过 2 秒的 query 操作的过滤设置分析级别 1：

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

检查分析级别

要查看分析级别，请在mongosh:中运行：

db.getProfilingStatus()

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

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

返回的文档包含：

• was：当前分析级别。

• slowms: operation time 阈值（以毫秒为单位）。

• sampleRate：正在分析的慢速操作的百分比。

禁用性能分析

要禁用分析，请在 mongosh: 中运行：

db.setProfilingLevel(0)

为整个 mongod 实例启用分析

对于开发和测试环境，您可以为整个mongod实例启用分析。分析级别适用于该实例上的所有数据库。

在初创企业时将以下选项传递给 mongod：

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

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

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

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

数据库分析与分片

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

您可以在 上设立 和--slowms slowOpSampleRatemongos，以配置慢速操作的诊断日志。

分析器数据查询示例

本部分将展示 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 集合在 主节点 (primary node in the replica set) 上的大小，请执行以下操作：

1. 禁用分析。

2. 删除 system.profile 集合。

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

4. 重新启用分析。

mongosh示例，要在: system.profile中创建4000000 字节 (4 MB) 的新集合：

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

更改从节点(secondary node from replica set)上 system.profile 集合的大小

要更改从从节点(secondary node from replica set)上system.profile集合的大小，请停止从从节点(secondary node from replica set)，将其作为独立运行的实例运行，然后执行上述步骤。然后，将其作为副本集成员重新启动。有关更多信息，请参阅对自管理副本集成员执行维护。