qk4l/zabbix-cachet

Zabbix-Cachet

镜像概述和主要用途

Zabbix-Cachet是一个Python脚本，用于实现Zabbix IT服务与Cachet之间的同步。其核心思想是提供最简单的方式将Zabbix数据导出到Cachet，通过Zabbix维护Cachet状态。该脚本读取预配置的Zabbix IT服务，自动创建Cachet组件，随后定期检查关联的Zabbix触发器，根据触发器状态管理Cachet事件和组件状态。脚本通过API接口与Zabbix和Cachet通信，需配置具有足够权限的Zabbix用户及Cachet API密钥。

核心功能和特性

• 自动创建Cachet组件和组件组
• 自动创建Cachet事件，并使用Zabbix确认消息更新事件
• 允许指定根IT服务，脚本仅处理该根服务下的层级结构

使用场景和适用范围

适用于需要将Zabbix监控的IT服务状态同步到Cachet状态页面的场景，例如企业IT服务可用性展示、运维状态公开等，帮助用户通过Cachet直观查看Zabbix监控的服务状态。

使用方法和配置说明

环境要求

已成功测试的版本：

• Cachet：2.2、2.3、2.4、2.5
• Zabbix：2.2、2.4、3.0、3.2、4.0、4.2、5.2
• Python：2.7+

安装方式

Docker安装

1. 基于config-example.yml创建/etc/zabbix-cachet.yml配置文件
2. 运行Docker容器：

   bash
   docker run --name zabbix-cachet -v /etc/zabbix-cachet.yml:/config.yml qk4l/zabbix-cachet
   

3. 等待启动完成（可选：喝杯茶）

Git安装

1. 克隆仓库
2. 将config-example.yml重命名为config.yml并填写配置
3. 安装requirements.txt中的Python依赖库
4. 启动脚本：zabbix-cachet.py

Apt安装

1. 添加官方Zabbix-Cachet PPA：

   bash
   add-apt-repository ppa:reg-tem4uk/zabbix-cachet
   apt-get update
   

2. 安装包：apt-get install zabbix-cachet
3. 配置：nano /etc/zabbix-cachet.yml
4. 重启服务：systemctl enable zabbix-cachet && systemctl restart zabbix-cachet

配置说明

配置存储在config.yml文件中，默认位于脚本工作目录。若需使用其他路径，可通过CONFIG_FILE环境变量指定。配置文件需包含Zabbix和Cachet的API访问信息、根IT服务设置等关键参数。

示例

Zabbix IT服务结构

• Cachet - 作为zabbix-cachet脚本的root_service
• Bitbucket、Network Connectivity - 父服务，将成为Cachet中的组件组
• GIT https、GIT ssh - Cachet中的组件，需为该层级设置Zabbix触发器

!Zabbix IT服务结构

Cachet组件展示

!Cachet组件