dbodky/dashing-icinga2

Dashing with Icinga 2 Docker镜像文档

镜像概述

http://shopify.github.io/dashing/ 是基于Sinatra的仪表盘框架，可构建美观的数据可视化界面。本Docker镜像将Dashing与Icinga 2监控系统集成，通过Icinga 2 API拉取监控数据，提供直观的监控状态展示。支持自定义数据采集任务、REST API数据推送、widget拖拽调整，并可嵌入Icinga Web 2的主机/服务问题列表作为iframe。

核心功能与特性

• Icinga 2 API集成：通过API获取监控状态、主机/服务对象数据及性能指标
• 多样化widget：包含Meter（计量器）、List（列表）、Simplelist（简易列表）、Simplemon（状态监控）等多种可视化组件
• 自定义配置：支持基本认证或客户端证书认证，可通过环境变量或配置文件调整参数
• iframe集成：嵌入Icinga Web 2的问题列表页面，实现监控详情快速访问
• 跨平台兼容：支持Linux、Unix、树莓派等设备，兼容Chrome、Firefox、Safari及新版Edge浏览器（不支持旧Edge和IE，因不支持SSE）

使用场景

• 运维监控中心：实时展示基础设施监控状态，包括主机/服务问题数量、检查频率、平均延迟等关键指标
• 办公室仪表盘：在大屏幕上展示核心业务系统健康状态，辅助团队快速响应故障
• 自定义监控面板：通过修改widget和数据采集任务，适配特定业务场景的监控需求

安装与使用

镜像获取

Docker镜像托管于Docker Hub：dbodky/dashing-icinga2，可直接拉取：

bash
docker pull dbodky/dashing-icinga2

快速启动

使用环境变量配置Icinga 2 API连接信息，映射容器端口（默认8005）：

bash
docker run -it -p 8005:8005 \
  -e ICINGA2_API_HOST='icinga2-server.example.com' \
  -e ICINGA2_API_PORT=5665 \
  -e ICINGA2_API_USERNAME='dashing' \
  -e ICINGA2_API_PASSWORD='your-api-password' \
  dbodky/dashing-icinga2

启动后访问 http://localhost:8005 即可查看仪表盘。

Docker Compose示例

创建docker-compose.yml：

yaml
version: '3'
services:
  dashing-icinga2:
    image: dbodky/dashing-icinga2
    ports:
      - "8005:8005"
    environment:
      - ICINGA2_API_HOST=icinga2-server.example.com
      - ICINGA2_API_PORT=5665
      - ICINGA2_API_USERNAME=dashing
      - ICINGA2_API_PASSWORD=your-api-password
      - ICINGAWEB2_URL=http://icinga2-server.example.com/icingaweb2
      - DASHBOARD_TIMEZONE=Asia/Shanghai
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置说明

环境变量

通过环境变量配置容器，优先级高于配置文件：

配置文件

如需复杂配置，可通过挂载配置文件覆盖默认设置。容器内配置文件路径为/app/config/icinga2.local.json，示例：

json
{
  "icinga2": {
    "api": {
      "host": "icinga2-server.example.com",
      "port": 5665,
      "user": "dashing",
      "password": "your-api-password"
    }
  },
  "icingaweb2": {
    "url": "http://icinga2-server.example.com/icingaweb2"
  },
  "dashboard": {
    "show_only_hard_state_problems": false,
    "timezone": "Asia/Shanghai"
  }
}

挂载配置文件启动：

bash
docker run -it -p 8005:8005 \
  -v /local/path/to/icinga2.local.json:/app/config/icinga2.local.json \
  dbodky/dashing-icinga2

Icinga 2 API配置

需在Icinga 2中创建API用户并授权，编辑Icinga 2配置文件（如/etc/icinga2/conf.d/api-users.conf）：

icinga2
object ApiUser "dashing" {
  password = "your-api-password"
  permissions = [ "status/query", "objects/query/*" ] // 只读权限，满足数据拉取需求
}

重启Icinga 2使配置生效：

bash
systemctl restart icinga2

故障排除

Widget不更新

• 检查浏览器开发者工具控制台是否有JavaScript错误
• 查看容器日志：docker logs <container-id>，确认Icinga 2 API连接是否正常
• 前台运行容器调试：docker run -it --rm ... dbodky/dashing-icinga2 bash，手动执行./start.sh观察输出

API连接错误

• 验证Icinga 2 API是否可访问：curl -k -u dashing:your-api-password https://icinga2-server.example.com:5665/v1/status
• 确认环境变量或配置文件中的API主机、端口、用户名/密码是否正确
• 若使用证书认证，检查证书路径及节点名称是否匹配

端口不可达

• 确认容器端口映射正确（默认8005）
• 检查主机防火墙规则，允许8005端口访问

许可证

• 本项目作业、仪表盘及库代码：MIT许可证
• Dashing框架：https://github.com/Shopify/dashing/blob/master/MIT-LICENSE
• Chart.js：https://github.com/chartjs/Chart.js/blob/master/LICENSE.md