ceph-grafana 容器镜像文档

1. 镜像概述和主要用途

ceph-grafana 容器镜像是基于 Grafana 6.x 构建的专用镜像，旨在为 Ceph 集群的 dashboard UI 提供兼容的监控可视化环境。该镜像预集成了 Ceph dashboard UI 所需的仪表盘（dashboards）及插件，确保与 Ceph 集群监控系统无缝对接，简化 Ceph 集群监控的部署流程。

2. 核心功能和特性

• Grafana 6.x 基础环境：基于稳定版 Grafana 6.x 构建，提供成熟的监控数据可视化能力。
• Ceph dashboard UI 专用仪表盘：预配置 Ceph dashboard UI 所需的监控仪表盘，无需手动导入即可直接使用。
• 集成关键插件：包含 status panel 和 pie chart 插件，满足 Ceph 集群监控中特定指标的展示需求（如状态指示、资源占比饼图等）。
• Ceph 兼容性：与 Ceph dashboard UI 深度兼容，确保监控数据流转和展示正常。

3. 使用场景和适用范围

3.1 使用场景

• 部署 Ceph 分布式存储集群时，需通过 Ceph dashboard UI 监控集群状态、性能指标（如 OSD 状态、PG 分布、吞吐量等）的场景。
• 需要快速搭建与 Ceph dashboard UI 配套的 Grafana 环境，避免手动配置仪表盘和插件的场景。

3.2 适用范围

• Ceph 集群管理员、运维工程师及 DevOps 团队。
• 需通过可视化界面监控 Ceph 集群运行状态的技术人员。

4. 使用方法和配置说明

4.1 Docker 命令行部署

通过 docker run 命令直接启动容器，需映射必要端口并挂载数据卷以持久化配置：

docker run -d \
  --name ceph-grafana \
  -p 3000:3000 \  # Grafana 默认 HTTP 端口
  -v /path/on/host/grafana-data:/var/lib/grafana \  # 持久化 Grafana 数据（配置、仪表盘等）
  -e GF_SECURITY_ADMIN_PASSWORD=strong_password \  # 设置 Grafana 管理员密码
  ceph/ceph-grafana:latest

说明：

• /path/on/host/grafana-data 需替换为宿主机实际路径，用于持久化 Grafana 配置及数据，避免容器重启后丢失。
• GF_SECURITY_ADMIN_PASSWORD 为 Grafana 管理员密码，建议设置强密码。

4.2 Docker Compose 部署

通过 docker-compose.yml 配置文件定义服务，便于管理多容器协同部署（如与 Ceph 其他组件联动）：

version: '3'
services:
  ceph-grafana:
    image: ceph/ceph-grafana:latest
    container_name: ceph-grafana
    ports:
      - "3000:3000"
    volumes:
      - /path/on/host/grafana-data:/var/lib/grafana
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=strong_password
      - GF_SERVER_HTTP_PORT=3000  # 可自定义 Grafana 服务端口（需同步映射宿主机端口）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动命令：

docker-compose up -d

4.3 配置参数说明

4.3.1 核心环境变量

4.3.2 数据卷挂载

• 必须挂载：/var/lib/grafana（持久化配置、仪表盘、插件等数据）。
• 可选挂载：/etc/grafana（自定义 Grafana 主配置文件 grafana.ini）。

4.4 与 Ceph dashboard UI 集成

1. 确保 ceph-grafana 容器与 Ceph 集群网络互通（可通过同一 Docker 网络或主机网络实现）。
2. 在 Ceph dashboard UI 配置中，指定 Grafana 服务地址（如 [***] 或宿主机 IP:3000）。
3. 验证集成：访问 Ceph dashboard UI 的监控页面，确认可正常加载 Grafana 仪表盘。