数据库分析器输出

在此页面上

示例 system.profile 文档

输出参考

数据库分析器捕获有关读写操作、游标操作和数据库命令的数据信息。要配置数据库配置文件并设置捕获配置文件数据的阈值，请参阅数据库分析器部分。

数据库分析器会在 system.profile 集合中写入数据，这是一个固定大小集合。要查看分析器的输出，请对 system.profile 集合使用一般 MongoDB 查询。

注意

由于数据库分析器会将数据写入数据库中的system.profilecollection，因此分析器将分析某些写入活动，即使对于只读的数据库也是如此。

currentOp和数据库分析器会为所有 CRUD 操作报告相同的基本诊断信息，其中包括：

这些操作也包含在慢查询日志中（有关慢查询日志的更多信息，请参阅slowOpThresholdMs）。

无法再在事务中对system.profile集合执行任何操作，包括读取。

警告

请勿尝试创建名称为system.profile的时间序列集合或视图，否则 MongoDB Server 会崩溃。

示例`system.profile`文档

下面介绍了在system.profilecollection中找到的一些文档，这些文档用于独立运行的实例：

输出参考

对于任何单个操作，数据库分析器创建的文档都将包含以下字段的子集。这些文档中字段的精确选择取决于操作类型。

从 MongoDB 4开始。 2 （以及在4 . 0 . 9中），对于慢速操作，分析器条目和诊断日志消息包括 storage信息。

注意

有关 MongoDB 版本的特定输出，请参阅相应版本的 MongoDB 手册。

system.profile.op

操作类型。可能的值为：

command
count
distinct
geoNear
getMore
group
insert
mapReduce
query
remove
update

system.profile.ns: 该操作所针对的命名空间。MongoDB 中的命名空间采用数据库的形式，后接一个点 (.)，然后是集合名称。

system.profile.command

包含与此操作相关的完整命令对象的文档。

例如，以下输出包含在 test 数据库中 items 集合上执行的 find 操作的命令对象：

"command" : {
  "find" : "items",
  "filter" : {
    "sku" : 1403978
  },
  ...
  "$db" : "test"
}

以下示例输出包含 getMore 操作的命令对象，该命令对象由游标 ID 为 19234103609 的命令在名为 test 的数据库中名为 items 的集合上生成：

"command" : {
    "getMore" : NumberLong("19234103609"),
    "collection" : "items",
    "batchSize" : 10,
    ...
    "$db" : "test"
},

如果命令文档的大小超过 50 KB，则文档的格式如下：

"command" : {
  "$truncated": <string>,
  "comment": <string>
}

$truncated 字段包含文档的字符串概要，不包括文档的 comment 字段（如果存在）。如果概要仍然超过 50 KB，则会进一步截断，在字符串末尾用省略号 (...) 表示。

如果将注释传递给操作，则会出现comment字段。注释可以附加到任何数据库命令。

system.profile.originatingCommand: 3.6 版本中的更改。
对于会从游标检索下一批结果的 "getmore" 操作，originatingCommand 字段包含最初创建该游标的完整命令对象（例如，find 或 aggregate）。

system.profile.cursorid: query 和 getmore 操作访问的游标的 ID。

system.profile.keysExamined

在 3.2.0 版本中进行了更改。

由system.profile.nscanned重命名。 MongoDB 为执行操作而扫描的索引键数量。

一般来说，如果keysExamined远高于nreturned ，则数据库正在扫描多个索引键以查找结果文档。考虑创建或调整索引以提高查询性能。

已在 3.4 版本中更改。

keysExamined 可用于以下命令和操作：

system.profile.docsExamined

在 3.2.0 版本中进行了更改：由system.profile.nscannedObjects重命名。

MongoDB 为了执行该操作而扫描的集合中的文档数量。

已在 3.4 版本中更改。

docsExamined 可用于以下命令和操作：

system.profile.hasSortStage

在 3.2.0 版本中进行了更改：由system.profile.scanAndOrder重命名。

hasSortStage是一个布尔值，当查询无法使用索引中的顺序返回请求的排序结果时，该值为true ；即，MongoDB 在从游标接收到文档后必须对文档进行排序。该字段仅在值为true时出现。

已在 3.4 版本中更改。

hasSortStage 可用于以下命令和操作：

system.profile.usedDisk

4.2 版本中的新增功能。

一个布尔值，表示是否有任何聚合阶段由于内存限制而将数据写入临时文件。

仅在 usedDisk 为 true 时显示。

system.profile.ndeleted: 此操作删除的文档数。

system.profile.ninserted: 此操作插入的文档数。

system.profile.nMatched: 符合更新操作查询条件的文档的数量。

system.profile.nModified: 更新操作修改的文档数量。

