thiagoguaru/alerthawk.monitoring

AlertHawk监控服务镜像

镜像概述

AlertHawk监控服务镜像是专为AlertHawk系统设计的监控组件，用于实时监控AlertHawk系统各模块的运行状态、关键性能指标及告警事件。该服务通过高效采集、处理监控数据，提供直观的可视化监控面板，并支持多渠道告警通知，帮助管理员及时掌握系统健康状况并快速响应异常。

核心功能与特性

实时指标监控

• 持续采集AlertHawk系统核心组件（API服务、数据处理模块、存储服务等）的关键指标，包括CPU使用率、内存占用、请求吞吐量、响应延迟、错误率等
• 支持自定义指标采集规则，满足特定业务监控需求
• 采用低侵入式数据采集机制，最小化对被监控系统的性能影响

多维度监控视角

• 提供系统级、服务级、接口级等多层级监控视图
• 支持按模块、按实例、按时间维度的指标聚合与分析
• 内置常用监控模板，覆盖AlertHawk典型部署场景

智能告警机制

• 支持静态阈值告警、动态基线告警、异常模式识别等多种告警规则
• 集成邮件、短信、Slack、Webhook等多渠道告警通知
• 提供告警级别分类（信息、警告、严重、紧急）及告警抑制功能，避免告警风暴

可视化监控面板

• 内置开箱即用的监控仪表盘，展示系统健康状态、性能趋势及告警统计
• 支持自定义仪表盘配置，可拖拽式编辑图表布局与指标组合
• 提供数据导出功能，支持CSV/JSON格式的指标数据下载

历史数据管理

• 支持本地SQLite或外部时序数据库（InfluxDB、Prometheus）存储历史监控数据
• 提供数据保留策略配置，支持自动清理过期数据
• 支持历史数据查询与趋势分析，辅助性能优化决策

使用场景与适用范围

系统运维监控

• 适用于部署AlertHawk的生产环境，实时监控系统整体健康状态
• 支持7x24小时无人值守监控，及时发现并预警系统异常

性能优化分析

• 用于AlertHawk系统性能瓶颈排查，通过历史指标趋势定位性能问题根源
• 支持对比分析不同版本/配置下的系统性能表现

告警事件管理

• 集中管理AlertHawk系统产生的告警事件，提供告警生命周期跟踪
• 支持告警分派与处理状态记录，优化团队协作效率

合规审计支持

• 提供监控数据历史记录，满足系统运行状态审计与合规性要求

使用方法与配置说明

快速启动命令

bash
docker run -d \
  --name alerthawk-monitor \
  -p 8080:8080 \  # 监控面板Web端口
  -p 9090:9090 \  # 指标采集端口
  -e ALERTHAWK_API_ENDPOINT=http://alerthawk-api:8081 \  # AlertHawk API服务地址
  -e DB_TYPE=sqlite \  # 数据存储类型：sqlite/influxdb/prometheus
  -e ALERT_CHANNELS=email,slack \  # 启用的告警渠道（逗号分隔）
  -v /host/path/config:/app/config \  # 挂载自定义配置文件
  -v alerthawk-monitor-data:/app/data \  # 持久化存储监控数据
  alerthawk/monitor:latest

核心环境变量配置

配置文件说明

通过挂载/app/config目录自定义配置（支持YAML/JSON格式），典型配置示例：

yaml
# 监控指标配置
metrics:
  collection_interval: 10s  # 指标采集间隔
  scrape_timeout: 5s        # 采集超时时间
  include_metrics:          # 需采集的指标列表（留空表示全部）
    - api_requests_total
    - service_health_status

# 告警规则配置
alerts:
  - name: high_error_rate
    description: API错误率超过阈值
    metric: api_error_rate
    condition: value > 5%
    severity: critical
    channels: [email, slack]
    threshold: 5%
    evaluation_period: 2m  # 持续2分钟满足条件触发告警

# 告警渠道配置
alert_channels:
  email:
    smtp_server: smtp.example.com
    smtp_port: 587
    username: alert@example.com
    password: your-email-password
    recipients: ["admin@example.com", "dev@example.com"]
  slack:
    webhook_url: https://hooks.slack.com/services/XXX/XXX/XXX
    channel: #alerthawk-alerts

访问监控面板

容器启动后，通过浏览器访问 http://<宿主机IP>:8080 打开监控面板：

• 默认登录凭据：用户名admin，密码admin（首次登录需强制修改）
• 面板包含系统概览、服务状态、指标趋势、告警列表等核心功能模块

数据持久化配置

为避免容器重启导致监控数据丢失，建议挂载数据卷：

bash
docker volume create alerthawk-monitor-data
docker run -d \
  --name alerthawk-monitor \
  -v alerthawk-monitor-data:/app/data \  # 挂载数据卷
  # 其他参数...
  alerthawk/monitor:latest

注意事项

• 确保监控服务与AlertHawk系统网络互通，防火墙需开放指标采集端口（默认9090）
• 生产环境建议使用外部时序数据库（如InfluxDB）存储监控数据，提升性能与可靠性
• 定期备份监控数据卷，防止数据损坏或丢失
• 首次部署后需通过监控面板"系统设置"页面配置告警渠道参数，确保告警通知正常发送