PG Exporter 发布

为 Prometheus 提供的高级 PostgreSQL 和 pgBouncer 指标 exporter

PG Exporter 通过声明式配置、动态规划和可定制收集器为您的 PostgreSQL 带来终极监控体验。 它提供 600+ 指标和每个实例约 3K 时间序列，涵盖 PostgreSQL 可观测性所需的一切。 查看 GitHub 仓库 了解更多详情。

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

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
  • 最低版本要求从 9.6 调整为 10，显式使用 ::int 类型转换
• pg_size：修复日志目录大小检测逻辑，改用 logging_collector 参数判断，取代路径模式匹配
• pg_table：性能优化，将 LATERAL 子查询改为 JOIN 以提升查询性能；修复 tuples 和 frozenxid 指标类型（从 COUNTER 改为 GAUGE）；超时时间从 1 秒延长至 2 秒
• pg_vacuuming：新增 PG17 采集器分支，增加 indexes_total、indexes_processed、dead_tuple_bytes 指标，用于追踪索引清理进度
• pg_query：超时时间从 1 秒延长至 2 秒，以适应高负载场景
• 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 的格式对齐问题
• 感谢 @anayrat 修正发布年份 校验和

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

v1.0.2

• 使用 Go 1.25 构建，更新依赖至最新版本。
• 新网站首页：https://exp.pgsty.com
• 使用 goreleaser 自动化构建，集成 GitHub Actions CI/CD
• 添加 windows amd64 构建目标
• 添加 linux ppc64le 构建目标

校验和

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

v1.0.1

• 添加 dockerhub 镜像：pgsty/pg_exporter
• 将 go 依赖项升级到最新版本，使用 go 1.24.5 构建
• 默认禁用 pg_tsdb_hypertable 收集器，因为 timescaledb 目录已更改。

校验和

d5e2d6a656eef0ae1b29cd49695f9773  pg_exporter-1.0.1-1.aarch64.rpm
cb01bb78d7b216a235363e9342803cb3  pg_exporter-1.0.1-1.x86_64.rpm
67093a756b04845f69ad333b6d458e81  pg_exporter-v1.0.1.darwin-amd64.tar.gz
2d3fdc10045d1cf494b9c1ee7f94f127  pg_exporter-v1.0.1.darwin-arm64.tar.gz
e242314461becfa99c3978ae72838ab0  pg_exporter-v1.0.1.linux-amd64.tar.gz
63de91da9ef711a53718bc60b89c82a6  pg_exporter-v1.0.1.linux-arm64.tar.gz
718f6afc004089f12c1ca6553f9b9ba5  pg-exporter_1.0.1_amd64.deb
57da7a8005cdf91ba8c1fb348e0d7367  pg-exporter_1.0.1_arm64.deb

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

8637bc1a05b93eedfbfd3816cca468dd  pg_exporter-1.0.0-1.aarch64.rpm
a28c4c0dcdd3bf412268a2dbff79f5b9  pg_exporter-1.0.0-1.x86_64.rpm
229129209b8e6bc356c28043c7c22359  pg_exporter-v1.0.0.darwin-amd64.tar.gz
d941c2c28301269e62a8853c93facf12  pg_exporter-v1.0.0.darwin-arm64.tar.gz
5bbb94db46cacca4075d4c341c54db37  pg_exporter-v1.0.0.linux-amd64.tar.gz
da9ad428a50546a507a542d808f1c0fa  pg_exporter-v1.0.0.linux-arm64.tar.gz
0fa2395d9d7a43ab87e5c87e5b06ffcc  pg-exporter_1.0.0_amd64.deb
fed56f8a37e30cc59e85f03c81fce3f5  pg-exporter_1.0.0_arm64.deb

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

v0.9.0

默认收集器

• 为 timescaledb hypertable 新增指标收集器
• 为 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

Exporter 代码库

• 使用最小 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

• 将依赖项升级到最新版本
• 将 golang.org/x/net 从 0.35.0 升级到 0.36.0 #67
• 更新 docker 镜像构建标签

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 版本重构代码库。

• PostgreSQL 17 指标支持 由 @Vonng 提供
• pg_exporter：谓词查询功能 由 @ringerc 提供
• 在 dockerfile 中进行清洁构建 由 @ringerc 提供
• pg_exporter：在"bind: address already in use"后不要 panic 由 @ringerc 提供
• pg_exporter：修复 /stat 端点格式 由 @ringerc 提供
• pg_exporter：在 yaml 导出时省略默认查询属性 由 @ringerc 提供
• 从发现中排除模板数据库并模式限定发现查询 由 @ringerc 提供
• 修复一些拼写错误和一些指标描述错误 由 @ringerc 提供
• 从无维护的 lib/pq 驱动程序切换到带有 stdlib 包装器的 pgx 由 @ringerc 提供

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

v0.6.0

• 安全增强：修复 安全 dependent-bot 问题

• 添加 pg16 收集器

• 添加 arm64 和 aarch64 包

• 移除 pg_query 收集器的 monitor 模式要求（您必须通过 search_path 确保这一点，或者只是在默认的 public 模式中安装 pg_stat_statements）

• 将 pgbouncer 版本解析消息级别从 info 修复为 debug

• 修复 pg_table_10_12 收集器缺少 relid 问题。

• 识别配置目录中带有 yml 后缀的文件 由 @Japin Li 提供

• 支持 PostgreSQL 15 及更高版本 由 @Japin Li 提供

• 修复 connect-timeout 传播 由 @mouchar 提供

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

v0.5.0

Exporter 增强

• 使用 nfpm 构建 rpm 和 deb
• 添加 column.default，当指标值为 NULL 时替换
• 添加 column.scale，当指标值为 float/int 时乘以缩放因子（例如 µs 到秒）
• 修复 /stat 端点输出
• 添加 docker 容器 pgsty/pg_exporter

指标收集器

• 将 bgwriter 和 pg_wal 时间单位缩放为秒
• 移除 pg_class 收集器并将其移动到 pg_table 和 pg_inex
• 向 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
  • 错误修复：pg_repl 收集器在 pg 12 上重叠
• 新参数：-T connect-timeout PG_EXPORTER_CONNECT_TIMEOUT 这在监控远程 Postgres 实例时很有用。
• 现在在 rpm 包中 pg_exporter.yaml 重命名为 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
• 修复拼写错误和错误

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 在启动期间如果任何查询失败会挂起的错误。

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