CHIME/FRB Monitor and Control Master Docker镜像文档

1. 镜像概述

本Docker镜像专为CHIME（Canadian Hydrogen Intensity Mapping Experiment）/FRB（Fast Radio Burst）项目设计，作为监控与控制主节点（Monitor and Control Master），负责协调和管理CHIME/FRB射电望远镜系统的各个组件，确保FRB探测系统的稳定运行和高效数据处理。

2. 核心功能与特性

2.1 核心功能

实时监控CHIME/FRB系统各组件（天线阵列、信号处理器、数据存储单元等）的运行状态
集中化数据采集与处理，整合系统关键指标（温度、电压、数据流量、处理延迟等）
支持设备远程控制操作，包括参数配置、组件启停及故障恢复
系统日志记录与异常告警，实时反馈故障信息并触发告警机制
与CHIME/FRB数据处理 pipeline 无缝集成，确保数据流转与处理的协调性

2.2 主要特性

轻量化设计：基于Alpine Linux构建，容器体积小，资源占用低
模块化架构：支持功能组件按需扩展，适配不同实验需求
标准化接口：内置REST API接口，便于与外部监控系统集成
高可用性：支持多节点部署模式，避免单点故障
协议兼容：兼容CHIME/FRB项目标准通信协议（如gRPC、MQTT）

3. 使用场景与适用范围

3.1 主要使用场景

CHIME/FRB射电望远镜实验设施的日常运维监控
FRB探测过程中的实时数据状态跟踪与质量评估
系统故障诊断与远程修复操作
多组件协同工作的集中化管理与调度
实验数据采集与处理流程的实时协调控制

3.2 适用范围

CHIME/FRB项目科研团队及系统运维人员
射电天文观测设施中类似分布式系统的监控与控制场景
需要集中化管理远程设备集群的科研实验环境

4. 使用方法与配置说明

4.1 基本启动命令

bash
docker run -d \
  --name chime-frb-monitor-master \
  --network=host \
  -p 8080:8080 \
  -v /local/config:/app/config \
  -v /local/logs:/app/logs \
  -e CONTROL_API_PORT=8080 \
  -e MONITOR_INTERVAL=5 \
  -e LOG_LEVEL=INFO \
  -e DB_HOST=192.168.1.100 \
  chimefrb/monitor-control-master:latest

4.2 环境变量配置

环境变量	描述	默认值	数据类型
`CONTROL_API_PORT`	控制API服务监听端口	8080	整数
`MONITOR_INTERVAL`	系统状态监控采样间隔（秒）	5	整数
`LOG_LEVEL`	日志输出级别	INFO	字符串（DEBUG/INFO/WARN/ERROR）
`DB_HOST`	后端监控数据库主机地址	localhost	字符串
`DB_PORT`	后端数据库服务端口	5432	整数
`DB_USER`	数据库访问用户名	monitor	字符串
`DB_PASSWORD`	数据库访问密码	无	字符串
`ALERT_EMAIL`	异常告警接收***地址	无	字符串（多个用逗号分隔）
`MAX_RETRY_COUNT`	组件连接失败重试次数	3	整数

4.3 数据卷挂载要求

容器内路径	描述	宿主机路径示例	挂载必要性
`/app/config`	系统配置文件目录，包含组件连接信息、监控指标定义等	`/opt/chime/monitor/config`	必要
`/app/logs`	运行日志存储目录	`/var/log/chime/monitor`	建议
`/app/data`	临时数据缓存目录	`/tmp/chime/monitor/data`	可选

4.4 服务状态验证

容器启动后，可通过以下方式验证服务状态：

健康检查端点：http://<容器IP>:<CONTROL_API_PORT>/health，返回 {"status": "healthy"} 表示服务正常
日志验证：查看 /app/logs/main.log，确认无启动错误日志
API验证：使用 curl http://<容器IP>:8080/api/v1/components 获取已连接组件列表