rectapanca/postgres-exporter

PostgreSQL Exporter 镜像文档

镜像概述

本镜像为自定义的PostgreSQL指标导出器，专为Prometheus监控系统设计，用于收集并暴露PostgreSQL数据库的性能指标。已在PostgreSQL 13环境中完成测试验证，可无缝集成到Prometheus监控体系，帮助用户实时监控数据库运行状态。

核心功能与特性

指标收集能力

• 收集数据库连接状态指标（活跃连接数、空闲连接数、最大连接数等）
• 监控查询性能指标（慢查询数量、查询执行时间分布、事务吞吐量等）
• 跟踪资源使用情况（表空间大小、索引使用效率、缓存命中率等）
• 记录锁状态指标（锁等待时间、锁类型分布、阻塞事务数量等）

兼容性与集成

• 已验证支持PostgreSQL 13版本
• 符合Prometheus exporter规范，可直接被Prometheus服务发现和采集
• 支持与Grafana等可视化平台集成，构建数据库监控仪表盘

配置灵活性

• 通过环境变量快速配置数据库连接参数
• 支持自定义监控指标集合，可按需开启或关闭特定指标
• 支持TLS加密连接，保障数据库认证信息安全

使用场景

• 生产环境PostgreSQL数据库性能实时监控
• 数据库容量规划与资源优化
• 异常查询检测与性能瓶颈分析
• 多实例PostgreSQL集群集中监控
• 开发/测试环境数据库健康状态跟踪

使用方法

基本部署（docker run）

bash
docker run -d \
  --name postgres-exporter \
  -p 9187:9187 \
  -e POSTGRES_HOST=postgres.example.com \
  -e POSTGRES_PORT=5432 \
  -e POSTGRES_USER=monitoring_user \
  -e POSTGRES_PASSWORD=secure_password \
  -e POSTGRES_DB=postgres \
  docker.xuanyuan.run/your-image-name:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'

services:
  postgres-exporter:
    image: docker.xuanyuan.run/your-image-name:latest
    container_name: postgres-exporter
    ports:
      - "9187:9187"
    environment:
      - POSTGRES_HOST=postgres
      - POSTGRES_PORT=5432
      - POSTGRES_USER=monitoring
      - POSTGRES_PASSWORD=monitoring_pass
      - POSTGRES_DB=postgres
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: docker.xuanyuan.run/postgres:13
    container_name: postgres
    environment:
      - POSTGRES_USER=monitoring
      - POSTGRES_PASSWORD=monitoring_pass
      - POSTGRES_DB=postgres
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

Prometheus配置集成

在Prometheus配置文件（prometheus.yml）中添加以下内容：

yaml
scrape_configs:
  - job_name: 'postgres-exporter'
    static_configs:
      - targets: ['postgres-exporter:9187']  # 若在同一网络可使用容器名，否则使用主机IP:端口
    scrape_interval: 15s

验证部署

部署完成后，可通过访问 http://<exporter-ip>:9187/metrics 查看导出的指标，确认是否成功收集到PostgreSQL数据库指标。