跳转到主要内容

发布注记

PG Exporter 版本发布历史

pg_exporter 的最新稳定版本是 v1.6.1

版本日期摘要GitHub
v1.6.12026-11-11修正表统计,隔离重复标量样本,修复连接处理,支持 systemd 重载,升级 Go 1.27.4v1.6.1
v1.6.02026-11-09独立健康探测、有界抓取、跨库进度标签与容器 CA 修正v1.6.0
v1.5.02026-10-23连接安全、自动发现、健康检查与复制指标修复,Go 1.27.3v1.5.0
v1.4.12026-07-29修复逻辑订阅计数与标签列校验,统一 RPM 包名v1.4.1
v1.4.02026-07-18快照直方图支持,新增 pg_xact_age 采集器,HTTP 路由加固v1.4.0
v1.3.02026-06-24PostgreSQL 19 支持,新增 PG19 采集器与分支v1.3.0
v1.2.22026-04-14例行更新到 Go 1.26.2,无功能改动v1.2.2
v1.2.12026-03-21配置样式统一,Go 1.26.1 更新v1.2.1
v1.2.02026-02-12热重载与非阻塞启动,新增 PG9.1-9.6 legacy 支持v1.2.0
v1.1.22026-01-16修复 pg_timeline 配置问题,使用最新依赖构建v1.1.2
v1.1.12025-12-30新增 pg_timeline 采集器,pg_sub_16 分支,Bug 修复v1.1.1
v1.1.02025-12-15更新默认指标采集器,升级到 Go 1.25.5v1.1.0
v1.0.32025-11-20例行更新到 1.25.4,修复不支持的 libpq 环境变量v1.0.3
v1.0.22025-08-14使用 goreleaser 构建更多操作系统架构v1.0.2
v1.0.12025-07-17DockerHub 镜像,Go 1.24.5,禁用 pg_tsdb_hypertablev1.0.1
v1.0.02025-05-06PostgreSQL 18 支持,新增 WAL/检查点/I/O 指标v1.0.0
v0.9.02025-04-26TimescaleDB、Citus、pg_wait_sampling 采集器v0.9.0
v0.8.12025-02-14依赖更新,Docker 镜像标签v0.8.1
v0.8.02025-02-14PgBouncer 1.24 支持,Go 1.24,日志重构v0.8.0
v0.7.12024-12-29例行更新,支持 Reader 配置v0.7.1
v0.7.02024-08-13PostgreSQL 17 支持,谓词查询功能v0.7.0
v0.6.02023-10-18PostgreSQL 16 支持,ARM64 包,安全修复v0.6.0
v0.5.02022-04-27RPM/DEB 构建,列缩放,指标增强v0.5.0
v0.4.12022-03-08采集器更新,connect-timeout 参数v0.4.1
v0.4.02021-07-12PostgreSQL 14 支持,自动发现功能v0.4.0
v0.3.22021-02-01Shadow DSN 修复,文档更新v0.3.2
v0.3.12020-12-04旧版 PostgreSQL 配置修复v0.3.1
v0.3.02020-10-29PostgreSQL 13 支持,REST API,虚拟服务器v0.3.0
v0.2.02020-03-21YUM 包,配置重载支持v0.2.0
v0.1.22020-02-20动态配置重载,批量模式v0.1.2
v0.1.12020-01-10启动挂起 Bug 修复v0.1.1
v0.1.02020-01-08首个稳定版本v0.1.0
v0.0.42019-12-20生产环境测试版本v0.0.4
v0.0.32019-12-14生产环境测试v0.0.3
v0.0.22019-12-09早期测试版本v0.0.2
v0.0.12019-12-06初始版本,支持 PgBouncer 模式v0.0.1

v1.6.1

发布日期:2026-11-11。

PG Exporter v1.6.1 是一次维护更新,修正表统计数值、可能影响整次抓取的采集器错误,以及连接处理的边界问题。构建工具链升级至 Go 1.27.4,PostgreSQL 驱动仍为 lib/pq 1.12.3。内置 SQL 指标名、标签键、类型、桶、命令行参数与 HTTP 路由不变。

修复与改进

  • 隔离重复标量行,避免整次抓取失败: 当 GAUGE 或 COUNTER 查询返回相同标签的多行数据时,在交给 Prometheus 汇总前将该采集器标记为失败并丢弃结果。非致命采集器失败后,其他采集器继续工作;fatal: true 保留原有失败语义。只有 HISTOGRAM 指标的采集器仍会将同标签多行观测合并为一个快照分布。不同采集器之间的指标冲突仍需通过配置解决。
  • 修正分区表与无索引表统计: pg_table 的全部四个版本分支均对 relfrozenxid = 0 的关系(包括分区父表)输出 age = 0,不再产生 2147483647。tbl_scan、tup_read 与 n_tup_mod 在相加前分别将空值补为零,避免空索引计数吞掉有效的顺序扫描统计;存活、死亡和修改行数估计的空值也改为零,不再输出 NaN。
  • 避免临时表导致表大小查询失败: pg_table_size 排除 pg_temp* 与 pg_toast* 模式,不再尝试读取其他会话的临时表或单独统计 TOAST 表。源码标签还纳入 PostgreSQL 9.1 legacy 配置中“无 TOAST 表触发 OID 0 错误”的修复,避免整组表大小指标缺失。legacy 配置仍需单独下载。
  • 修正活动耗时与 TimescaleDB 标识符: 当状态、事务或会话时间戳晚于查询时间基准时,pg_activity 将算出的负耗时截断为零。默认禁用的 pg_tsdb_hypertable 正确引用含大写字母或特殊字符的模式名和表名。同步校准事务/会话起点、索引构建阶段、检查点计数和表主数据分支大小的 HELP 文本。
  • 修复连接 URL 与日志脱敏: postgresql://?host=/var/run/postgresql 等省略主机的 URL 在规范化时保留 //,不再变成 lib/pq 无法识别的连接串。自动发现为子库指定库名时移除冲突的 service=;日志也会遮盖 sslpassword= 参数值。
  • 完善连接池回收: 自动发现移除或替换子库目标后,等待活跃采集结束再关闭旧连接池;关闭时同步清空池引用,允许安全处理尚未初始化或已经关闭的池。配置重载仍复用现有连接池并清空采集计划,不会重建全部子库连接。
  • 加强配置校验与内置指标保护: 配置加载拒绝非有限的 scale 与 default,启动时拒绝非法 --namespace。内置指标遇到无效标签(如非 UTF-8 数据库名)时记录警告并跳过该样本,避免 panic。用户固定标签不能覆盖 version、revision 等构建信息保留字段。
  • 修复诊断页与直接调用的边界行为: HTML explain 页面能正确显示谓词缓存 TTL。直接调用采集器时,即使尚无服务器抓取时间戳,冷缓存或 TTL 为零也会执行查询。显式调用 Server.Plan(...) 时按分支键保留同名的不同版本查询。
  • 更新构建与服务管理: 软件包的 systemd 单元新增 ExecReload,支持 systemctl reload pg_exporter。独立 Docker 构建可接收版本、分支、提交与构建日期参数,make docker-build 会传入这些信息;普通 Docker 构建若未传参,提交和日期仍为 HEAD/unknown。工具链升级到 Go 1.27.4,并例行更新依赖。

升级注意事项

  1. 升级二进制并合并采集器 YAML。 软件包会保留本地修改的 /etc/pg_exporter.yml 与 /etc/default/pg_exporter;只有部署新版 SQL,才能获得表统计、活动耗时和 TimescaleDB 修复。默认配置仍包含 58 个 YAML 文件、96 个分支、59 个命名空间与 460 个去重指标定义。
  2. 检查自定义采集器。 标量查询须为每组标签返回一行,scale 与 default 必须是有限数;只有直方图指标的查询仍可为同一组标签返回多条观测。分区父表的冻结年龄现在为零,无索引表汇总值及原先为 NaN 的行数估计也可能变化。
  3. 更新服务单元,升级二进制后重启。 安装新版 systemd 单元后执行 sudo systemctl daemon-reload;用 sudo systemctl restart pg_exporter 启用新二进制或进程参数。以后只改采集器 YAML 时,可执行 sudo systemctl reload pg_exporter 或 POST /reload。
  4. PostgreSQL 9.1–9.6 单独下载 legacy YAML。 使用 v1.6.1 标签中的配置,或 main 上 282e19d 及之后的版本。二进制压缩包与 RPM/DEB 仍只附带面向 PostgreSQL 10+ 的默认配置。

