# PG Exporter 文档

> 安装、部署、加固、运维与扩展 pg_exporter。

---

LLMS index: [llms.txt](/llms.txt)

---

`pg_exporter` 是一款面向 Prometheus 兼容监控系统的高级 PostgreSQL 与 pgBouncer 指标导出器。它将内置的可用性/角色指标与声明式 SQL 采集器引擎组合起来，让指标面可以独立于 Go 二进制持续演进。

本文档以最新稳定版本 **[v1.4.1](https://github.com/pgsty/pg_exporter/releases/tag/v1.4.1)** 为基线，作为独立的中英文手册维护；内容比原先 Pigsty 模块中的汇总页更加完整。

## 从这里开始

| 文档 | 适用场景 |
|:---|:---|
| [项目简介](/zh/intro/) | 理解架构、执行模型与产品边界 |
| [快速上手](/zh/start/) | 用约十分钟得到可用的 exporter 与 Prometheus 抓取目标 |
| [安装指南](/zh/install/) | 在 RPM、DEB、压缩包、Docker、Pigsty 与源码安装之间选择 |
| [兼容性](/zh/compatibility/) | 核对 PostgreSQL、pgBouncer、操作系统、CPU、软件包与容器支持 |

## 生产运行

| 文档 | 覆盖内容 |
|:---|:---|
| [生产部署](/zh/deploy/) | 参数、环境变量、systemd、Docker、Kubernetes、自动发现、抓取与告警 |
| [安全指南](/zh/security/) | 数据库最小权限、密钥、TLS、HTTP 认证与网络暴露面 |
| [故障排查](/zh/troubleshooting/) | 以症状为入口，使用日志、`/up`、`/explain`、`/stat` 与配置校验定位问题 |

## 理解与扩展

| 参考 | 覆盖内容 |
|:---|:---|
| [采集器配置](/zh/config/) | 完整 YAML 模型：查询、标签、谓词、TTL、超时、Label、Counter、Gauge 与快照直方图 |
| [内置采集器](/zh/collectors/) | 58 个定义文件、采集器分组、前置条件、开销与基数控制 |
| [HTTP API](/zh/api/) | 指标、健康检查、角色路由、重载、解释、统计、版本与首页端点 |
| [开发指南](/zh/development/) | 构建、测试、修改采集器、重建合并配置与发布产物 |
| [发布注记](/zh/release/) | 每个标签版本一篇中英文文章，按时间倒序排列 |

## 文档口径

- 命令与路径均对照当前 `pg_exporter` 源码和 v1.4.1 发布产物核验。
- 默认描述稳定版本行为；涉及尚未发布的 `main` 分支行为时会明确标注。
- 已包含 PostgreSQL 19 采集器分支，但目标是否适合生产仍以 PostgreSQL 官方发布状态为准。
- 英文与简体中文页面成对维护，可以通过语言切换器在对应页面之间切换。

源码、Issue 与贡献入口请访问 [pgsty/pg_exporter](https://github.com/pgsty/pg_exporter)。