achar007/postgres-exporter

PostgreSQL Exporter Docker镜像文档

镜像概述

本镜像为PostgreSQL Exporter的Docker化部署版本，基于https://github.com/vigneshkumar2016/postgres_exporter.git%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E3%80%82%E4%B8%BB%E8%A6%81%E5%8A%9F%E8%83%BD%E6%98%AF%E4%BB%8EPostgreSQL%E6%95%B0%E6%8D%AE%E5%BA%93%E4%B8%AD%E6%94%B6%E9%9B%86%E5%85%B3%E9%94%AE%E6%80%A7%E8%83%BD%E6%8C%87%E6%A0%87%EF%BC%88%E5%A6%82%E8%BF%9E%E6%8E%A5%E6%95%B0%E3%80%81%E6%9F%A5%E8%AF%A2%E6%89%A7%E8%A1%8C%E6%83%85%E5%86%B5%E3%80%81%E8%A1%A8%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%89%EF%BC%8C%E5%B9%B6%E4%BB%A5Prometheus%E5%85%BC%E5%AE%B9%E6%A0%BC%E5%BC%8F%E6%9A%B4%E9%9C%B2%E6%8C%87%E6%A0%87%E7%AB%AF%E7%82%B9%EF%BC%8C%E4%BE%BF%E4%BA%8EPrometheus%E8%BF%9B%E8%A1%8C%E6%95%B0%E6%8D%AE%E9%87%87%E9%9B%86%E5%92%8C%E7%9B%91%E6%8E%A7%E5%91%8A%E8%AD%A6%E3%80%82

核心功能与特性

• 指标收集：支持收集PostgreSQL数据库的各类核心指标，包括连接状态、查询性能、表空间使用、事务统计等
• 多架构支持：通过交叉编译支持多种架构（linux/amd64、linux/armv7、linux/arm64、linux/ppc64l）
• Prometheus兼容：指标输出格式符合Prometheus规范，可直接被Prometheus抓取
• 轻量级部署：基于Docker容器化部署，简化环境配置与依赖管理

使用场景

• PostgreSQL数据库性能监控与分析
• 数据库异常行为检测与告警
• 数据库资源使用趋势跟踪
• 多架构环境下的数据库监控部署

构建与部署指南

镜像构建步骤

1. 克隆源代码仓库

   bash
   git clone https://github.com/vigneshkumar2016/postgres_exporter.git
   cd postgres_exporter
   

2. 安装依赖环境

   bash
   # 安装Go环境
   apt install golang-1.20-go
   go version  # 验证Go安装版本
   
   # 安装Promu（Prometheus构建工具）
   wget https://github.com/prometheus/promu/releases/download/v0.15.0/promu-0.15.0.linux-amd64.tar.gz
   tar -zxvf promu-0.15.0.linux-amd64.tar.gz
   
   # 安装Docker环境
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   apt update
   apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
   

3. 编译与构建镜像

   bash
   # 编译应用
   make build
   
   # 交叉编译多架构版本
   promu-0.15.0.linux-amd64/promu crossbuild -p linux/amd64 -p linux/armv7 -p linux/arm64 -p linux/ppc64l
   
   # 构建Docker镜像
   make docker
   

4. 镜像推送（可选）

   bash
   docker login  # 登录Docker仓库
   docker tag prometheuscommunity/postgres-exporter-linux-amd64:master <your-docker-repo>/postgres-exporter:latest
   docker push <your-docker-repo>/postgres-exporter:latest
   

容器运行示例

基本运行命令

bash
docker run -d \
  --name postgres-exporter \
  -p 9187:9187 \  # 默认暴露端口
  -e DATA_SOURCE_NAME="postgresql://user:password@postgres-host:5432/dbname?sslmode=disable" \
  <your-docker-repo>/postgres-exporter:latest

Docker Compose配置示例

yaml
version: '3'
services:
  postgres-exporter:
    image: <your-docker-repo>/postgres-exporter:latest
    container_name: postgres-exporter
    ports:
      - "9187:9187"
    environment:
      - DATA_SOURCE_NAME=postgresql://user:password@postgres-host:5432/dbname?sslmode=disable
    restart: unless-stopped

配置说明

主要环境变量

指标访问

容器启动后，可通过 http://<container-ip>:9187/metrics 访问导出的Prometheus指标。

注意事项

• 确保PostgreSQL数据库允许Exporter访问（配置正确的用户权限和网络策略）
• 自定义查询需通过PG_EXPORTER_EXTEND_QUERY_PATH挂载查询配置文件
• 生产环境建议使用持久化配置，并设置适当的资源限制