warpcomdev/pgexport

PostgreSQL 大小指标 Prometheus 导出器镜像

镜像概述

该Docker镜像为PostgreSQL数据库服务器提供Prometheus导出功能，能够以Prometheus exposition格式暴露数据库和表的大小指标，便于Prometheus监控系统收集和分析PostgreSQL的存储使用情况。项目详情可参考：https://github.com/warpcomdev/pgexport

核心功能与特性

• 指标暴露：以Prometheus兼容格式输出PostgreSQL数据库及表的大小指标
• 轻量集成：无需修改PostgreSQL核心配置，通过独立容器方式部署
• 标准化格式：遵循Prometheus exposition格式，可直接被Prometheus抓取

使用场景

• PostgreSQL数据库存储容量监控
• 表级存储增长趋势分析
• 数据库容量规划与预警
• 多实例PostgreSQL存储使用对比

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name pgexport \
  -e POSTGRES_HOST=postgres-server \
  -e POSTGRES_PORT=5432 \
  -e POSTGRES_USER=monitoring_user \
  -e POSTGRES_PASSWORD=secure_password \
  -e POSTGRES_DATABASE=postgres \
  -p 9289:9289 \
  docker.xuanyuan.run/warpcomdev/pgexport

Docker Compose 配置

yaml
version: '3'
services:
  pgexport:
    image: docker.xuanyuan.run/warpcomdev/pgexport
    container_name: pgexport
    environment:
      - POSTGRES_HOST=postgres-server
      - POSTGRES_PORT=5432
      - POSTGRES_USER=monitoring_user
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DATABASE=postgres
    ports:
      - "9289:9289"
    restart: unless-stopped

环境变量配置

验证指标

部署后，可通过访问 http://<容器IP>:9289/metrics 查看暴露的指标，示例指标包括：

pg_database_size_bytes{database="postgres"} 12582912
pg_table_size_bytes{database="postgres",schema="public",table="users"} 20480

Prometheus 配置

在Prometheus配置文件中添加如下job：

yaml
scrape_configs:
  - job_name: 'pgexport'
    static_configs:
      - targets: ['pgexport:9289']