从 v1.5.0 或更早版本跨版本升级时,还应查阅 v1.6.0 发布说明 中的健康探测、抓取预算和跨库进度标签变化,以及 v1.5.0 发布说明 中的订阅标签、接收器状态与 PostgreSQL 10–13 授权要求。完整迁移表见 指标兼容性。

验证范围

v1.6.1 标签指向 d0dead1。CI 与 Release 工作流通过模块和生成配置检查、完整 race 测试、Go 1.21 HTTP mux 兼容测试、go vet、六目标交叉编译、容器检查、软件包与校验和检查。新增回归覆盖重复标量行隔离、直接采集的冷缓存/零 TTL、命名空间和构建信息校验、无主机 URL、移除 service=、sslpassword 脱敏、谓词 HTML 渲染、有限数值配置及采集 SQL 不变量。

发布验收记录覆盖 12 个公开制品与校验和、amd64/arm64 Docker 镜像、Debian 12 的 ARM64 DEB 与 Rocky Linux 9 的 ARM64 RPM 安装,以及非超级用户在 PostgreSQL 10–18 和 19 RC1 主库、PostgreSQL 18 和 19 RC1 流复制备库、PgBouncer 1.26.1 和配合独立 legacy 配置的 PostgreSQL 9.1–9.6 上的真实抓取。场景包括自动发现与数据库移除、HTTP/SIGHUP 重载、pg_stat_statements、无索引表、分区表、临时表和活跃事务。legacy 验收不表示已回移现代配置的 pg_temp* 过滤和 COALESCE 修正。Windows、Linux ppc64le 与 Intel macOS 仅覆盖构建和校验和,软件包容器检查也不代表真实 systemd 启动验收。PostgreSQL 19 的证据限于 RC1,不代表全部后续构建或生产负载。实验性的 snort 组件不包含在 v1.6.1 中。

SHA-256 校验和

SHA256 校验和

下载资产
文件校验和
pg-exporter-1.6.1-1.aarch64.rpm Linuxarm64SHA-256d0612ad9…0277
pg-exporter-1.6.1-1.ppc64le.rpm LinuxSHA-25673fe4587…b9b5
pg-exporter-1.6.1-1.x86_64.rpm Linuxamd64SHA-256c20c8a80…2c82
pg-exporter_1.6.1-1_amd64.deb Linuxamd64SHA-2560d6fe86a…e5fc
pg-exporter_1.6.1-1_arm64.deb Linuxarm64SHA-256a055f9a7…2ab4
pg-exporter_1.6.1-1_ppc64le.deb LinuxSHA-256f8500d01…8d4c
pg_exporter-1.6.1.darwin-amd64.tar.gz macOSamd64SHA-256496c42f3…2774
pg_exporter-1.6.1.darwin-arm64.tar.gz macOSarm64SHA-2569ace0b48…c662
pg_exporter-1.6.1.linux-amd64.tar.gz Linuxamd64SHA-256e8fdf64c…1fdf
pg_exporter-1.6.1.linux-arm64.tar.gz Linuxarm64SHA-25691da5400…333b
pg_exporter-1.6.1.linux-ppc64le.tar.gz LinuxSHA-256769e9e56…a5fb
pg_exporter-1.6.1.windows-amd64.tar.gz Windowsamd64SHA-2560e118a98…1066

GitHub 发布 · SHA256 校验和 · 完整变更 · 完整采集器文档

v1.6.0

发布日期:2026-11-09。

PG Exporter v1.6.0 将健康探测与指标采集解耦,限制并发抓取与等待,保留客户端离开后已完成的有界刷新,并修正跨数据库进度标签。同时补齐容器信任根并更新依赖。构建工具链仍为 Go 1.27.3,PostgreSQL 驱动仍为 lib/pq 1.12.3。

修复与改进

  • 健康探测独立运行: 慢指标采集不再阻塞后台探测,采集完成不再覆盖更新的连通性或角色观测。初始化后,HTTP 健康状态只由探测写入;pg_up 和 pg_in_recovery 仍反映采集结果。数据库可达时,即使 fatal 采集器使 pg_up 为 0,/up 仍可返回 HTTP 200。
  • 限制重叠抓取: 采集、等待和响应写入合计最多接纳两个指标请求。采集仍串行,第二个请求可以等待并复用缓存,更多请求返回 HTTP 503。等待可取消且不执行 SQL。请求预算为 30 秒,合法、有限且为正数的 Prometheus 抓取超时请求头可缩短它。
  • 按采集器取消: 请求取消后不再启动下一个采集器或数据库。已经运行且 timeout 为正数的采集器,在同一期限内继续执行谓词链与主 SQL,然后正常缓存结果,避免一个客户端离开导致其他抓取者共享失败缓存。负数 timeout 关闭采集器期限,此时 SQL 随请求取消。
  • 区分中断与目标错误: 中断轮次的汇总日志为 INFO interrupted,不增加 exporter/server 抓取错误计数。可用状态保留之前的值;本轮预检成功后视为 true。未中断的连接失败和 fatal 采集失败仍计数。查询级错误计数与 fatal 查询的 ERROR 日志保持原有行为。
  • 修正进度标签: pg_vacuuming、pg_indexing、pg_clustering 保持集群级覆盖,每次刷新仍只执行三条查询。当前连接库与系统目录的关系解析为名称,其他库的用户关系在 relname 中使用数字 OID,并保留 datname、pid,避免误用本地同 OID 对象名称。自动发现过滤或缺少 CONNECT 权限不会滤除进度视图中可见的行。
  • 补齐容器信任: 两条 scratch 镜像构建路径均包含系统 CA 证书包与许可证,公共 CA 校验可以使用内置信任库。私有 CA 仍需显式挂载并设置 sslrootcert;默认 TLS 模式不变。
  • 更新依赖与发布检查: YAML 从 v3 升到 v4,保持既有采集器配置语法;更新 Prometheus common/procfs、golang.org/x/net 等依赖。CI 在 RPM 兼容性与校验和检查之外,验证容器文件/TLS 行为并检查三个 DEB 架构。
  • 校准帮助文本: 区分 I/O 字节与操作次数、已完成检查点、VACUUM 死元组内存和 CLUSTER 进度。在相同 PostgreSQL 版本上,SQL 指标名、标签键、类型与单位不变。

升级注意事项

  1. 同时升级配置与二进制。 合并新版 pg_exporter.yml 或拆分 YAML,软件包升级会保留本地配置。只替换程序不会修正进度 SQL。默认配置仍包含 58 个 YAML 文件、96 个分支、59 个命名空间和 460 个去重指标定义,含默认禁用的采集器与两个未展开直方图。
  2. 检查进度标签的使用者。 跨库 relname 可能从错误名称变为 OID,产生新的时序;面板应保留数据库与任务身份。当前库与系统目录的关系名称仍可读。
  3. 按目的选择健康信号。 /up 和角色端点反映最近一次健康探测;pg_up 反映主目标采集,包括 fatal 失败。非 fatal 与子数据库错误需查看查询/服务器指标。--disable-intro 会隐藏全部内置指标,包括 pg_up,但保留 HTTP 健康检查。
  4. 为 PgBouncer 探测预留连接。 PgBouncer 主连接池上限由一个增至两个。PostgreSQL 保持主目标三个连接,每个发现数据库一个连接。
  5. fatal 采集器保留正数 timeout。 取消负数 timeout 的 fatal 查询会按正常 TTL 缓存失败。后续有效抓取可能对该缓存失败计数,并返回 pg_up 0,直到成功刷新。TTL 为零或 --disable-cache 仍强制每次抓取刷新。
  6. 检查并发与预算。 超额请求或中断采集可以返回 503。已经开始的有界采集器可能超出请求预算,通常最多再占用自身 timeout;网络阻塞可能更久,二者都不是硬性的墙钟上限。建连握手需配置合适的 DSN connect_timeout。

真实失败恰好与请求取消重叠时,可能不计入两个轮次错误计数,因为分类同时检查采集错误与请求 context;查询级失败仍可见。首次抓取在预检成功前中断时,pg_up 保持为 0,直到后续恢复。失败 TTL、重载和 SIGTERM 直接退出行为不变,本版本不增加后台刷新或优雅关闭。

从 v1.4.1 或更早版本升级时,仍需遵循 v1.5.0 迁移说明,包括订阅标签、接收器状态映射和 PostgreSQL 10–13 监控授权。完整运行契约见 指标兼容性、HTTP API 与 采集生命周期。

验证范围

