4个步骤掌握postgres_exporter：从部署到监控全攻略

PostgreSQL监控是保障数据库稳定运行的关键环节，而postgres_exporter作为一款高效的指标导出工具，通过与Prometheus集成，能够实时采集并暴露PostgreSQL数据库的关键性能指标，为数据库运维提供数据支持。本文将通过四个核心步骤，帮助你从部署到深度配置，全面掌握postgres_exporter的使用方法。

一、理解核心价值：为什么选择postgres_exporter

postgres_exporter作为Prometheus生态中的重要组件，其核心价值在于能够将PostgreSQL数据库的内部状态转化为可监控的时序指标。它通过查询数据库系统表和视图，收集包括连接数、查询性能、锁等待、事务状态等关键指标，并以Prometheus兼容的格式暴露，实现了数据库性能的实时监控与告警。

与传统监控工具相比，postgres_exporter具有轻量化、易集成、指标丰富等特点，能够无缝对接Prometheus和Grafana，构建完整的数据库监控体系，帮助运维人员及时发现性能瓶颈和潜在风险。

二、快速上手：3分钟部署postgres_exporter

2.1 准备环境依赖

确保系统已安装以下软件：

• Go 1.13+（用于编译源码）
• PostgreSQL 11+（目标监控数据库）
• Prometheus（指标收集与存储）

💡 提示：如果使用Docker部署，可跳过Go环境安装

2.2 获取项目源码

git clone https://gitcode.com/gh_mirrors/po/postgres_exporter
cd postgres_exporter

2.3 编译可执行文件

make build

✅ 编译成功后，当前目录会生成postgres_exporter可执行文件

2.4 启动 exporter 服务

./postgres_exporter \
  --web.listen-address=":9187" \  # 指定监控端口（默认9187）
  --data.source.uri="host=localhost port=5432 dbname=postgres user=postgres password=password sslmode=disable"

2.5 验证服务状态

访问http://localhost:9187/metrics，若能看到类似pg_up 1的指标输出，说明服务启动成功。

三、深度配置：定制你的监控方案

3.1 配置文件模式

创建自定义配置文件queries.yaml，添加个性化监控指标：

pg_custom_metrics:
  query: "SELECT count(*) as connections FROM pg_stat_activity WHERE state = 'active'"
  metrics:
    - connections:
        usage: "GAUGE"
        description: "Number of active database connections"

启动时指定配置文件：

./postgres_exporter --extend.query-path=queries.yaml

3.2 多实例监控配置

修改Prometheus配置文件prometheus.yml，添加多目标监控：

scrape_configs:
  - job_name: 'postgres'
    static_configs:
      - targets: ['db1:9187', 'db2:9187']  # 多个exporter实例地址

3.3 安全认证配置

启用数据库SSL连接和基本认证：

./postgres_exporter \
  --data.source.uri="host=db.example.com sslmode=require" \
  --web.config.file=web-config.yml  # 包含TLS和基本认证配置

四、最佳实践：生产环境部署指南

4.1 系统服务配置

创建systemd服务文件/etc/systemd/system/postgres-exporter.service：

[Unit]
Description=PostgreSQL Exporter
After=network.target postgresql.service

[Service]
User=prometheus
ExecStart=/usr/local/bin/postgres_exporter \
  --config.file=/etc/postgres-exporter/config.yml \
  --web.listen-address=:9187
Restart=always

[Install]
WantedBy=multi-user.target

4.2 生产级配置示例

推荐使用配置文件configs/prod-example.yml，包含以下关键设置：

• 多数据库实例监控配置
• 指标采集频率优化
• 连接池与超时设置
• 敏感信息环境变量引用

4.3 监控指标优化

生产环境建议关注以下核心指标：

• pg_stat_activity：连接状态与查询执行时间
• pg_stat_statements：SQL执行性能统计
• pg_stat_bgwriter：后台写入性能指标
• pg_locks：锁等待情况监控

4.4 高可用部署

采用双节点部署模式，配合Prometheus的服务发现功能，实现exporter的高可用：

1. 在两台服务器部署相同配置的exporter
2. 配置Prometheus的relabel_configs实现自动故障转移
3. 使用Grafana告警确保监控服务自身可用性

通过以上四个步骤，你已完成从基础部署到生产级配置的全流程。postgres_exporter作为PostgreSQL监控的重要工具，能够帮助你构建全方位的数据库性能监控体系，为业务稳定运行提供有力保障。