Ceph Exporter 镜像文档

镜像概述和主要用途

Ceph Exporter是一个Prometheus exporter，用于采集运行中的Ceph集群元信息。它通过与Ceph监控器交互，使用rados_mon_command()的封装接口实现信息收集，无需对Ceph集群进行额外配置，仅需集群正常运行即可工作。

核心功能和特性

• 自动信息采集：通过Ceph监控器接口自动获取集群元信息，无需额外集群设置
• Ceph客户端**：基于Ceph**Golang客户端（go-ceph）实现集群命令交互
• 配置自动发现：支持Ceph默认配置文件路径，自动识别ceph.conf和keyring文件
• 灵活配置：可通过命令行参数自定义监听地址、指标路径及配置文件位置
• Prometheus兼容：暴露标准Prometheus指标接口，支持Prometheus采集和监控

使用场景和适用范围

• 监控对象：Ceph集群（仅在Hammer v0.94和Jewel v10.2版本测试通过，不保证与旧版本或非LTS版本兼容）
• 部署位置：需部署在能与Ceph集群通信的客户端节点（具备Ceph客户端访问权限）
• 集成系统：作为Prometheus监控栈的一部分，用于收集和暴露Ceph集群指标

详细的使用方法和配置说明

依赖要求

运行Ceph Exporter需满足以下条件：

1. 配置文件：ceph.conf（包含Ceph集群配置）
2. 认证文件：ceph.<user>.keyring（用于集群认证，如ceph.client.admin.keyring）

上述文件需放置在Ceph默认配置路径（如/etc/ceph/、/etc/、/usr/local/etc/ceph/等，详见Ceph配置文件文档），或通过--ceph.config参数手动指定路径。

命令行参数

Docker部署方案

构建镜像

bash
docker build -t digitalocean/ceph_exporter .

运行容器

基本运行命令（挂载本地Ceph配置目录）：

bash
docker run -d \
  -v /etc/ceph:/etc/ceph \  # 挂载包含ceph.conf和keyring的目录
  -p 9128:9128 \             # 映射指标端口
  --name ceph-exporter \
  digitalocean/ceph_exporter

主机网络模式（如需直接使用主机网络栈访问Ceph监控器）：

bash
docker run -d \
  -v /etc/ceph:/etc/ceph \
  --net=host \               # 使用主机网络模式
  --name ceph-exporter \
  digitalocean/ceph_exporter

Docker Compose配置示例

yaml
version: '3'
services:
  ceph-exporter:
    image: digitalocean/ceph_exporter
    volumes:
      - /etc/ceph:/etc/ceph:ro  # 只读挂载Ceph配置目录
    ports:
      - "9128:9128"
    # 如需主机网络，取消以下注释
    # network_mode: "host"
    restart: unless-stopped
    command: ["--telemetry.addr=:9128", "--telemetry.path=/metrics"]

配置说明

配置文件路径

Ceph Exporter会自动在Ceph默认配置路径中查找ceph.conf和keyring文件。若文件位于非默认路径，需通过--ceph.config参数指定配置文件路径：

bash
docker run -v /custom/ceph:/custom/ceph -p 9128:9128 digitalocean/ceph_exporter --ceph.config=/custom/ceph/ceph.conf

指标接口自定义

可通过命令行参数修改Exporter监听地址和指标路径：

bash
# 自定义监听地址和指标路径
docker run -v /etc/ceph:/etc/ceph digitalocean/ceph_exporter \
  --telemetry.addr=:9129 \    # 监听9129端口
  --telemetry.path=/ceph-metrics  # 指标路径为/ceph-metrics

注意事项

• Ceph版本兼容性：仅在Ceph Hammer（v0.94）和Jewel（v10.2）版本测试通过，不建议用于旧版本或非LTS版本
• 网络访问：确保Exporter所在容器能与Ceph监控器网络互通，必要时使用--net=host模式
• 权限配置：keyring文件需包含具有足够权限的Ceph用户（如client.admin），确保能执行集群信息查询命令