发布验证覆盖完整 race 测试、两种 HTTP mux、模块与生成配置一致性、静态检查、六平台构建、容器 TLS/文件校验和软件包验证。三个取消回归用例还在 race 检测下连续 200 轮通过;此前移除中断修复的反向对照失败。PostgreSQL 18.6 上,客户端在 0.8 秒有界 fatal 查询期间离开,两个轮次错误计数保持为 0;下一次抓取返回 pg_up 1 与缓存指标,没有重跑 SQL。

对实际发布制品的本地验收还覆盖 PostgreSQL 9.2–9.6(legacy 配置)、10–18 与 19 RC1(默认配置),以及 PgBouncer 1.26.1。Linux amd64/arm64/ppc64le 压缩包及 RPM/DEB 通过运行与安装检查;ARM64 软件包从 1.5.0 升级后保留本地配置。Docker Hub 上的 1.6.0 与 latest 标签已指向同一份 amd64/arm64 多架构清单;两个公开镜像拉取后通过 CA、文件内容与 TLS 校验,其二进制与对应发布压缩包逐字节一致。Darwin ARM64 的 24 组功能测试通过,覆盖 HTTPS 认证、重载重叠、备库晋升和断连恢复。Windows 与 Intel macOS 仅做静态检查;容器内的软件包测试未验证真实 systemd 启动。

进度 SQL 分支已使用监控角色在 PostgreSQL 12、17、18 上验证;系统目录补充场景与真实跨库 VACUUM 在 18.6 上验证。这些是限定场景的验收结果,不是对全部 PostgreSQL 版本、扩展、仪表盘和生产负载重新完成的完整审计。Composite、Patroni、pgBackRest 与 PostgreSQL 日志组件仍在独立的 snort 开发线上,不包含在 v1.6.0 中。

SHA-256 校验和

SHA256 校验和

下载资产
文件校验和
pg-exporter-1.6.0-1.aarch64.rpm Linuxarm64SHA-256dd81e485…1ed9
pg-exporter-1.6.0-1.ppc64le.rpm LinuxSHA-256413f64b2…48ae
pg-exporter-1.6.0-1.x86_64.rpm Linuxamd64SHA-256c25e5707…c64a
pg-exporter_1.6.0-1_amd64.deb Linuxamd64SHA-25646f03078…17b3
pg-exporter_1.6.0-1_arm64.deb Linuxarm64SHA-256d24dea8e…2a0f
pg-exporter_1.6.0-1_ppc64le.deb LinuxSHA-2565cc839bc…3ae0
pg_exporter-1.6.0.darwin-amd64.tar.gz macOSamd64SHA-256ddefa112…ea47
pg_exporter-1.6.0.darwin-arm64.tar.gz macOSarm64SHA-256a62d9474…4d85
pg_exporter-1.6.0.linux-amd64.tar.gz Linuxamd64SHA-256296a26bf…719a
pg_exporter-1.6.0.linux-arm64.tar.gz Linuxarm64SHA-256ea6d1dbe…7ce7
pg_exporter-1.6.0.linux-ppc64le.tar.gz LinuxSHA-256b720183a…155a
pg_exporter-1.6.0.windows-amd64.tar.gz Windowsamd64SHA-25629909ef6…bb25

GitHub 发布 · SHA256 校验和 · 完整变更 · 完整采集器文档

v1.5.0

发布日期:2026-10-23。此版本聚焦连接安全、采集准确性和运行状态一致性,构建工具链升级到 Go 1.27.3。

修复与改进

  • 严格校验 PostgreSQL URL 与查询参数,拒绝错误转义和含空白、= 的参数名。安全诊断避免把错误连接串中的密码写入日志,也避免显式 TLS 设置在规范化时被静默丢弃。选用 PG_EXPORTER_URL_FILE 后,空文件或只含空白的文件会使启动失败。
  • 自动发现复用 lib/pq 的数据库身份解析;替换数据库名时移除冲突的 dbname / database 参数并保留特殊字符,修复重复采集同一数据库及重复指标导致的 HTTP 500。
  • 健康检查从同一个原子状态生成 HTTP 状态码与正文,修复并发切换时的矛盾响应;仍使用后台缓存状态。
  • 成功预检后,用户名、Schema 或扩展集合变化会触发重新规划;没有变化时保留计划和缓存。安装或删除扩展、Schema 后无需手动重载。
  • 配置加载拒绝 NaN、无穷大以及溢出的 TTL/正超时;保留 TTL 为 0 禁用缓存、超时为 0 使用默认值、有限负超时关闭期限的既有语义。
  • 启动时确认指标路径在实际 HTTP mux 下命中指标处理器,拒绝旧版 mux 中返回首页或重定向的不可达转义路径。
  • 为 pg_sub_* 新增订阅所属数据库的 datname 标签,避免跨数据库同名订阅冲突。修正当前与 legacy 配置的 pg_recv_state 状态编码,以及 PG9.6 receiver 地址提取 SQL。
  • 校准 pg_origin 的权限说明、pg_pubrel_count 的表计数范围、pg_subrel_count 的同步状态和 PG19 序列语义,以及 pg_backend 的描述。

指标、仪表盘与告警兼容性

与同一 PostgreSQL 版本上的 v1.4.1 相比,v1.5.0 没有新增、删除或改名内置 SQL 指标。类型和单位不变,但标签与状态映射有变化。PostgreSQL 19 支持最早随 v1.3.0 发布;升级数据库还可能改变所选 SQL 分支与指标含义。

变化来源指标兼容性处理
v1.5.0 配置pg_sub_*每条样本增加 datname。连接与聚合时保留数据库和订阅身份;新标签集会产生新时序。
v1.5.0 配置pg_recv_state真实接收器状态 starting、waiting、restarting、stopped 从 -1 改为 6–9。更新值映射和状态告警;编码 1–3 保留。
PG18 → PG19PG18 已有的指标名本配置的 PG19 分支没有删除或改名这些指标;这不保证 PostgreSQL 自身提供的语义和标签取值不变。
PG19pg_sub_sync_error_count名称保留,值变为表与序列同步错误之和。只监控表同步时用 pg_sub_sync_table_error_count,序列分量由 pg_sub_sync_seq_error_count 提供。不要把分量和总和重复相加。
PG19pg_sub_has_worker、pg_sub_reset_time、pg_sub_confl_*新增 worker 存在标记、重置时间与八个冲突计数器。没有 apply worker 时仍可能保留订阅行,不能仅凭指标存在判断 worker 健康。
PG19pg_subrel_count同时包含表和序列;pg_pubrel_count 仍只统计表。检查面板名称与数量比较规则。
PG19pg_wal_fpi_bytes、pg_lock_stat_*、pg_recovery_state_*、pg_vacuum_score_*属于新增指标。恢复状态仅用于备库,自动清理评分仅用于主库;原有 WAL、锁分布和恢复指标族保留。

从 PG17 或更早版本升级的用户还需迁移旧名:检查点指标自 PG17 起移出 pg_bgwriter_*,而 pg_wal_write、pg_wal_sync、pg_wal_write_time、pg_wal_sync_time 自 PG18 起不再输出。完整兼容性指南 逐项列出替代指标、标签/聚合差异与混合版本 PromQL。

部署前应执行实际仪表盘和告警表达式,并测试时序缺失的情况。抓取成功不代表所有预期指标都存在;告警表达式返回空结果时可能静默失效。缺失指标检查 提供逐目标规则,并说明哪些缺失属于正常情况。PG19 指标对照表 链接到发布标签中的精确定义;PostgreSQL 验证范围仍为 19 RC1。

升级注意事项

  • PG10–13 必须由管理员在 Exporter 的 主连接数据库 中执行 GRANT SELECT (oid) ON pg_catalog.pg_subscription TO monitor;,将 monitor 替换为实际监控用户。该授权不开放 subconninfo;PG14+ 标准目录 ACL 下无需额外授权。
  • pg_sub_* 新增标签会建立新时序。检查依赖该指标标签匹配的 PromQL 连接、聚合与告警;pg_sub_id gauge 保留。
  • pg_recv_state 使用下表;1–3 保留不用。没有 receiver 行时不输出样本。PG9.6 对普通监控用户隐藏的详情仍表现为未知状态,不扩大数据库权限。
状态编码状态编码
streaming0starting6
stopping4waiting7
connecting(PG19+)5restarting8
未知/NULL-1stopped9
  • 同时升级二进制与采集器配置。软件包会保留本地配置修改,升级后应合并新版 pg_exporter.yml,再检查 /metrics 的查询错误计数,不能只看 HTTP 200。
  • 空 YAML 重载仍会清空采集器;目录加载仍允许部分有效文件生效。SIGTERM 沿用直接退出行为,不等待活跃抓取结束。