system.profile.upsert: 指示更新操作的 upsert 选项值的布尔值。仅当 upsert 为 true 时才出现。

system.profile.fromMultiPlanner

布尔值，表示查询规划器在为查询选择取胜执行计划之前是否评估了多个计划。

仅在值为 true 时显示。

system.profile.replanned

一个布尔值，表示查询系统是否逐出了缓存的计划并重新评估了所有候选计划。

仅在值为 true 时显示。

system.profile.replanReason

一个字符串，表示缓存计划被逐出的具体原因。

仅在 replanned 的值为 true 时显示。

system.profile.keysInserted: 为给定写操作插入的索引键的数量。

system.profile.keysDeleted

已在 3.4 中删除。

更新在操作中更改的索引键的数量。更改索引键的性能成本很小，因为数据库必须删除旧键并将新键插入 B-Tree 索引。

system.profile.writeConflicts: 写入操作过程中遇到的冲突次数；例如，一个 update 操作尝试与另一个 update 操作修改同一文档。另请参阅写冲突。

system.profile.numYield: 该操作让出以允许其他操作完成的次数。通常，当操作需要访问 MongoDB 尚未完全读入内存的数据时，它们就会让出。这使得在 MongoDB 读取让出操作的数据时，其他已经在内存中有数据的操作可以完成。有关更多信息，请参阅有关操作让出时的常见问题解答。

system.profile.queryHash

一个十六进制字符串，表示查询结构的哈希值，并且仅依赖于查询结构。queryHash 可以帮助识别具有相同查询结构的慢查询（包括写入操作的查询筛选器）。

注意

与任何哈希函数一样，两个不同的查询结构可能会产生相同的哈希值。但是，不同查询结构之间不太可能发生哈希冲突。

有关 queryHash 和 planCacheKey 的更多信息，请参阅 queryHash 和 planCacheKey。

4.2 版本中的新增功能。

system.profile.planCacheKey

与此查询关联的计划缓存条目的键的哈希值。

与queryHash不同， planCacheKey是查询结构和该结构当前可用索引的函数。也就是说，如果添加/删除可以支持该查询结构的索引，则planCacheKey值可能会更改，而queryHash值不会更改。

有关 queryHash 和 planCacheKey 的更多信息，请参阅 queryHash 和 planCacheKey。

4.2 版本中的新增功能。

system.profile.queryFramework: 用于处理操作的查询框架。

system.profile.locks

system.profile.locks提供操作期间持有的各种锁类型和锁模式的信息。

可能的锁类型包括：

锁类型	说明
`ParallelBatchWriterMode`	代表并行批量写入模式的锁。在早期版本中，PBWM 信息作为 `Global` 锁信息的一部分进行报告。 4.2 版本中的新增功能。
`ReplicationStateTransition`	表示副本集节点状态转换采用的锁。 4.2 版本中的新增功能。
`Global`	代表全局锁定。
`Database`	代表数据库锁。
`Collection`	代表集合锁。
`Mutex`	代表互斥锁。
`Metadata`	代表元数据锁。
`oplog`	表示 oplog 上的锁。

锁类型的可能锁模式如下：

锁模式	说明
`R`	代表共享（S）锁。
`W`	代表独占 (X) 锁。
`r`	代表意向共享（IS）锁。
`w`	代表意图独占 (IX) 锁。

针对各种锁类型返回的锁信息包括：

system.profile.locks.acquireCount: 该操作在指定模式下获取锁的次数。

system.profile.locks.acquireWaitCount: 由于锁处于冲突模式而导致该操作必须等待acquireCount锁获取的次数。 acquireWaitCount小于或等于acquireCount 。

system.profile.locks.timeAcquiringMicros

操作获取锁所需等待的累计时间（以微秒为单位）。

timeAcquiringMicros除以acquireWaitCount得出特定锁模式的大致平均等待时间。

system.profile.locks.deadlockCount: 该操作在等待锁获取时遇到死锁的次数。

有关锁模式的更多信息，请参阅MongoDB 使用哪种类型的锁？

system.profile.authorization

5.0.0 版本新增。

每次操作访问用户缓存的次数。只有当操作至少访问过一次用户缓存时，才会显示这些指标。

这些指标仅在启用慢操作日志记录或数据库分析功能时可用。

system.profile.authorization未包含在db.currentOp()输出中。

system.profile.authorization.startedUserCacheAcquisitionAttempts: 操作尝试访问用户缓存的次数。

system.profile.authorization.completedUserCacheAcquisitionAttempts: 操作从用户缓存中检索用户数据的次数。

system.profile.authorization.userCacheWaitTimeMicros: 此操作等待用户缓存响应的总时长。

