pg_exporter

项目概述

PG Exporter 是一个为 Prometheus 设计的 PostgreSQL 与 pgBouncer 高级指标导出器，提供声明式配置、动态规划和可自定义的采集器，带来终极的 PostgreSQL 可观测性体验。

主要功能

• 高度可定制：通过声明式 YAML 配置定义几乎所有指标
• 全面覆盖：在单个导出器中监控 PostgreSQL（10-19+）和 pgBouncer（1.8-1.25+）
• 细粒度控制：每个采集器可配置超时、缓存、跳过条件和致命性
• 动态规划：基于不同条件定义多个查询分支
• 生产就绪：在真实环境中经受过 12K+ 核心、6+ 年的实战考验
• 自动发现：自动发现并监控实例内的多个数据库
• 健康检查 API：提供全面的 HTTP 端点用于服务健康和流量路由
• 扩展支持：支持 timescaledb、citus、pg_stat_statements、pg_wait_sampling 等扩展

适用人群

• PostgreSQL 数据库管理员和运维工程师
• 使用 Prometheus 监控 PostgreSQL 的团队
• 需要深入 PostgreSQL 可观测性的用户

快速上手

1. 从 GitHub Releases 或 Pigsty 的 YUM/APT 基础仓库下载 RPM/DEB/Tarball
2. 通过环境变量或参数传递 PostgreSQL/pgBouncer URL：PG_EXPORTER_URL='postgres://user:pass@host:port/postgres' pg_exporter
3. 访问 http://localhost:9630/metrics 查看指标
4. 所有其他指标均在 pg_exporter.yml 配置文件中定义

核心优势

• 600+ 指标，约 3K 时间序列/实例，覆盖 PostgreSQL 可观测性所需的一切
• 零配置、动态规划、生产级可靠性
• 提供 Grafana 监控仪表盘

系统要求

• 操作系统：跨平台
• 支持架构：x86_64、arm64