PG Exporter 文档
安装、部署、加固、运维与扩展 pg_exporter。
pg_exporter 是一款面向 Prometheus 兼容监控系统的高级 PostgreSQL 与 pgBouncer 指标导出器。它将内置的可用性/角色指标与声明式 SQL 采集器引擎组合起来，让指标面可以独立于 Go 二进制持续演进。
本文档以最新稳定版本 v1.4.1 为基线，作为独立的中英文手册维护；内容比原先 Pigsty 模块中的汇总页更加完整。
从这里开始
| 文档 | 适用场景 |
|---|---|
| 项目简介 | 理解架构、执行模型与产品边界 |
| 快速上手 | 用约十分钟得到可用的 exporter 与 Prometheus 抓取目标 |
| 安装指南 | 在 RPM、DEB、压缩包、Docker、Pigsty 与源码安装之间选择 |
| 兼容性 | 核对 PostgreSQL、pgBouncer、操作系统、CPU、软件包与容器支持 |
生产运行
| 文档 | 覆盖内容 |
|---|---|
| 生产部署 | 参数、环境变量、systemd、Docker、Kubernetes、自动发现、抓取与告警 |
| 安全指南 | 数据库最小权限、密钥、TLS、HTTP 认证与网络暴露面 |
| 故障排查 | 以症状为入口，使用日志、/up、/explain、/stat 与配置校验定位问题 |
理解与扩展
| 参考 | 覆盖内容 |
|---|---|
| 采集器配置 | 完整 YAML 模型：查询、标签、谓词、TTL、超时、Label、Counter、Gauge 与快照直方图 |
| 内置采集器 | 58 个定义文件、采集器分组、前置条件、开销与基数控制 |
| HTTP API | 指标、健康检查、角色路由、重载、解释、统计、版本与首页端点 |
| 开发指南 | 构建、测试、修改采集器、重建合并配置与发布产物 |
| 发布注记 | 每个标签版本一篇中英文文章，按时间倒序排列 |
文档口径
- 命令与路径均对照当前
pg_exporter源码和 v1.4.1 发布产物核验。 - 默认描述稳定版本行为；涉及尚未发布的
main分支行为时会明确标注。 - 已包含 PostgreSQL 19 采集器分支，但目标是否适合生产仍以 PostgreSQL 官方发布状态为准。
- 英文与简体中文页面成对维护，可以通过语言切换器在对应页面之间切换。
源码、Issue 与贡献入口请访问 pgsty/pg_exporter。