openebs/mayastor-obs-callhome-stats

Mayastor Callhome 统计模块镜像文档

镜像概述

Mayastor Callhome 统计模块是 Mayastor 存储系统的配套组件，专注于实时收集存储集群的运行统计数据，并通过预设机制自动上报至监控或管理平台。该模块旨在为运维人员提供存储系统的性能、容量及健康状态数据，支撑集群监控、性能调优与故障排查。

核心功能与特性

• 实时数据收集：持续采集 Mayastor 存储节点及卷的关键指标，包括 I/O 性能（吞吐量、延迟）、存储容量（已用/可用空间）、节点健康状态等。
• 自动上报机制：支持定时或触发式数据上报，可对接外部监控平台（如 Prometheus、自定义管理服务器）。
• 轻量级设计：资源占用低，不影响 Mayastor 核心存储服务的运行。
• 灵活配置：通过环境变量或配置文件自定义数据采集范围、上报频率及目标地址。

使用场景

• 存储集群监控：实时跟踪 Mayastor 集群的整体运行状态，确保服务稳定性。
• 性能分析：基于历史统计数据识别性能瓶颈，优化存储资源分配。
• 故障排查：结合上报的健康状态指标，快速定位存储节点或卷的异常问题。
• 容量规划：通过容量使用趋势数据，提前规划存储扩容需求。

使用方法

前置条件

• 已部署 Mayastor 存储集群，且模块可访问 Mayastor 控制平面（如 mayastor-csi 服务）。
• 目标上报平台（如监控服务器）已就绪，且网络可达。

快速启动（Docker Run）

bash
docker run -d \
  --name mayastor-callhome-stats \
  -e MAYASTOR_ENDPOINT="http://mayastor-control-plane:8080" \  # Mayastor 控制平面端点
  -e REPORT_INTERVAL="30s" \  # 数据上报间隔（默认 60s）
  -e CALLHOME_SERVER="https://monitoring-server:443/api/report" \  # 上报目标服务器地址
  -e LOG_LEVEL="info" \  # 日志级别（debug/info/warn/error，默认 info）
  mayastor/callhome-stats:latest

Docker Compose 配置

yaml
version: '3'
services:
  callhome-stats:
    image: mayastor/callhome-stats:latest
    container_name: mayastor-callhome-stats
    environment:
      - MAYASTOR_ENDPOINT=http://mayastor-control-plane:8080
      - REPORT_INTERVAL=30s
      - CALLHOME_SERVER=https://monitoring-server:443/api/report
      - LOG_LEVEL=info
    restart: unless-stopped
    network_mode: "host"  # 若需访问主机网络的 Mayastor 服务，可启用

配置说明

环境变量参数

数据持久化（可选）

若需保存本地统计数据日志，可挂载日志目录：

bash
docker run -d \
  --name mayastor-callhome-stats \
  -v /host/path/logs:/var/log/mayastor-callhome \  # 挂载日志目录
  -e LOG_FILE="/var/log/mayastor-callhome/stats.log" \  # 指定日志文件路径
  mayastor/callhome-stats:latest

注意事项

• 确保模块与 Mayastor 控制平面网络连通，否则无法采集数据。
• 调整 REPORT_INTERVAL 时需平衡监控实时性与网络/服务器负载。
• 生产环境建议启用 TLS_ENABLED 并配置证书，保障数据传输安全。