openitcockpit/checkmk

概述

Checkmk RAW 是 Checkmk 监控套件的开源版本，基于 Checkmk 核心技术构建，提供全面的 IT 基础设施监控能力，无需商业许可即可免费使用。该镜像封装了 Checkmk RAW 版本的完整运行环境，包含监控服务器、Web 管理界面和数据存储组件，可快速部署并投入使用，帮助用户实时掌握 IT 资源状态。

核心功能

1. 自动发现 IT 资源

• 支持自动扫描和发现网络中的服务器、网络设备、应用程序等 IT 资源，减少手动配置工作量。

2. 多平台监控支持

• 覆盖服务器（Linux、Windows、AIX、Solaris 等）、网络设备（交换机、路由器、防火墙）、存储系统、云服务（AWS、Azure、GCP）、容器（Docker、Kubernetes）及应用程序（HTTP、数据库、中间件等）。

3. 灵活的告警管理

• 支持多级别告警规则配置，可通过邮件、短信、Slack、PagerDuty 等多种渠道发送告警通知，支持告警抑制和升级策略。

4. 可视化与报表

• 内置实时监控仪表盘，展示关键指标（CPU、内存、磁盘、网络等）；支持自定义报表生成，包含趋势分析、可用性统计等数据可视化功能。

5. 可扩展性

• 提供插件系统，支持通过自定义检查插件扩展监控能力；支持 REST API，可与第三方系统（如 ITSM 工具、自动化平台）集成。

使用场景

1. 中小企业 IT 基础设施监控

适用于缺乏专业监控团队的中小企业，通过单一平台实现对服务器、网络、应用的集中监控，降低运维复杂度。

2. 混合云/多云环境监控

支持同时监控本地数据中心资源与公有云服务，统一管理混合 IT 环境的可用性和性能。

3. 开发/测试环境监控

为开发和测试团队提供轻量级监控方案，实时跟踪测试环境资源状态，助力问题排查和性能优化。

4. 边缘计算节点监控

可部署在边缘环境，监控分布式边缘节点的硬件状态和应用运行情况，满足边缘计算场景的监控需求。

使用方法

基本部署（Docker Run）

通过以下命令快速启动 Checkmk RAW 容器：

bash
docker run -d \
  --name checkmk-raw \
  -p 8080:5000 \  # Web 界面端口映射（宿主机:容器）
  -v checkmk_data:/omd/sites \  # 持久化存储卷（保存配置和监控数据）
  -e TZ=Asia/Shanghai \  # 设置时区（默认 UTC）
  checkmk/check-mk-raw:latest

说明：

• 首次启动时，容器会自动创建监控站点，管理员用户名默认为 cmkadmin。
• 初始密码需通过容器日志获取：docker logs checkmk-raw | grep "initial password"。
• 访问 http://<宿主机IP>:8080 打开 Web 界面，使用管理员账号登录。

Docker Compose 部署

创建 docker-compose.yml 文件，配置更灵活的部署：

yaml
version: '3.8'
services:
  checkmk:
    image: docker.xuanyuan.run/checkmk/check-mk-raw:latest
    container_name: checkmk-raw
    restart: always  # 容器退出时自动重启
    ports:
      - "8080:5000"
    volumes:
      - checkmk_data:/omd/sites  # 持久化卷
      - /etc/localtime:/etc/localtime:ro  # 同步宿主机时区（替代 TZ 环境变量）
    environment:
      - CMK_SITE_ID=monitoring  # 自定义站点 ID（默认 "cmk"）
      # - CMK_ADMIN_PASSWORD=MySecurePassword123  # 可选：手动设置管理员密码（建议生产环境使用）
    networks:
      - monitoring_network  # 自定义网络（可选，用于与其他容器通信）

volumes:
  checkmk_data:  # 自动创建命名卷（数据持久化）

networks:
  monitoring_network:  # 可选：创建独立网络隔离监控流量

启动容器：

bash
docker-compose up -d

环境变量说明

持久化存储

监控配置、历史数据、插件等信息需通过卷持久化，避免容器删除后数据丢失。推荐使用命名卷（如上述示例中的 checkmk_data），而非宿主机目录挂载（减少权限问题）。

升级镜像

1. 停止并备份当前容器数据：

   bash
   docker stop checkmk-raw
   docker rename checkmk-raw checkmk-raw-backup  # 备份容器（可选）
   

2. 拉取最新镜像并启动新容器（复用原持久化卷）：

   bash
   docker pull docker.xuanyuan.run/checkmk/check-mk-raw:latest
   docker run -d \
     --name checkmk-raw \
     -p 8080:5000 \
     -v checkmk_data:/omd/sites \
     -e TZ=Asia/Shanghai \
     docker.xuanyuan.run/checkmk/check-mk-raw:latest
   

3. 验证新容器正常运行后，可删除备份容器：docker rm checkmk-raw-backup。

配置 Web 界面

1. 登录 Web 界面：访问 http://<宿主机IP>:8080，输入管理员账号和密码。
2. 添加监控对象：通过 "配置" > "主机" > "添加主机" 输入目标设备 IP/主机名，启用自动发现。
3. 配置告警规则：在 "配置" > "通知" 中设置告警接收方式（邮件、Slack 等）及触发条件。
4. 查看监控数据：通过 "监控" > "概览" 或自定义仪表盘查看实时监控指标和历史趋势。