2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1

19.9. 运行时统计 #

19.9.1. 累计查询和索引统计 #

这些参数控制服务器范围内的累计统计系统。启用后,可以通过 pg_statpg_statio 系列系统视图访问收集的数据。有关更多信息,请参阅 第 27 章

track_activities (boolean) #

启用收集有关每个会话当前正在执行的命令的信息,以及其标识符和该命令开始执行的时间。此参数默认开启。请注意,即使启用,此信息也仅对超级用户、具有 pg_read_all_stats 角色权限的角色以及拥有所报告会话的用户(包括属于他们拥有权限的角色的会话)可见,因此它不应构成安全风险。只有超级用户和具有适当 SET 权限的用户可以更改此设置。

track_activity_query_size (integer) #

指定为每个活动会话保留的内存量,用于存储 pg_stat_activity.query 字段中当前正在执行的命令的文本。如果指定此值时没有单位,则将其视为字节。默认值为 1024 字节。此参数只能在服务器启动时设置。

track_counts (boolean) #

启用收集有关数据库活动的统计信息。此参数默认开启,因为自动清理守护进程需要收集的信息。只有超级用户和具有适当 SET 权限的用户可以更改此设置。

track_io_timing (boolean) #

启用数据库 I/O 调用的计时。此参数默认关闭,因为它会重复查询操作系统以获取当前时间,这可能会在某些平台上导致大量开销。您可以使用 pg_test_timing 工具来衡量系统上计时的开销。I/O 计时信息显示在 pg_stat_databasepg_stat_io 中,在使用 BUFFERS 选项时 EXPLAIN 的输出中,在使用 VERBOSE 选项时 VACUUM 的输出中,在 log_autovacuum_min_duration 设置时自动清理的自动清理和自动分析中,以及在 pg_stat_statements 中。只有超级用户和具有适当 SET 权限的用户可以更改此设置。

track_wal_io_timing (boolean) #

启用 WAL I/O 调用的计时。此参数默认关闭,因为它会重复查询操作系统以获取当前时间,这可能会在某些平台上导致大量开销。您可以使用 pg_test_timing 工具来衡量系统上计时的开销。I/O 计时信息显示在 pg_stat_wal 中。只有超级用户和具有适当 SET 权限的用户可以更改此设置。

track_functions (enum) #

启用跟踪函数调用计数和使用时间。指定 pl 以仅跟踪过程语言函数,指定 all 以也跟踪 SQL 和 C 语言函数。默认值为 none,它禁用函数统计跟踪。只有超级用户和具有适当 SET 权限的用户可以更改此设置。

注意

足够简单的 SQL 语言函数(可以内联到调用查询中)将不会被跟踪,无论此设置如何。

stats_fetch_consistency (enum) #

确定在事务内多次访问累计统计信息时的行为。当设置为 none 时,每次访问都会从共享内存中重新获取计数器。当设置为 cache 时,对对象统计信息的第一次访问将缓存这些统计信息,直到事务结束,除非调用 pg_stat_clear_snapshot()。当设置为 snapshot 时,第一次统计信息访问将缓存当前数据库中可访问的所有统计信息,直到事务结束,除非调用 pg_stat_clear_snapshot()。在事务中更改此参数将丢弃统计信息快照。默认值为 cache

注意

none 最适合监控系统。如果值只访问一次,它是最高效的。 cache 确保重复访问产生相同的值,这对于涉及例如自联接的查询很重要。 snapshot 在交互式检查统计信息时很有用,但开销更高,尤其是在存在许多数据库对象时。

19.9.2. 统计监控 #

compute_query_id (enum) #

启用查询标识符的内核计算。查询标识符可以在 pg_stat_activity 视图中显示,使用 EXPLAIN,或者如果通过 log_line_prefix 参数配置,则在日志中发出。 pg_stat_statements 扩展也需要计算查询标识符。请注意,如果内核查询标识符计算方法不可接受,则可以改用外部模块。在这种情况下,内核计算必须始终禁用。有效值为 off(始终禁用)、on(始终启用)、auto,它允许 pg_stat_statements 等模块自动启用它,以及 regress,它与 auto 的效果相同,但查询标识符不会显示在 EXPLAIN 输出中,以方便自动化回归测试。默认值为 auto

注意

为了确保只计算和显示一个查询标识符,计算查询标识符的扩展应该在已经计算了查询标识符的情况下抛出错误。

log_statement_stats (boolean)
log_parser_stats (boolean)
log_planner_stats (boolean)
log_executor_stats (boolean) #

对于每个查询,将相应模块的性能统计信息输出到服务器日志。这是一种粗略的分析工具,类似于 Unix getrusage() 操作系统工具。 log_statement_stats 报告总的语句统计信息,而其他选项报告每个模块的统计信息。 log_statement_stats 不能与任何模块选项一起启用。默认情况下,所有这些选项都处于禁用状态。只有超级用户和具有相应 SET 权限的用户可以更改这些设置。

提交更正

如果您在文档中看到任何不正确的信息,与您对特定功能的体验不符,或者需要进一步说明,请使用 此表格 报告文档问题。