ankane/pghero

PgHero

镜像概述

PgHero是一款专为PostgreSQL设计的性能仪表盘工具，旨在通过直观的可视化界面监控、分析和优化PostgreSQL数据库性能。它汇总关键性能指标，帮助数据库管理员和开发人员快速识别性能瓶颈，优化查询效率和资源利用。

核心功能与特性

• 实时性能监控：跟踪连接数、查询吞吐量、锁等待、事务状态等核心指标
• 慢查询分析：识别并展示执行缓慢的SQL查询，提供执行时间、调用频率等详细数据
• 索引优化建议：检测未使用或冗余索引，提供针对性优化建议
• 空间使用统计：可视化展示表、索引的磁盘空间占用情况
• 交互式界面：通过图表和表格清晰呈现性能数据，支持数据筛选与排序

使用场景与适用范围

• 数据库管理员：监控生产环境PostgreSQL性能，及时发现异常
• 开发人员：分析应用中的慢查询，优化SQL语句
• 运维团队：跟踪数据库资源使用趋势，规划扩容策略
• 性能审计：定期评估数据库健康状态，优化架构设计

使用方法与配置说明

前提条件

• 已安装Docker引擎
• 可访问的PostgreSQL数据库实例（需提供连接凭证）

基本部署（Docker Run）

通过以下命令快速启动PgHero容器，需指定PostgreSQL连接信息：

bash
docker run -d -p 8080:8080 \
  -e DATABASE_URL="postgres://用户名:密码@主机地址:端口/数据库名" \
  --name pghero \
  ankane/pghero

参数说明：

• -p 8080:8080：端口映射，主机端口:容器端口（默认容器端口为8080）
• -e DATABASE_URL：必填环境变量，PostgreSQL连接URL，格式为postgres://user:password@host:port/dbname
• --name pghero：自定义容器名称

Docker Compose配置

创建docker-compose.yml文件实现持久化部署：

yaml
version: '3'
services:
  pghero:
    image: ankane/pghero
    ports:
      - "8080:8080"  # 可修改主机端口（如9000:8080）
    environment:
      - DATABASE_URL=postgres://user:password@postgres-host:5432/mydb  # 替换为实际连接信息
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

访问与使用

容器启动后，通过浏览器访问 http://<主机IP>:8080 即可打开PgHero仪表盘，界面包含：

• 概览页：展示数据库关键性能指标汇总
• 查询分析：慢查询列表及详细执行信息
• 索引建议：优化索引的具体建议
• 空间分析：表和索引的磁盘占用统计

相关资源

• 在线演示
• https://github.com/ankane/pghero/blob/master/guides/Docker.md