工具链与验证

保留 lib/pq 1.12.3,升级 Prometheus client_golang 至 1.25.0、common 至 0.72.1、exporter-toolkit 至 0.20.0;YAML 使用 go.yaml.in/yaml/v3 3.0.5。PostgreSQL 驱动仍为 lib/pq。

默认配置仍包含 58 个 YAML 文件、96 个分支、59 个命名空间和 460 个去重后的指标定义(含 2 个未展开直方图)。已验证非超级用户运行 PG9.1–9.6、10–18、19 RC1 与 PgBouncer 1.26.1;另验证物理备库晋升、重载、断连恢复、竞态、新旧 HTTP mux、六平台构建、ARM64 RPM/DEB 安装及 Docker 镜像。PG19 验证对象为 RC1,不代表所有扩展或生产负载已经验证。

Go 与依赖的安全更新

Go 1.27.3 在 crypto/x509 中加入不可信中间证书拒绝列表,修复 CVE-2026-111943。它也包含从旧构建工具链 Go 1.26.5 升级所跨越的安全修复,包括 TLS 的 CVE-2026-56862、CVE-2026-97031,HTTP 的 CVE-2026-56853、CVE-2026-94439,以及模板、ASN.1、multipart 等修复。完整上游范围见 Go 1.26.6、Go 1.27.2 和 Go 1.27.3 公告。

golang.org/x/net 从 0.57.0 升至 0.61.0,包含 0.60.0 的五项 HTTP/2 修复:

CVE修复内容
CVE-2026-78659Trailer 头导致的内存放大
CVE-2026-78669窗口更新导致的 CPU 消耗
CVE-2026-78663重复返还流控额度
CVE-2026-97032HPACK 编码器竞态崩溃
CVE-2026-78660畸形 framing 响应头

x/crypto 0.58.0 也跨过 SSH CVE-2026-56854、CVE-2026-56855、CVE-2026-78662 的修复版本;x/text 0.43.0 包含 precis CVE-2026-56851 的修复。本程序未导入这些 SSH/precis 包,这些是依赖版本层面的更新,不能写成已证实的 exporter 运行时漏洞。

2026-10-23 的 govulncheck 对照核验中,新候选在 Darwin、Linux、Windows 目标均无符号级或已导入包级已知漏洞;仅保留未导入的 OpenPGP 包 GO-2026-5932 的模块级提示。静态符号匹配不等于攻击复现,上述修复也不表示每项漏洞都可在 exporter 中利用。其他依赖升级按维护更新处理。应更新重新构建的发行二进制;只更新主机上的 Go 不会改变旧二进制。

完整逐项 CVE、首个修复版本与扫描层级见 安全更新核验表。

SHA-256 校验和

SHA256 校验和

下载资产
文件校验和
pg-exporter-1.5.0-1.aarch64.rpm Linuxarm64SHA-2564cb1dfbb…b980
pg-exporter-1.5.0-1.ppc64le.rpm LinuxSHA-256c7efed8a…f7eb
pg-exporter-1.5.0-1.x86_64.rpm Linuxamd64SHA-2566788c7cb…e1b3
pg-exporter_1.5.0-1_amd64.deb Linuxamd64SHA-25691f705bb…e28f
pg-exporter_1.5.0-1_arm64.deb Linuxarm64SHA-25675dd27cd…47bd
pg-exporter_1.5.0-1_ppc64le.deb LinuxSHA-256f41acf76…faf1
pg_exporter-1.5.0.darwin-amd64.tar.gz macOSamd64SHA-256f3e5d03d…6975
pg_exporter-1.5.0.darwin-arm64.tar.gz macOSarm64SHA-2563fb47e28…0e8d
pg_exporter-1.5.0.linux-amd64.tar.gz Linuxamd64SHA-256e372f6de…ef56
pg_exporter-1.5.0.linux-arm64.tar.gz Linuxarm64SHA-25619f34db9…1cde
pg_exporter-1.5.0.linux-ppc64le.tar.gz LinuxSHA-256aef7e910…5ac2
pg_exporter-1.5.0.windows-amd64.tar.gz Windowsamd64SHA-256cf39b3ec…1d9f

GitHub 发布 · SHA256 校验和 · 完整变更 · 完整采集器文档

v1.4.1

v1.4.1 是一次聚焦监控准确性与 RPM 升级兼容性的维护版本。

变更摘要:

  • 修复 pg_subrel_count 在并行逻辑复制工作进程场景下重复计数的问题:先按订阅 ID 与名称去重 pg_stat_subscription,再汇总各订阅关系状态
  • 查询结果缺少配置声明的 LABEL 列时,该采集器本轮采集会整体失败,不再生成空标签或沿用旧结果;其他非致命采集器仍会继续工作
  • 官方 RPM 包名及产物文件名前缀由 pg_exporter 统一为 pg-exporter;新包声明兼容并替换旧包名,可直接升级
  • 更新版本与独立安装包元数据,增加缺失标签列的回归测试,并在 CI 中校验 RPM 配置、产物名称及兼容元数据

升级提示:

  • 自定义采集器的 SQL 必须返回全部 LABEL 列;即使结果为零行,返回结果的列定义也必须完整
  • 若脚本直接匹配 GitHub RPM 文件名,请将 pg_exporter-*.rpm 更新为 pg-exporter-*.rpm

校验和

https://github.com/pgsty/pg_exporter/releases/download/v1.4.1/checksums.txt

下载资产
文件校验和
pg-exporter-1.4.1-1.aarch64.rpm Linuxarm64SHA-2567648f185…2f13
pg-exporter-1.4.1-1.ppc64le.rpm LinuxSHA-25609037731…6631
pg-exporter-1.4.1-1.x86_64.rpm Linuxamd64SHA-2568dbf85ff…1a93
pg-exporter_1.4.1-1_amd64.deb Linuxamd64SHA-256cbe06eb1…1f38
pg-exporter_1.4.1-1_arm64.deb Linuxarm64SHA-25636bc07ef…5cff
pg-exporter_1.4.1-1_ppc64le.deb LinuxSHA-2568228e6a9…7aad
pg_exporter-1.4.1.darwin-amd64.tar.gz macOSamd64SHA-256e6de4c89…76f4
pg_exporter-1.4.1.darwin-arm64.tar.gz macOSarm64SHA-2566fe0b193…a79f
pg_exporter-1.4.1.linux-amd64.tar.gz Linuxamd64SHA-256f2f952db…a340
pg_exporter-1.4.1.linux-arm64.tar.gz Linuxarm64SHA-256e111974a…e8b4
pg_exporter-1.4.1.linux-ppc64le.tar.gz LinuxSHA-2567b8679de…4469
pg_exporter-1.4.1.windows-amd64.tar.gz Windowsamd64SHA-25693c0231f…1db4

https://github.com/pgsty/pg_exporter/releases/tag/v1.4.1

v1.4.0

v1.4.0 引入快照直方图(Snapshot Histogram)指标类型与新的 pg_xact_age 事务年龄采集器,并对 HTTP 路由、打包与构建链进行了一轮系统性加固。

新功能:

  • 新增 HISTOGRAM 列类型:SQL 查询快照可按标签组直接聚合为经典 Prometheus 直方图,派生 _bucket / _count / _sum 三族序列;桶边界在配置加载阶段严格校验(有限、严格递增,自动追加 +Inf),le 成为保留标签,热重载安全
  • 新增 pg_xact_age 采集器:以直方图暴露开放事务年龄(pg_xact_age_seconds)与事务中空闲年龄(pg_xact_age_idle_seconds)的分布,集群级采集,仅统计客户端后端,TTL 10 秒
  • 默认配置包从 57 个定义文件增加到 58 个;pg_xact_age 编号 0450,原 pg_lock / pg_lock_stat / pg_query 顺延为 0460 / 0470 / 0480(内容不变)