system.profile.storage

版本 4.2 中的新增功能：（从 4.0.9 开始也可用）

system.profile.storage信息提供有关存储引擎数据和操作等待时间的指标。

仅当值大于零时，才会返回特定存储指标。

system.profile.storage.data.bytesRead

版本 4.2 中的新增功能：（从 4.0.9 开始也可用）

该操作从磁盘读取到缓存的字节数。

从磁盘读入缓存的数据包括执行查询所需的所有内容。如果数据已在缓存中，则从磁盘读取的字节数可能为 0。

从磁盘读取的字节数超过查询到的文档的字节数：

WiredTiger 以页面为单位读取，一页可能包含一份或多份文档。如果有文档位于某页面，则该页面中的所有文档都会读入缓存并包含在 bytesRead 值中。
如果缓存需要页面管理（例如，逐出或重新读取），则 bytesRead 值包括在这些操作中从磁盘读取的数据。
如果索引不在缓存中或者缓存中的索引已过时，WiredTiger 会从磁盘读取几个内部页和叶子页，以重建缓存中的索引。

system.profile.storage.data.timeReadingMicros: 版本 4.2 中的新增功能：（从 4.0.9 开始也可用）
操作从磁盘读取数据所花费的时间（以微秒为单位）。

system.profile.storage.data.bytesWritten

版本 4.2 中的新增功能：（从 4.0.9 开始也可用）

操作从缓存写入磁盘的字节数。

WiredTiger 通常不需要将查询写入磁盘。查询修改的数据被写入内存缓存，WiredTiger 将其作为逐出或检查点操作的一部分刷新到磁盘。在这种情况下，bytesWritten 显示为 0。

如果运行查询的线程需要强制页面管理（例如逐出），则 WiredTiger 会将页面内容写入磁盘。此刷新可能包含与查询本身所做的与更改无关的数据，这可能会导致bytesWritten显示的值比预期更高。

system.profile.storage.data.timeWritingMicros: 版本 4.2 中的新增功能：（从 4.0.9 开始也可用）
操作写入磁盘所花费的时间（以微秒为单位）。

system.profile.storage.timeWaitingMicros.cache: 版本 4.2 中的新增功能：（从 4.0.9 开始也可用）
该操作必须等待缓存中有空间的时间（以微秒为单位）。

system.profile.storage.timeWaitingMicros.schemaLock: 版本 4.2 中的新增功能：（从 4.0.9 开始也可用）
操作（如果修改了模式）在获取模式锁之前必须等待的时间（以微秒为单位）。

system.profile.storage.timeWaitingMicros.handleLock: 版本 4.2 中的新增功能：（从 4.0.9 开始也可用）
此操作必须为获取对所需数据句柄的锁而等待的时间（以微秒为单位）。

system.profile.nreturned: 该操作返回的文档数。

system.profile.responseLength

操作结果文档的长度（以字节为单位）。较大的responseLength会影响性能。要限制查询操作结果文档的大小，可以使用以下任一方法：

注意

当 MongoDB 将查询配置文件信息写入日志时， responseLength值位于名为reslen的字段中。

system.profile.protocol: MongoDB 传输协议请求消息格式。

system.profile.millis: 从 mongod 的角度来看，从操作开始到操作结束所用的时间（以毫秒为单位）。

system.profile.planSummary: 此执行计划的摘要。

system.profile.execStats

包含查询操作的执行统计信息的文档。对于其他操作，该值为空文档。

system.profile.execStats将统计信息显示为一棵树；每个节点提供在查询操作的该阶段执行的操作的统计信息。

注意

以下execStats的字段列表并非详尽无遗，因为返回的字段因阶段而异。

system.profile.execStats.stage

作为查询执行的一部分执行的操作的描述性名称；例如

COLLSCAN 用于集合扫描
IXSCAN 用于扫描索引键
FETCH 用于检索文档

system.profile.execStats.inputStages: 包含针对特定操作的统计信息的数组；其中，这些操作属于当前阶段的输入阶段。

system.profile.ts: 操作的时间戳。

system.profile.client: 发起操作的客户端连接的 IP 地址或主机名。

system.profile.appName: 运行操作的客户端应用程序的标识符。使用 appName 连接字符串选项设置 appName 字段的自定义值。

system.profile.allUsers: 用于会话的经过身份验证的用户信息（用户名和数据库）数组。另请参阅用户。

system.profile.user: 运行操作的经过身份验证的用户。如果该操作不是由经过身份验证的用户运行的，则该字段的值为空字符串。

← 数据库分析器

禁用透明大页 (THP) →

注意

警告

示例system.profile文档

输出参考

注意

注意

注意

注意

示例`system.profile`文档