tkhh/postgres-exporter

PostgreSQL Exporter (启用collector.stat_statements)

镜像概述

该镜像基于Postgres Exporter构建，默认启用collector.stat_statements收集器，专门用于从PostgreSQL数据库中收集pg_stat_statements扩展提供的查询性能统计数据，并将指标以Prometheus兼容格式暴露，便于监控和分析数据库查询效率。

核心功能与特性

• 查询性能数据收集：通过pg_stat_statements扩展收集SQL语句执行次数、执行时间、I/O消耗等关键指标
• 标准指标支持：同时提供PostgreSQL基础监控指标（连接数、锁状态、事务统计等）
• Prometheus兼容：默认在9187端口暴露/metrics端点，可直接被Prometheus抓取
• 灵活配置：支持通过环境变量或配置文件自定义数据库连接参数和指标收集规则

使用场景

• 生产环境PostgreSQL数据库的查询性能监控与优化
• SQL语句执行效率分析与慢查询定位
• 数据库性能瓶颈识别与容量规划
• 与Grafana等可视化工具结合构建数据库监控面板

使用方法

基本使用（Docker Run）

bash
docker run -d \
  --name postgres-exporter \
  -p 9187:9187 \
  -e DATA_SOURCE_NAME="postgresql://user:password@postgres-host:5432/dbname?sslmode=disable" \
  -e PG_EXPORTER_ENABLED_COLLECTORS="stat_statements" \
  postgres-exporter:latest

Docker Compose配置

yaml
version: '3'
services:
  postgres-exporter:
    image: postgres-exporter:latest
    ports:
      - "9187:9187"
    environment:
      - DATA_SOURCE_NAME=postgresql://user:password@postgres:5432/dbname?sslmode=disable
      - PG_EXPORTER_ENABLED_COLLECTORS=stat_statements
      - PG_EXPORTER_EXTEND_QUERY_PATH=/etc/postgres-exporter/queries.yaml
    volumes:
      - ./custom-queries.yaml:/etc/postgres-exporter/queries.yaml
    depends_on:
      - postgres

环境变量配置

前置条件

使用该镜像前，需确保目标PostgreSQL数据库已安装并启用pg_stat_statements扩展：

sql
-- 在目标数据库中执行
CREATE EXTENSION pg_stat_statements;
-- 配置postgresql.conf
shared_preload_libraries = 'pg_stat_statements'
pg_stat_statements.track = all

指标示例

暴露的主要pg_stat_statements相关指标包括：

• pg_stat_statements_calls：SQL语句执行次数
• pg_stat_statements_total_time_seconds：总执行时间（秒）
• pg_stat_statements_mean_time_seconds：平均执行时间（秒）
• pg_stat_statements_rows：返回的总行数
• pg_stat_statements_blks_hit：缓冲区命中次数
• pg_stat_statements_blks_read：物理磁盘读取次数