修复与改进:

  • HTTP 路由注册隔离到私有 ServeMux,不再使用全局 DefaultServeMux,杜绝第三方库注册的端点被意外暴露
  • --web.telemetry-path 启动时严格校验:空路径、不以 / 开头、含 ? # { }、与内置端点冲突、以及 //metrics 这类注册后永远无法命中的非规范路径,一律启动即报错退出
  • 落地页对 telemetry path 进行 HTML 转义
  • --fail-fast 预检失败退出时正确关闭主连接池
  • RPM / DEB 打包修复(#105):prometheus 系统用户 HOME 指向 /var/lib/prometheus(libpq 查找 ~/.pgpass 的惯例位置),打包默认连接串补上 /postgres 数据库名,避免回退到以用户名命名的库
  • 版本串统一为 v 前缀:官方发布二进制的 --version 输出、/version 端点与 pg_exporter_build_info{version=...} 标签现在为 v1.4.0(此前 GoReleaser 产物为无前缀的 1.3.0);产物文件名、包版本号与 Docker 镜像 tag 命名规则不变
  • 直方图值转换与标量路径语义对齐:时间戳与布尔列不应用 scale 缩放
  • 修正 GoReleaser 内嵌包元数据:支持范围描述更新为 PostgreSQL 9.x - 19+ 与 pgBouncer 1.8 - 1.25+
  • make docker 恢复 GOPROXY / GOSUMDB 构建参数透传

工程与构建:

  • 构建链更新到 Go 1.26.5、exporter-toolkit v0.17.1、prometheus/common v0.70.0
  • 新增常规 CI 验证工作流:模块 tidy 校验、生成配置漂移校验(make conf 结果与 config/*.yml 强一致)、race 测试与六平台交叉编译
  • Docker 构建工具链整合:移除 docker/ 目录脚本与 make docker-release,多架构发布镜像统一由 GoReleaser 构建
  • 配置覆盖测试泛化:测试不再假设特定采集器必然存在于配置目录中,便于裁剪自定义配置包

升级提示:

  • 若此前使用了非规范的 telemetry path(如 //metrics),升级后进程将拒绝启动——此前虽能启动,但指标端点实际上不可达
  • 解析 pg_exporter_build_info 的 version 标签或 --version 输出的自动化脚本,需要适配 v 前缀
  • 配置了 HISTOGRAM 采集器时,le 不可再用作常量标签

校验和

下载资产
文件校验和
pg-exporter_1.4.0-1_amd64.deb Linuxamd64SHA-256c6af4ae6…a724
pg-exporter_1.4.0-1_arm64.deb Linuxarm64SHA-256ff0360f6…40d6
pg-exporter_1.4.0-1_ppc64le.deb LinuxSHA-2564fbadd4e…68a1
pg_exporter-1.4.0-1.aarch64.rpm Linuxarm64SHA-2565ce106d2…43fd
pg_exporter-1.4.0-1.ppc64le.rpm LinuxSHA-256870b434e…0600
pg_exporter-1.4.0-1.x86_64.rpm Linuxamd64SHA-256c550d16c…8488
pg_exporter-1.4.0.darwin-amd64.tar.gz macOSamd64SHA-25611a34e53…6749
pg_exporter-1.4.0.darwin-arm64.tar.gz macOSarm64SHA-25649d8d3a5…e26e
pg_exporter-1.4.0.linux-amd64.tar.gz Linuxamd64SHA-256113dfe70…333b
pg_exporter-1.4.0.linux-arm64.tar.gz Linuxarm64SHA-25668b4630a…2e18
pg_exporter-1.4.0.linux-ppc64le.tar.gz LinuxSHA-25672710625…0979
pg_exporter-1.4.0.windows-amd64.tar.gz Windowsamd64SHA-25614a0cf6f…db0b

https://github.com/pgsty/pg_exporter/releases/tag/v1.4.0

v1.3.0

v1.3.0 提供对 PostgreSQL 19 新指标的支持,同时刷新默认采集器包、构建链和配置覆盖测试。

变更摘要:

  • 默认支持范围从 PostgreSQL 10-18+ 扩展到 10-19+
  • 默认配置包包含 57 个 config/*.yml 定义文件
  • 构建依赖更新到 Go 1.26.4、lib/pq v1.12.3、Prometheus client v1.23.2、exporter-toolkit v0.16.0。
  • pg_recovery_state:在恢复节点上采集 pg_stat_recovery,暴露提升触发、回放 LSN、时间线、恢复事务时间与暂停状态。
  • pg_lock_stat:采集 PG19 pg_stat_lock,按 locktype 暴露等待次数、等待时间和 fast-path 溢出次数。
  • pg_vacuum_score:采集 pg_stat_autovacuum_scores 当前数据库摘要,暴露最大 autovacuum 分数和候选表数量。
  • pg_wal_19:在 PG19 上暴露 wal_fpi_bytes,指标名为 pg_wal_fpi_bytes。
  • pg_sub_19:基于 pg_stat_subscription_stats 适配序列同步与逻辑复制冲突统计,继续提供兼容旧仪表盘的 sync_error_count。
  • pg_recv:PG13+ WAL receiver 分支识别 PG19 connecting 状态。
  • pg_slot:识别 PG19 replication slot idle_timeout 失效原因。
  • pg_db_confl:改为显式列清单,避免未来视图新增列被意外导出。
  • pg_backup、pg_vacuuming、pg_clustering 继续复用现有稳定分支,避免为低价值 PG19 字段改变已有指标面。

校验和

下载资产
文件校验和
pg-exporter_1.3.0-1_amd64.deb Linuxamd64SHA-256dfc6d517…5569
pg-exporter_1.3.0-1_arm64.deb Linuxarm64SHA-2563d2ff642…8092
pg-exporter_1.3.0-1_ppc64le.deb LinuxSHA-2564cfe043e…6b5a
pg_exporter-1.3.0-1.aarch64.rpm Linuxarm64SHA-2563ae4f8c5…6faf
pg_exporter-1.3.0-1.ppc64le.rpm LinuxSHA-25671a00233…26ec
pg_exporter-1.3.0-1.x86_64.rpm Linuxamd64SHA-256316a97cc…2496
pg_exporter-1.3.0.darwin-amd64.tar.gz macOSamd64SHA-2564ab312f2…4ccd
pg_exporter-1.3.0.darwin-arm64.tar.gz macOSarm64SHA-2562b20eb7b…d6bb
pg_exporter-1.3.0.linux-amd64.tar.gz Linuxamd64SHA-2567a2a8ce8…3ad7
pg_exporter-1.3.0.linux-arm64.tar.gz Linuxarm64SHA-256696619d1…066d
pg_exporter-1.3.0.linux-ppc64le.tar.gz LinuxSHA-2560c16ac4a…475e
pg_exporter-1.3.0.windows-amd64.tar.gz Windowsamd64SHA-256aa3724f4…b10d

https://github.com/pgsty/pg_exporter/releases/tag/v1.3.0

v1.2.2

v1.2.2 是一次例行维护发布,仅将发布构建链更新到 Go 1.26.2,未引入新的采集器、配置语义或运行时行为变更。

变更摘要:

  • 刷新构建链:发布流程更新到 Go 1.26.2
  • 无功能改动:未调整采集器、默认配置、指标定义或运行时行为

校验和

下载资产
文件校验和
pg-exporter_1.2.2-1_amd64.deb Linuxamd64SHA-256273dfd45…dcc6
pg-exporter_1.2.2-1_arm64.deb Linuxarm64SHA-2565e83c844…7f40
pg-exporter_1.2.2-1_ppc64le.deb LinuxSHA-25697bb804b…a3b2
pg_exporter-1.2.2-1.aarch64.rpm Linuxarm64SHA-256b2f76799…0120
pg_exporter-1.2.2-1.ppc64le.rpm LinuxSHA-256f0ab3890…87e6
pg_exporter-1.2.2-1.x86_64.rpm Linuxamd64SHA-2562000593d…c800
pg_exporter-1.2.2.darwin-amd64.tar.gz macOSamd64SHA-256e8a71704…0386
pg_exporter-1.2.2.darwin-arm64.tar.gz macOSarm64SHA-256e648d944…ec9c
pg_exporter-1.2.2.linux-amd64.tar.gz Linuxamd64SHA-256f278aba9…9ede
pg_exporter-1.2.2.linux-arm64.tar.gz Linuxarm64SHA-256bbeef564…0801
pg_exporter-1.2.2.linux-ppc64le.tar.gz LinuxSHA-256ad238527…dbe2
pg_exporter-1.2.2.windows-amd64.tar.gz Windowsamd64SHA-2562ac53298…caf4

https://github.com/pgsty/pg_exporter/releases/tag/v1.2.2

v1.2.1

v1.2.1 是一次轻量维护版本,重点放在发布工程、配置包一致性与文档/元数据刷新上,不引入新的采集器语义或运行时行为变更。

变更摘要:

  • 刷新构建链:发布流程与 Docker 构建基础镜像升级到 Go 1.26.1
  • 统一配置样式:将当前配置与 Legacy 配置中的内联 description 统一改为双引号写法,并重新生成合并后的 pg_exporter.yml / legacy/pg_exporter.yml
  • 增加配置一致性测试:新增 split/merged config 等价性校验,以及内联指标描述风格检查,减少配置漂移风险
  • 刷新打包元数据:RPM / DEB 描述中的支持范围更新为 PostgreSQL 9.x - 18+ 与 pgBouncer 1.8 - 1.25+,并更新 Pigsty 文档入口链接

校验和

下载资产
文件校验和
pg-exporter_1.2.1-1_amd64.deb Linuxamd64SHA-2562cbe7a78…4649
pg-exporter_1.2.1-1_arm64.deb Linuxarm64SHA-256e70e0997…2585
pg-exporter_1.2.1-1_ppc64le.deb LinuxSHA-2564e6c7fae…3d87
pg_exporter-1.2.1-1.aarch64.rpm Linuxarm64SHA-25630103629…2a47
pg_exporter-1.2.1-1.ppc64le.rpm LinuxSHA-25601b4dd32…b517
pg_exporter-1.2.1-1.x86_64.rpm Linuxamd64SHA-2565afb4f14…de50
pg_exporter-1.2.1.darwin-amd64.tar.gz macOSamd64SHA-25645e71c60…bcf5
pg_exporter-1.2.1.darwin-arm64.tar.gz macOSarm64SHA-256d3035cc6…6259
pg_exporter-1.2.1.linux-amd64.tar.gz Linuxamd64SHA-25614d3f83d…a340
pg_exporter-1.2.1.linux-arm64.tar.gz Linuxarm64SHA-25671082081…4fe1
pg_exporter-1.2.1.linux-ppc64le.tar.gz LinuxSHA-256cba30919…09e7
pg_exporter-1.2.1.windows-amd64.tar.gz Windowsamd64SHA-2566fe528a2…38e9

https://github.com/pgsty/pg_exporter/releases/tag/v1.2.1

v1.2.0

v1.2.0 是一次聚焦稳定性与兼容性的中版本更新,覆盖启动流程、热重载、健康检查、配置校验与 Legacy 支持。

新功能:

  • 支持配置热重载:新增平台相关的信号重载(SIGHUP / SIGUSR1),并强化 POST /reload 工作流,可在不重启进程情况下更新配置与查询计划
  • 启动流程改为非阻塞:即使目标库预检失败,也会先启动 HTTP 服务,便于监控系统先接入后恢复
  • 新增 PostgreSQL 9.1-9.6 Legacy 配置套件:提供 legacy/ 配置目录与 make conf9 目标,便于 EOL 老版本平滑接入
  • 健康检查机制重构:引入缓存健康快照与周期探测,读写角色类健康端点行为更一致,重载期间更平滑
  • 工程链路增强:Release 工作流增加 go test 与 go vet,并升级构建链到 Go 1.26.0

Bug 修复:

  • 修复多处配置解析边界问题:拒绝非法 metrics 定义、无效目录加载失败场景可正确报错,并补齐运行时回退逻辑
  • 修复命令行布尔参数解析:正确处理 --flag=false 风格传参,避免被误判为启用
  • 修复 /explain 输出与渲染安全性:调整内容类型并改用更安全的模板渲染路径
  • 修复谓词查询与连接 URL 处理细节:增强 BOOL/BOOLEAN 条件支持、完善 dbname 查询参数解析与 URL 脱敏输出
  • 修复自动发现目标移除时的资源释放行为:异步关闭已移除数据库连接,降低采集阻塞风险
  • 修复指标与标签校验细节:补齐常量标签冲突检查、默认值缩放处理与若干 Prometheus 规则校验

校验和

下载资产
文件校验和
pg-exporter_1.2.0-1_amd64.deb Linuxamd64SHA-25626e7a052…5f64
pg-exporter_1.2.0-1_arm64.deb Linuxarm64SHA-2564ec21913…fafe
pg-exporter_1.2.0-1_ppc64le.deb LinuxSHA-2565b2cc00e…283e
pg_exporter-1.2.0-1.aarch64.rpm Linuxarm64SHA-256d536d41a…e0d4
pg_exporter-1.2.0-1.ppc64le.rpm LinuxSHA-256b7a1daa2…e35c
pg_exporter-1.2.0-1.x86_64.rpm Linuxamd64SHA-25628bf7d85…99b5
pg_exporter-1.2.0.darwin-amd64.tar.gz macOSamd64SHA-25651c3b3d1…db8c
pg_exporter-1.2.0.darwin-arm64.tar.gz macOSarm64SHA-2563ba1c7ad…b077
pg_exporter-1.2.0.linux-amd64.tar.gz Linuxamd64SHA-2569e1ec6c1…843e
pg_exporter-1.2.0.linux-arm64.tar.gz Linuxarm64SHA-2569e188496…b809
pg_exporter-1.2.0.linux-ppc64le.tar.gz LinuxSHA-2566e284896…465f
pg_exporter-1.2.0.windows-amd64.tar.gz Windowsamd64SHA-2569e9beac6…52d9

https://github.com/pgsty/pg_exporter/releases/tag/v1.2.0

v1.1.2

小版本更新,修复 pg_timeline 配置问题,使用最新 Go 依赖构建。

校验和

下载资产
文件校验和
pg-exporter_1.1.2-1_amd64.deb Linuxamd64SHA-2568cddd57a…6236
pg-exporter_1.1.2-1_arm64.deb Linuxarm64SHA-256f5b25a8a…4f04
pg-exporter_1.1.2-1_ppc64le.deb LinuxSHA-2564da2c287…c83c
pg_exporter-1.1.2-1.aarch64.rpm Linuxarm64SHA-256b26355f3…a5e8
pg_exporter-1.1.2-1.ppc64le.rpm LinuxSHA-25642ef8971…cca5
pg_exporter-1.1.2-1.x86_64.rpm Linuxamd64SHA-256a8f4a2d5…675d
pg_exporter-1.1.2.darwin-amd64.tar.gz macOSamd64SHA-256775f5ea3…4750
pg_exporter-1.1.2.darwin-arm64.tar.gz macOSarm64SHA-2567f2bbcc2…1003
pg_exporter-1.1.2.linux-amd64.tar.gz Linuxamd64SHA-25633c34b1f…2b98
pg_exporter-1.1.2.linux-arm64.tar.gz Linuxarm64SHA-2562b91a581…bdd8
pg_exporter-1.1.2.linux-ppc64le.tar.gz LinuxSHA-256adcb5f22…27ee
pg_exporter-1.1.2.windows-amd64.tar.gz Windowsamd64SHA-25690b7c7e4…5a4a

https://github.com/pgsty/pg_exporter/releases/tag/v1.1.2

v1.1.1

小版本更新,新增采集器和 Bug 修复。

新功能:

  • 新增 pg_timeline 采集器,用于时间线监控
  • 新增 pg_sub_16 采集器分支,排除订阅中的并行操作(PostgreSQL 16+ 兼容性)

Bug 修复:

  • 修复:为 pg_recv 采集器的 slotname 添加 coalesce 以处理 NULL 值

校验和

下载资产
文件校验和
pg-exporter_1.1.1-1_amd64.deb Linuxamd64SHA-256fd5ee965…a278
pg-exporter_1.1.1-1_arm64.deb Linuxarm64SHA-256b90a08d1…aa27
pg-exporter_1.1.1-1_ppc64le.deb LinuxSHA-256163955f5…6d3a
pg_exporter-1.1.1-1.aarch64.rpm Linuxarm64SHA-256cf4f8bc1…e6c8
pg_exporter-1.1.1-1.ppc64le.rpm LinuxSHA-2565a425b2f…4a2e
pg_exporter-1.1.1-1.x86_64.rpm Linuxamd64SHA-25623606cce…1a16
pg_exporter-1.1.1.darwin-amd64.tar.gz macOSamd64SHA-256ce74624e…6188
pg_exporter-1.1.1.darwin-arm64.tar.gz macOSarm64SHA-25635fba125…4ae3
pg_exporter-1.1.1.linux-amd64.tar.gz Linuxamd64SHA-2567699bdef…0bef
pg_exporter-1.1.1.linux-arm64.tar.gz Linuxarm64SHA-256f4baba59…71c6
pg_exporter-1.1.1.linux-ppc64le.tar.gz LinuxSHA-256810c3817…a781
pg_exporter-1.1.1.windows-amd64.tar.gz Windowsamd64SHA-2563f6df693…5f93

https://github.com/pgsty/pg_exporter/releases/tag/v1.1.1

v1.1.0

使用 Go 1.25.5 和最新依赖构建,采集器更新:

采集器变更:

  • pg_setting:针对 PG10-18 兼容性进行重大重构,支持 missing_ok
    • 新增 13 个指标:max_parallel_workers、max_parallel_workers_per_gather、max_parallel_maintenance_workers、shared_buffers、maintenance_work_mem、effective_cache_size、fsync、full_page_writes、autovacuum、autovacuum_max_workers、checkpoint_timeout、checkpoint_completion_target、hot_standby、synchronous_commit、io_method
    • 将 work_memory_size 重命名为 work_mem
    • min_version 从 9.6 改为 10,显式 ::int 类型转换
  • pg_size:修复日志目录大小检测,使用 logging_collector 检查代替路径模式匹配
  • pg_table:性能优化,用 JOIN 替换 LATERAL 子查询以提升查询性能;修复 tuples 和 frozenxid 指标类型从 COUNTER 改为 GAUGE;超时从 1s 增加到 2s
  • pg_vacuuming:新增 PG17 采集器分支,包含新指标 indexes_total、indexes_processed、dead_tuple_bytes 用于索引 vacuum 进度跟踪
  • pg_query:超时从 1s 增加到 2s 以应对高负载场景
  • pg_io:修复 reuses 描述中的拼写错误(“in reused” -> “is reused”)
  • pg_checkpointer:修复 pg_checkpointer_10 描述(“9.4+” -> “9.4-17”)
  • pg_db_confl:修复 pg_db_confl_15 描述(“9.1 - 16” -> “9.1 - 15”)
  • pg_db、pg_indexing、pg_clustering、pg_backup 格式对齐修复

其他变更:

校验和

下载资产
文件校验和
pg-exporter_1.1.0-1_amd64.deb Linuxamd64SHA-2569c65f43e…5ca2
pg-exporter_1.1.0-1_arm64.deb Linuxarm64SHA-256bcd2cacb…972d
pg-exporter_1.1.0-1_ppc64le.deb LinuxSHA-2562c9d4a9c…71b1
pg_exporter-1.1.0-1.aarch64.rpm Linuxarm64SHA-2562934ab5b…f7b8
pg_exporter-1.1.0-1.ppc64le.rpm LinuxSHA-2563c9955f3…ab43
pg_exporter-1.1.0-1.x86_64.rpm Linuxamd64SHA-2569fdefbd8…ea05
pg_exporter-1.1.0.darwin-amd64.tar.gz macOSamd64SHA-25671590020…90cc
pg_exporter-1.1.0.darwin-arm64.tar.gz macOSarm64SHA-2567d55ac5c…6d65
pg_exporter-1.1.0.linux-amd64.tar.gz Linuxamd64SHA-2568211ec24…f02f
pg_exporter-1.1.0.linux-arm64.tar.gz Linuxarm64SHA-256d17ab7f9…b3ae
pg_exporter-1.1.0.linux-ppc64le.tar.gz LinuxSHA-256c074aeb3…40b6
pg_exporter-1.1.0.windows-amd64.tar.gz Windowsamd64SHA-25613d653e2…fcb7

https://github.com/pgsty/pg_exporter/releases/tag/v1.1.0

v1.0.3

  • 使用 Go 1.25.4 和最新依赖构建
  • 修复 #80 与 libpq 环境变量冲突
  • 由 @kadaffy 将 auto-discovery 默认值改为 true

校验和

下载资产
文件校验和
pg-exporter_1.0.3-1_amd64.deb Linuxamd64SHA-2567efa1a77…d015
pg-exporter_1.0.3-1_arm64.deb Linuxarm64SHA-25641e18bf1…3b07
pg-exporter_1.0.3-1_ppc64le.deb LinuxSHA-2567da8ed73…3a43
pg_exporter-1.0.3-1.aarch64.rpm Linuxarm64SHA-256a214b555…d6b4
pg_exporter-1.0.3-1.ppc64le.rpm LinuxSHA-256d876fc66…1413
pg_exporter-1.0.3-1.x86_64.rpm Linuxamd64SHA-25675f62d31…75b4
pg_exporter-1.0.3.darwin-amd64.tar.gz macOSamd64SHA-25647829a19…2769
pg_exporter-1.0.3.darwin-arm64.tar.gz macOSarm64SHA-25638b6ccb7…af6b
pg_exporter-1.0.3.linux-amd64.tar.gz Linuxamd64SHA-25636e8dff8…919a
pg_exporter-1.0.3.linux-arm64.tar.gz Linuxarm64SHA-2566477e8ef…8791
pg_exporter-1.0.3.linux-ppc64le.tar.gz LinuxSHA-256a083b51e…820c
pg_exporter-1.0.3.windows-amd64.tar.gz Windowsamd64SHA-256a1f9b27b…a588

https://github.com/pgsty/pg_exporter/releases/tag/v1.0.3

v1.0.2

  • 使用 Go 1.25.0 和最新依赖构建
  • 专属网站和主页:https://exp.pgsty.com
  • 使用 goreleaser 通过 CI/CD 流水线发布更多操作系统/架构:
    • 新增 Windows amd64 支持
    • 新增 Linux ppc64le 支持

校验和

下载资产
文件校验和
pg-exporter_1.0.2-1_amd64.deb Linuxamd64SHA-256683bf97f…44c5
pg-exporter_1.0.2-1_arm64.deb Linuxarm64SHA-256f62d479a…ccb5
pg-exporter_1.0.2-1_ppc64le.deb LinuxSHA-256e1bbfc5a…4c7a
pg_exporter-1.0.2-1.aarch64.rpm Linuxarm64SHA-256f51d5b45…039c
pg_exporter-1.0.2-1.ppc64le.rpm LinuxSHA-25618380011…939e
pg_exporter-1.0.2-1.x86_64.rpm Linuxamd64SHA-256198372d8…f2bb
pg_exporter-1.0.2.darwin-amd64.tar.gz macOSamd64SHA-256cbe7e07d…477d
pg_exporter-1.0.2.darwin-arm64.tar.gz macOSarm64SHA-25620c4a35f…4b97
pg_exporter-1.0.2.linux-amd64.tar.gz Linuxamd64SHA-256d7421111…eff1
pg_exporter-1.0.2.linux-arm64.tar.gz Linuxarm64SHA-2560b1f4c97…054f
pg_exporter-1.0.2.linux-ppc64le.tar.gz LinuxSHA-256895083fd…dcc3
pg_exporter-1.0.2.windows-amd64.tar.gz Windowsamd64SHA-2565f751228…10aa

https://github.com/pgsty/pg_exporter/releases/tag/v1.0.2

v1.0.1

  • 新增 DockerHub 镜像:pgsty/pg_exporter
  • 升级 Go 依赖到最新版本,使用 Go 1.24.5 构建
  • 默认禁用 pg_tsdb_hypertable 采集器,因为 timescaledb 目录已变更

校验和

下载资产
文件校验和
pg_exporter-1.0.1-1.aarch64.rpm Linuxarm64MD5d5e2d6a6…9773
pg_exporter-1.0.1-1.x86_64.rpm Linuxamd64MD5cb01bb78…3cb3
pg_exporter-v1.0.1.darwin-amd64.tar.gz macOSamd64MD567093a75…8e81
pg_exporter-v1.0.1.darwin-arm64.tar.gz macOSarm64MD52d3fdc10…f127
pg_exporter-v1.0.1.linux-amd64.tar.gz Linuxamd64MD5e2423144…8ab0
pg_exporter-v1.0.1.linux-arm64.tar.gz Linuxarm64MD563de91da…82a6
pg-exporter_1.0.1_amd64.deb Linuxamd64MD5718f6afc…9ba5
pg-exporter_1.0.1_arm64.deb Linuxarm64MD557da7a80…7367

https://github.com/pgsty/pg_exporter/releases/tag/v1.0.1

v1.0.0

新增 PostgreSQL 18 指标支持

  • 新采集器分支 pg_wal_18:
    • 移除 write、sync、write_time、sync_time 指标
    • 移至 pg_stat_io
  • 新采集器分支 pg_checkpointer_18:
    • 新指标 num_done
    • 新指标 slru_written
  • 新采集器分支 pg_db_18:
    • 新指标 parallel_workers_to_launch
    • 新指标 parallel_workers_launched
  • 新采集器分支 pg_table_18:
    • table_parallel_workers_to_launch
    • table_parallel_workers_launched
  • 新采集器分支 pg_io_18:
    • 新增 WAL 统计系列
    • 新指标 read_bytes
    • 新指标 write_bytes
    • 新指标 extend_bytes
    • 移除 op_bytes(因为是固定值)
  • 新采集器分支 pg_vacuuming_18:
    • 新指标 delay_time
下载资产
文件校验和
pg_exporter-1.0.0-1.aarch64.rpm Linuxarm64MD533fe4dd8…bbc9
pg_exporter-1.0.0-1.x86_64.rpm Linuxamd64MD5eba8426b…004a
pg_exporter-v1.0.0.darwin-amd64.tar.gz macOSamd64MD5f6912822…da11
pg_exporter-v1.0.0.darwin-arm64.tar.gz macOSarm64MD5c133c607…c438
pg_exporter-v1.0.0.linux-amd64.tar.gz Linuxamd64MD53875487d…7ee0
pg_exporter-v1.0.0.linux-arm64.tar.gz Linuxarm64MD5395715fb…babd
pg-exporter_1.0.0_amd64.deb Linuxamd64MD5f3b23e59…2ef3
pg-exporter_1.0.0_arm64.deb Linuxarm64MD5a7305b9c…1dfe

https://github.com/pgsty/pg_exporter/releases/tag/v1.0.0

v0.9.0

默认采集器

  • 新增 timescaledb 超表指标采集器
  • 新增 citus 分布式节点指标采集器
  • 新增 pg_wait_sampling 等待事件采集器
  • pg_slot 全面改进:新增 16/17 pg_replication_slot 指标
  • 允许 pg_slot 采集器从 16/17 开始在从库上运行
  • 重构 pg_wait 采集器,从所有进程聚合
  • 限制 pg_clustering、pg_indexing、pg_vacuuming 只在主库运行
  • 将所有 reset_time 标记为 GAUGE 而非 COUNTER
  • 修复 pg_recovery_prefetch_skip_fpw 类型从 GAUGE 改为 COUNTER
  • 修复 pg_recv.state 类型从 LABEL 改为 GAUGE
  • 采集器格式改为紧凑模式
  • 新增默认指标 pg_exporter_build_info / pgbouncer_exporter_build_info
  • 为 pg_meta 采集器新增 server_encoding
  • 为 pg_setting 采集器新增 12 个设置指标:
    • wal_block_size
    • segment_size
    • wal_segment_size
    • wal_level
    • wal_log_hints
    • work_mem
    • hugepage_count
    • hugepage_status
    • max_wal_size
    • min_wal_size
    • max_slot_wal_keep_size

导出器代码库

  • 使用最小 PG 版本后缀规范化采集器分支名称
  • 为二进制包添加许可证文件
  • 将 pgsty/pg_exporter 仓库移至 pgsty/pg_exporter
  • 重构 server.go 以降低 Compatible 和 PostgresPrecheck 复杂度
  • 使用额外数字前缀重命名指标采集器以便排序
  • 升级依赖到最新版本
  • 在所有非致命采集器之前执行致命采集器,快速失败

https://github.com/pgsty/pg_exporter/releases/tag/v0.9.0

v0.8.1

https://github.com/pgsty/pg_exporter/releases/tag/v0.8.1

v0.8.0

  • 新增 PgBouncer 1.24 新指标支持(stat、pool、database)
  • 修复:310-pg_size.yml 在日志目录设置不正确时失败 #64,由 @Süleyman Vurucu 贡献
  • 使用最新 Go 1.24 构建并升级所有依赖
  • 使用标准 log/slog 重构日志,替代 go-kit
  • 完整变更日志:https://github.com/pgsty/pg_exporter/compare/v0.7.1…v0.8.0

https://github.com/pgsty/pg_exporter/releases/tag/v0.8.0

v0.7.1

使用 dependabot 进行例行更新

  • 功能:支持将配置指定为 Reader,由 @ringerc 在 #62 贡献
  • 升级 golang.org/x/crypto 从 0.21.0 到 0.31.0,由 @dependabot 在 #63 贡献
  • 修复一些拼写错误
  • 完整变更日志:https://github.com/pgsty/pg_exporter/compare/v0.7.0…v0.7.1

https://github.com/pgsty/pg_exporter/releases/tag/v0.7.1

v0.7.0

为最新 Go 版本重构代码库。

https://github.com/pgsty/pg_exporter/releases/tag/v0.7.0

v0.6.0

https://github.com/pgsty/pg_exporter/releases/tag/v0.6.0

v0.5.0

导出器增强

  • 使用 nfpm 构建 rpm 和 deb
  • 新增 column.default,当指标值为 NULL 时替换
  • 新增 column.scale,当指标值为浮点/整数时乘以缩放因子(例如微秒转秒)
  • 修复 /stat 端点输出
  • 新增 Docker 容器 pgsty/pg_exporter

指标采集器

  • 将 bgwriter 和 pg_wal 时间单位缩放为秒
  • 移除 pg_class 采集器,将其移至 pg_table 和 pg_index
  • 为 pg_table 新增 pg_class 指标
  • 为 pg_index 新增 pg_class 指标
  • 默认启用 pg_table_size
  • 将 pg_query、pg_db、pg_bgwriter、pg_ssl、pgbouncer_stat 时间指标缩放为秒

https://github.com/pgsty/pg_exporter/releases/tag/v0.5.0

v0.4.1

  • 更新默认采集器
    • 在对象监控中省略 citus 和 timescaledb 模式
    • 避免重复的 pg_statio 元组
    • 支持 pgbouncer v1.16
    • Bug 修复:pg_repl 采集器在 pg 12 上重叠
  • 新参数:-T connect-timeout PG_EXPORTER_CONNECT_TIMEOUT 这在监控远程 Postgres 实例时很有用
  • 现在 pg_exporter.yaml 在 rpm 包中重命名为 pg_exporter.yml

https://github.com/pgsty/pg_exporter/releases/tag/v0.4.1

v0.4.0

  • 新增 PG 14 支持
  • 默认指标配置全面改进(但您仍可使用旧配置)
  • 新增 auto-discovery、include-database 和 exclude-database 选项
  • 新增多数据库监控实现(使用 auto-discovery = on)

https://github.com/pgsty/pg_exporter/releases/tag/v0.4.0

v0.3.2

  • 修复 shadow DSN 边界情况
  • 修复拼写错误和文档

https://github.com/pgsty/pg_exporter/releases/tag/v0.3.2

v0.3.1

修复默认配置问题(特别是低于 13 的版本)

  • 设置 primary_conninfo 在 PG13 之前不存在
  • 为 pg_func 采集器添加 funcid 标签以避免函数名重复标签
  • 修复版本字符串为 pg_exporter

https://github.com/pgsty/pg_exporter/releases/tag/v0.3.1

v0.3.0

https://github.com/pgsty/pg_exporter/releases/tag/v0.3.0

  • 更改默认配置,支持 PostgreSQL 13 新指标(pg_slru、pg_shmem、pg_query13、pg_backup 等)
  • 新增一系列用于健康/恢复状态检查的 REST API
  • 新增一个带有假 pg_up 0 指标的虚拟服务器,在 PgExporter 初始化之前提供服务
  • 如果未指定 sslmode,向 URL 添加 sslmode=disable
  • 修复拼写错误和 Bug

v0.2.0

  • 新增 yum 包和 Linux 服务定义
  • 在查询配置中新增 ‘skip’ 标志
  • 修复 pgbouncer_up 指标
  • 新增配置重载支持

https://github.com/pgsty/pg_exporter/releases/tag/v0.2.0

v0.1.2

  • 修复 pgbouncer_up 指标
  • 新增动态配置重载
  • 移除 ‘shard’ 相关逻辑
  • 在默认设置中添加 ‘bulky’ 模式

https://github.com/pgsty/pg_exporter/releases/tag/v0.1.2

v0.1.1

修复 pg_exporter 在启动时如果任何查询失败会挂起的 Bug。

https://github.com/pgsty/pg_exporter/releases/tag/v0.1.1

v0.1.0

可以工作了,看起来不错。

https://github.com/pgsty/pg_exporter/releases/tag/v0.1.0

v0.0.4

在真实生产环境中测试了大约 2 周,200+ 节点。看起来不错!

https://github.com/pgsty/pg_exporter/releases/tag/v0.0.4

v0.0.3

v0.0.3 发布,在生产环境中测试

此版本已在生产环境中测试。

这个项目仍在快速发展中,如果您想在生产中使用,请谨慎尝试。

https://github.com/pgsty/pg_exporter/releases/tag/v0.0.3

v0.0.2

现在可以尝试了

https://github.com/pgsty/pg_exporter/releases/tag/v0.0.2

v0.0.1

新增 pgbouncer 模式

https://github.com/pgsty/pg_exporter/releases/tag/v0.0.1

这个页面对您有帮助吗?

表格阅读