goforbroke1006/postgres-exporter

postgres-exporter

概述

postgres-exporter是一个自定义实现的PostgreSQL导出器，专注于死元组统计功能。它能够收集PostgreSQL数据库中的死元组相关指标，并通过HTTP端点暴露，支持与Grafana集成实现可视化监控。

核心功能与特性

• 提供死元组统计的自定义实现
• 暴露metrics HTTP端点，便于监控系统采集指标
• 包含Grafana仪表板配置文件（dashboard.json），支持快速可视化

使用场景

适用于需要监控PostgreSQL数据库死元组状态的场景，帮助数据库管理员(DBA)或开发人员及时了解数据库表的死元组情况，为数据库性能优化提供数据支持。

使用方法与配置说明

基本使用

通过Docker容器运行，需指定监听地址端口和PostgreSQL目标数据库连接信息。

Docker Run命令示例

bash
docker run --name=pg-exporter -it --rm --network=host \
    goforbroke1006/postgres-exporter \
    --addr=0.0.0.0:54380 --target=postgresql://db_user:db_pass@localhost:5432/db_name?sslmode=disable

参数说明

• --addr: 导出器监听地址和端口，格式为IP:端口。示例中0.0.0.0:54380表示监听所有网络接口的54380端口
• --target: PostgreSQL数据库连接URL，格式为postgresql://用户名:密码@主机:端口/数据库名?参数。示例中sslmode=disable表示禁用SSL连接

访问指标

容器启动后，通过以下URL访问暴露的指标数据：

http://localhost:54380/metrics

Grafana集成

1. 获取项目中的dashboard.json文件
2. 在Grafana中导入该JSON文件创建仪表板
3. 配置Grafana数据源指向当前exporter的metrics端点（即http://localhost:54380/metrics）
4. 完成配置后即可在Grafana中查看死元组统计可视化数据