socialwifi/postgres-exporter

postgres-exporter 镜像文档

镜像概述

本Docker镜像基于https://github.com/wrouesnel/postgres_exporter%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%86%85%E7%BD%AE%E9%BB%98%E8%AE%A4%E7%9A%84https://github.com/wrouesnel/postgres_exporter/blob/master/queries.yaml%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9BPostgreSQL%E6%95%B0%E6%8D%AE%E5%BA%93%E6%8C%87%E6%A0%87%E5%AF%BC%E5%87%BA%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%8F%AF%E5%B0%86%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%90%E8%A1%8C%E7%8A%B6%E6%80%81%E3%80%81%E6%80%A7%E8%83%BD%E6%95%B0%E6%8D%AE%E7%AD%89%E6%8C%87%E6%A0%87%E8%BD%AC%E6%8D%A2%E4%B8%BAPrometheus%E5%85%BC%E5%AE%B9%E6%A0%BC%E5%BC%8F%EF%BC%8C%E4%BE%BF%E4%BA%8E%E9%9B%86%E6%88%90%E5%88%B0%E7%9B%91%E6%8E%A7%E7%B3%BB%E7%BB%9F%E4%B8%AD%E3%80%82

核心功能与特性

• 指标收集：支持收集PostgreSQL关键指标，包括连接数、查询执行情况、表大小、索引使用效率等
• 预配置查询：内置queries.yml文件，包含常用监控指标查询，开箱即用
• Prometheus兼容：输出符合Prometheus格式的指标数据，可直接被Prometheus抓取
• 灵活配置：支持通过环境变量或自定义配置文件调整监控参数

使用场景与适用范围

• PostgreSQL数据库性能监控与分析
• 数据库运行状态实时监控告警
• 集成Prometheus+Grafana构建数据库监控仪表盘
• 适用于开发、测试及生产环境的PostgreSQL实例监控

使用方法与配置说明

环境变量配置

Docker Run 部署示例

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

Docker Compose 配置示例

yaml
version: '3'
services:
  postgres-exporter:
    image: postgres-exporter
    container_name: postgres-exporter
    ports:
      - "9187:9187"
    environment:
      - DATA_SOURCE_NAME=postgresql://postgres:password@postgres:5432/postgres?sslmode=disable
    depends_on:
      - postgres
  postgres:
    image: postgres:14
    environment:
      - POSTGRES_PASSWORD=password

访问指标

启动容器后，可通过 http://<容器IP>:9187/metrics 访问导出的指标数据，Prometheus可配置该地址进行指标抓取。