从Zabbix报警在Jira上创建或更新票据
zabbix2jira的Python项目详细描述
从zabbix alarms创建或更新jira的票据
目的
Zabbix2jira是一个简单的命令行程序,它接收来自 zabbix(或任何其他脚本)并在项目上创建(或更新)票据 在Jira装置内。
安装
在程序目录下使用以下命令:
$ pip install -e .
我们建议使用virtualenv设置自包含的应用程序目录。在这个 案例,您应该使用:
$ virtualenv env $ source env/bin/activate $ pip install -e .
如果要查看此应用程序使用的库,请检查 requirements.txt文件。
用法
默认路径:
- 配置:/etc/zabbix2jira.cfg
- 日志:/var/log/zabbix2jira.log
- 缓存目录:/var/cache/zabbix2jira
要运行它,请先激活virtualenv:
$ source env/bin/activate $ zabbix2jira -h
配置
命令本身使用一些默认配置,但是您将需要 配置文件以配置jira url、用户名和密码。
只需将sample-config.cfg文件复制到默认配置 路径(/etc/zabbix/zabbix2jira.cfg)或复制到任何位置并使用 -c参数。
文件本身是不言而喻的。
Zabbix集成
创建使用适当变量调用脚本的操作。
我们创建一个名为zabbix2jira的操作,条件是:
- 维护状态不在维护中
- b触发值=问题
- C触发值=确定
计算一下:A and (B or C)。注意 (B or C),因为我们希望在警报和恢复时都运行该操作。
注意:这在zabbix 3.2上已更改。你可以跳过b和c条件 因为在此版本上,问题和恢复操作是分开的。
然后在operations选项卡上,创建一个执行Custom script 在Zabbix服务器上,使用以下命令:
zabbix2jira -v -i {EVENT.ID} PROJECT {TRIGGER.STATUS} "[Zabbix Alert] {HOSTNAME} - {TRIGGER.NAME}" "Alert Details"
也可以将脚本用作用户媒体并向其发送消息。
注意,如果使用virtualenv设置,请在前面的命令之前激活它:
source /opt/z2d/env/bin/activate
示例
下面是一些运行zabbix2jira的示例。
使用组件Alert:
创建问题zabbix2jira -v -p Alert PROJECT PROBLEM "[Zabbix Alert] PROBLEM" "Alert Details"
启用zabbix后端后,跟踪事件id(123)以确认它:
zabbix2jira -v -i 123 PROJECT PROBLEM "[Zabbix Alert] PROBLEM" "Alert Details"
恢复上一个问题:
zabbix2jira -v -i 123 PROJECT OK "[Zabbix Alert] PROBLEM "Alert Details"
使用类型Bug:
创建问题zabbix2jira -v -t Bug PROJECT PROBLEM "[Zabbix Alert] PROBLEM" "Alert Details"