【译】postgresql 扩展工具 监控SQL扩展 pg_stat_kcache

14.1 介绍

收集有关文件系统层完成的实际读取和写入的统计信息。扩展需要 PostgreSQL >= 9.4. ，并且需要安装 pg_stat_statements 扩展。需要 PostgreSQL 9.4 或更高版本，因为提供的 pg_stat_statements 的先前版本没有公开 queryid 字段。

14.2 安装

编译
该模块可以使用标准 PGXS 基础设施构建。为此，pg_config 程序必须在您的 $PATH 中可用。安装说明如下：

git clone https://github.com/powa-team/pg_stat_kcache.git
cd pg_stat_kcache
make
make install
复制

PostgreSQL 设置

该扩展现在可用。但是，因为它需要一些共享内存来保存它的计数器，所以必须在 PostgreSQL 启动时加载该模块。因此，您必须将模块添加到您的 postgresql.conf 中的 shared_preload_libraries。您需要重新启动服务器才能将更改考虑在内。由于此扩展依赖于 pg_stat_statements，因此还需要将其添加到 shared_preload_libraries。

将以下参数添加到postgresql.conf 中：

# postgresql.conf
shared_preload_libraries = 'pg_stat_statements,pg_stat_kcache'
复制

重启 PostgreSQL 集群后，您可以在需要访问统计信息的每个数据库中安装扩展：

CREATE EXTENSION pg_stat_kcache;
复制

14.3 配置

可以在 postgresql.conf 中配置以下 GUC：

• pg_stat_kcache.linux_hz (int, default -1): 通知 pg_stat_kcache linux CONFIG_HZ 配置选项。 pg_stat_kcache 使用它来补偿采样错误。默认值为-1，尝试在启动时猜测它。
• pg_stat_kcache.track (enum, default top): 控制哪些语句被 pg_stat_kcache 跟踪。指定 top 以跟踪顶级语句（由客户端直接发出的语句）， all 也跟踪嵌套语句（例如在函数中调用的语句），或 none 以禁用语句统计收集。
• pg_stat_kcache.track_planning (bool, default off): 控制pg_stat_kcache是​​否跟踪计划操作和持续时间（需要PostgreSQL 13或更高版本）。

14.4 用法

扩展pg_stat_kcache 创建几个对象。

视图pg_stat_kcache

视图pg_stat_kcache_detail

函数pg_stat_kcache_reset

重置 pg_stat_kcache 收集的统计信息。可以由超级用户调用：

select pg_stat_kcache_reset();
复制

函数pg_stat_kcache function

此函数是一个集合返回函数，它转储共享内存结构的计数器的包含。该函数由 pg_stat_kcache 视图使用。任何用户都可以调用该函数：

SELECT * FROM pg_stat_kcache();
复制

它提供了以下列：

14.5 更新扩展

请注意，除了 SQL 对象之外的更改需要重新启动 PostgreSQL。大多数新代码将在重启完成后立即启用，无论扩展是否更新，因为扩展只负责在 SQL 中公开内部数据结构。

另请注意，当 set-returning 函数字段发生更改时，需要重新启动 PostgreSQL 才能加载新版本的扩展。在重新启动完成之前，更新扩展程序将失败，并显示类似于以下内容的消息：

在文件 …/pg_stat_kcache.so 中找不到函数“pg_stat_kcache_2_2”

14.6 BUG 和限制

没有已知的BUG。

跟踪规划器资源使用情况需要 PostgreSQL 13 或更高版本。

我们假设一个内核块是 512 字节。这对于 Linux 来说是正确的，但对于另一个 Unix 实现可能不是这样。

见：http://lkml.indiana.edu/hypermail/linux/kernel/0703.2/0937.html

在没有本机 getrusage(2) 的平台上，除 user_time 和 system_time 之外的所有字段都将为 NULL。

在具有本机 getrusage(2) 的平台上，某些字段可能不会被维护。这是一个依赖于平台的行为，请参阅您的平台 getrusage(2) 手册页以获取更多详细信息。

如果 pg_stat_kcache.track 是 all，则 pg_stat_kcache 跟踪嵌套语句。将跟踪的最大嵌套级别数限制为 64，以保持实现简单，但这对于合理的用例来说应该足够了。

即使 pg_stat_kcache.track 是 all，pg_stat_kcache 视图也只考虑顶级语句的统计信息。因此，即使规划嵌套语句的用户 cpu 时间很高，pg_stat_kcache 视图的 plan_user_time 也很小。在这种情况下，用于规划嵌套语句的用户 cpu 时间计入 exec_user_time。

14.7 作者

pg_stat_kcache 是 Thomas Reiss 的原创开发，大部分代码灵感来自 pg_stat_plans。 Julien Rouhaud 也贡献了扩展的某些部分。

感谢 Peter Geoghegan 为 pg_stat_plans 提供了很多灵感，因此我们可以非常简单地编写这个扩展。

14.8 许可

pg_stat_kcache 是在 PostgreSQL 许可下分发的免费软件。

版权所有 © 2014-2017, Dalibo 版权所有 © 2018-2022, PoWA 团队