openebs/mayastor-agent-ha-node

Mayastor I/O路径高可用监控服务镜像

概述

该镜像为Mayastor存储系统控制平面的核心组件之一，专注于监控存储I/O路径的高可用性（HA）。通过实时跟踪I/O路径状态、检测异常并触发响应机制，保障Mayastor存储集群中数据读写路径的持续稳定，是构建可靠存储基础设施的关键服务。

核心功能与特性

• 实时I/O路径监控：持续跟踪存储I/O路径的连接状态、吞吐量、延迟等关键指标，提供实时状态视图。
• 故障检测与告警：自动识别I/O路径故障（如链路中断、节点异常），支持通过标准接口（如Prometheus、告警管理器）输出告警信息。
• 高可用保障机制：与Mayastor控制平面协同，在检测到路径故障时，协助触发路径切换或故障转移流程，减少服务中断时间。
• 轻量化设计：资源占用低，适合在容器化环境中高效部署，与Kubernetes等编排平台兼容。

使用场景

• Mayastor存储集群部署：作为Mayastor控制平面的必要组件，需与Mayastor其他控制平面服务（如卷管理器、调度器）协同运行。
• 关键业务存储环境：适用于对存储I/O连续性要求高的场景（如数据库、分布式文件系统），确保业务无感知应对I/O路径故障。
• 大规模存储基础设施：在多节点、多路径的存储架构中，提供集中化的I/O路径监控与管理能力。

使用方法

基础部署（Docker Run）

bash
docker run -d \
  --name mayastor-io-monitor \
  --network mayastor-control-plane \  # 连接至Mayastor控制平面网络
  -v /path/to/config:/etc/mayastor/monitor \  # 挂载配置文件目录
  -e LOG_LEVEL=info \
  -e CONTROL_PLANE_ADDR=mayastor-control-plane:50051 \
  -e MONITOR_INTERVAL=5s \
  mayastor/io-path-ha-monitor:latest

Docker Compose部署

yaml
version: '3.8'
services:
  io-monitor:
    image: mayastor/io-path-ha-monitor:latest
    container_name: mayastor-io-monitor
    networks:
      - mayastor-control-plane
    volumes:
      - ./config:/etc/mayastor/monitor
    environment:
      - LOG_LEVEL=info
      - CONTROL_PLANE_ADDR=mayastor-control-plane:50051
      - MONITOR_INTERVAL=5s
      - ALERT_ENDPOINT=http://alertmanager:9093/api/v2/alerts

networks:
  mayastor-control-plane:
    external: true  # 需提前创建Mayastor控制平面网络

配置参数

环境变量

配置文件

配置文件（默认路径/etc/mayastor/monitor/config.yaml）支持自定义监控规则（如路径健康阈值、告警触发条件），示例：

yaml
monitor:
  paths:
    - name: path-0
      endpoints: ["node1:3000", "node2:3000"]  # 监控的I/O路径端点
  thresholds:
    latency_warn: 100ms  # 延迟警告阈值
    latency_crit: 500ms  # 延迟 critical 阈值
    throughput_min: 10MB/s  # 最小吞吐量阈值

依赖说明

• 网络依赖：需与Mayastor控制平面服务（gRPC接口）通信，确保网络连通性。
• 存储依赖：无需持久化存储（配置文件可通过外部挂载提供），但需访问主机或容器内的I/O路径状态接口。
• 版本兼容性：需与部署的Mayastor版本匹配（具体版本对应关系参见Mayastor官方文档）。