crs4/lifemonitor

工作流测试与监控服务镜像

1. 镜像概述

1.1 主要用途

本Docker镜像提供工作流测试与监控服务，旨在帮助用户自动化验证工作流定义的正确性，实时监控工作流运行状态，及时发现并告警异常情况，确保工作流系统的稳定执行与高效管理。

2. 核心功能与特性

• 工作流自动化测试：支持定义测试用例，验证工作流节点逻辑、分支条件及数据流转的正确性，支持批量执行测试并生成结构化报告。
• 实时监控：实时采集工作流执行状态（运行中/成功/失败）、执行时长、节点耗时等关键指标，提供可视化仪表盘展示。
• 异常检测与告警：自动识别工作流执行超时、失败、资源超限等异常，支持邮件、Slack、Webhook等多渠道告警通知。
• 多引擎兼容：适配主流工作流引擎（如Apache Airflow、Camunda、Prefect），无需修改即可对接不同工作流系统。
• 轻量化部署：基于容器化设计，资源占用低，支持快速启停和横向扩展。

3. 使用场景与适用范围

• 企业级工作流运维：监控生产环境核心业务工作流（如订单处理、数据ETL），保障业务连续性。
• 开发环境测试：开发阶段验证工作流定义的正确性，减少上线后逻辑错误。
• CI/CD流水线集成：在CI/CD流程中自动执行工作流测试，确保部署前工作流配置无误。
• 多环境统一监控：集中管理开发、测试、生产等多环境的工作流运行状态。

4. 使用方法与配置说明

4.1 基本部署（Docker Run）

通过以下命令快速启动服务：

bash
docker run -d \
  --name workflow-monitor \
  -p 8080:8080 \  # Web访问端口
  -e MONITOR_TARGET=http://airflow:8080 \  # 目标工作流引擎地址
  -e ALERT_EMAIL=admin@example.com \  # 告警邮件接收地址
  -v ./test-cases:/app/test-cases \  # 挂载测试用例目录
  workflow-monitor:latest

4.2 Docker Compose配置

创建docker-compose.yml文件，配置更复杂的部署场景：

yaml
version: '3'
services:
  workflow-monitor:
    image: docker.xuanyuan.run/workflow-monitor:latest
    container_name: workflow-monitor
    ports:
      - "8080:8080"
    environment:
      - MONITOR_TARGET=http://airflow:8080
      - ALERT_EMAIL=admin@example.com
      - ALERT_SLACK_WEBHOOK=https://hooks.slack.com/services/XXX  # Slack告警Webhook
      - CHECK_INTERVAL=60  # 监控检查间隔（秒，默认60）
      - TEST_AUTO_RUN=true  # 是否自动运行测试用例（默认true）
    volumes:
      - ./test-cases:/app/test-cases  # 测试用例目录
      - ./config:/app/config  # 自定义配置文件目录
    restart: unless-stopped

启动命令：docker-compose up -d

4.3 环境变量配置

4.4 测试用例配置

测试用例需挂载至容器内/app/test-cases目录，支持JSON格式定义，示例：

json
{
  "test_case_id": "order_flow_001",
  "workflow_def": "order_processing_v2",
  "input_data": {"order_id": "TEST123", "amount": 100},
  "expected_output": {"status": "success", "step": "payment_completed"},
  "timeout": 300
}

5. 访问与使用

服务启动后，通过http://localhost:8080访问Web界面，可进行以下操作：

• 查看监控仪表盘：工作流执行状态、历史趋势、异常统计
• 管理测试用例：上传、编辑、手动触发测试
• 配置告警规则：设置告警阈值、通知渠道
• 导出报告：下载测试结果、监控数据报表