PG Exporter

高级 PostgreSQL 与 PgBouncer 监控指标导出器

为 Prometheus / Victoria 打造的极致 PostgreSQL 监控体验：超过 600+ 监控指标、声明式配置 与 动态规划 能力。

功能特性

特性	描述
全指标覆盖	监控 PostgreSQL（10-18+）与 pgBouncer（1.8-1.24+），全指标覆盖
声明式配置	通过 YAML 配置文件定义自定义指标，精细控制超时、缓存和跳过条件
采集器定制	使用声明式 YAML 配置定义自己的指标，支持动态查询规划
自动发现	自动发现并监控 PostgreSQL 实例中的多个数据库
动态规划	根据 PostgreSQL 版本、扩展和服务器特性自动调整指标采集策略
生产就绪	在真实环境中经过 6 年以上、12K+ 核心的实战检验，具备企业级可靠性
健康检查	提供全面的 HTTP 端点用于服务健康检查和流量路由，支持主从检测
智能缓存	内置缓存机制，可配置 TTL，减少数据库负载并提升性能
扩展感知	原生支持 pg_stat_statements、pg_wait_sampling, citus, timesacledb

快速安装

PG Exporter 提供多种 安装方式，适配各种基础设施：

docker run -d --name pg_exporter -p 9630:9630 -e PG_EXPORTER_URL="postgres://user:pass@host:5432/postgres" pgsty/pg_exporter:latest

# 基于 RPM 的系统
sudo tee /etc/yum.repos.d/pigsty-infra.repo > /dev/null <<-'EOF'
[pigsty-infra]
name=Pigsty Infra for $basearch
baseurl=https://repo.pigsty.io/yum/infra/$basearch
enabled = 1
gpgcheck = 0
module_hotfixes=1
EOF

sudo yum makecache;
sudo yum install -y pg_exporter

sudo tee /etc/apt/sources.list.d/pigsty-infra.list > /dev/null <<EOF
deb [trusted=yes] https://repo.pigsty.io/apt/infra generic main
EOF

sudo apt update;
sudo apt install -y pg-exporter

wget https://github.com/pgsty/pg_exporter/releases/download/v1.1.0/pg_exporter-v1.1.0.linux-amd64.tar.gz
tar -xf pg_exporter-v1.1.0.linux-amd64.tar.gz
sudo install pg_exporter-v1.1.0.linux-amd64/pg_exporter /usr/bin/
sudo install pg_exporter-v1.1.0.linux-amd64/pg_exporter.yml /etc/pg_exporter.yml

# 从源码构建
git clone https://github.com/pgsty/pg_exporter.git
cd pg_exporter
make build

快速开始

几分钟内即可启动 PG Exporter，参见快速上手：

# 使用 PostgreSQL 连接 URL 运行
PG_EXPORTER_URL='postgres://user:pass@localhost:5432/postgres' pg_exporter

# 访问指标
curl http://localhost:9630/metrics

文档目录

文档	描述
快速上手	快速开始指南与基础概念
安装指南	各平台的安装说明
配置参考	配置参考与采集器定义
API 参考	HTTP API 端点参考
部署指南	生产部署最佳实践
发布说明	版本发布历史