跳转到主要内容

pgtelemetry

监控数据库活动、WAL、复制与存储的 SQL 视图

概览

扩展包名版本分类许可证语言
pgtelemetry1.7STATPostgreSQLSQL
ID扩展名BinLibLoadCreateTrustReloc模式
6080pgtelemetry否否否是否否pgtelemetry

Pure SQL in the fixed pgtelemetry schema; requires pg_stat_statements and plpgsql. Preload pg_stat_statements, not pgtelemetry. Control/SQL are 1.7 while META.json still says 1.6.0; upstream CI stops at PG17, and PG14-18 are verified in PGSTY builds.

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY1.71817161514pgtelemetrypg_stat_statements, plpgsql
RPMPIGSTY1.71817161514pgtelemetry_$vpostgresql$v-contrib
DEBPIGSTY1.71817161514postgresql-$v-pgtelemetry-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
el9.x86_64
el9.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
el10.x86_64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
el10.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
d12.x86_64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
d12.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
d13.x86_64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
d13.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
u22.x86_64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
u22.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
u24.x86_64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
u24.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
u26.x86_64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
u26.aarch64
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7
PIGSTY 1.7

构建

您可以使用 pig build 命令构建 pgtelemetry 扩展的 RPM / DEB 包:

pig build pkg pgtelemetry         # 构建 RPM / DEB 包

安装

您可以直接安装 pgtelemetry 扩展包的预置二进制包,首先确保 PGDG 和 PIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

安装
pig install pgtelemetry;          # 当前活跃 PG 版本安装
pig
pig ext install -y pgtelemetry -v 18  # PG 18
pig ext install -y pgtelemetry -v 17  # PG 17
pig ext install -y pgtelemetry -v 16  # PG 16
pig ext install -y pgtelemetry -v 15  # PG 15
pig ext install -y pgtelemetry -v 14  # PG 14
dnf
dnf install -y pgtelemetry_18       # PG 18
dnf install -y pgtelemetry_17       # PG 17
dnf install -y pgtelemetry_16       # PG 16
dnf install -y pgtelemetry_15       # PG 15
dnf install -y pgtelemetry_14       # PG 14
apt
apt install -y postgresql-18-pgtelemetry   # PG 18
apt install -y postgresql-17-pgtelemetry   # PG 17
apt install -y postgresql-16-pgtelemetry   # PG 16
apt install -y postgresql-15-pgtelemetry   # PG 15
apt install -y postgresql-14-pgtelemetry   # PG 14

创建扩展:

CREATE EXTENSION pgtelemetry CASCADE;  -- 依赖: pg_stat_statements, plpgsql

用法

来源:

pgtelemetry 1.7 版是纯 SQL 监控集合。视图和函数汇总关系/数据库/表空间大小、连接和等待、锁、表访问和自动清理、pg_stat_statements 计时与缓冲区、WAL 速率、复制槽及备库延迟。

示例

先预加载并安装 pg_stat_statements,再把该扩展安装到固定的 pgtelemetry 模式:

CREATE EXTENSION pg_stat_statements;
CREATE EXTENSION pgtelemetry;
SELECT * FROM pgtelemetry.database_size;
SELECT * FROM pgtelemetry.connections_by_state;
SELECT * FROM pgtelemetry.longest_running_active_queries LIMIT 10;

安装仅限超级用户。若干对象会暴露集群范围的查询文本、客户端地址、大小、锁、复制状态和其他运维元数据;wal_telemetry() 还会维护历史表。只应向监控角色授予所需的具体视图/函数,保护导出的指标,为 WAL 样本设置保留策略,并考虑轮询成本和 PostgreSQL 版本间统计目录变化。

这个页面对您有帮助吗?