Zabbix-gnomes 是一组 Zabbix 的开源脚本工具集合,它使用 Python 对 Zabbix API 的进行了分装,使得日常的大部分操作可以通过命令行完成,非常方便。最新的 Zabbix-gnomes 代码可以在 Github 上获取到。
所有 zabbix-gnomes 相关的工具,都可以用 -h/--help 调用获得帮助。
API工具:
zapi.py
- 交互式 Zabbix API客户端。
相关历史:
zgethistory.py
- 从历史记录获取一个itemid的值。zhinvswitcher.py
- 在主机( 群组组) 上切换 inv。zgetinventory.py
- 以CSV格式打印主机清单。zhostupdater.py
- 更新主机属性。zhitemfinder.py
- 查找主机上的项目。zgethistory.py
- 从历史记录( 不支持趋势) 获取项值。zhgraphfinder.py
- 查找在Zabbix主机上配置的图形。zgetgraph.py
- 从Zabbix前端( 需要用户前端访问) 下载一个图形. PNG 并保存它。zghostfinder.py
- 查找hostgroup中的成员主机。zhostfinder.py
- 根据搜索字符串在Zabbix中查找主机。zhostupdater.py
- 更新主机属性。zhproxyfinder.py
- 为Zabbix主机查找配置的代理。ztmplimport.py
- 将 xml 模板导入 Zabbix。zhtmplfinder.py
- 查找Zabbix主机的链接模板。zthostfinder.py
- 查找链接到模板的主机。zthtmllinker.py
- 将主机( 群组组)的链接链接到模板列表。zthtmlunlink.py
- 将主机( 群组组) 与模板列表断开。zhtrigfinder.py
- 在主机上查找触发器。ztrigswitcher.py
- 将触发器切换为已经启用或者discabled状态。zhostupdater.py
- 更新主机属性。zeventfinder.py
- 基于过滤器(。包含tail -f
模式) 查找事件。zgetevent.py
- 获取eventIds的详细信息,包括和ack警报操作。zeventacker.py
- 基于eventIds确认事件。
配置 Zabbix-gnomes
这些程序可以使用 .ini 风格的配置文件,来获取所需的API连接信息。它的配置文件默认为 $HOME/.zbx.conf,样例如下:
[Zabbix API]
username=debian
password=Debian-CN-Debian.cn
api=http://aws-zabbix-1/zabbix/
no_verify=true
将 no_verify
设置为 true
将在使用 https 时禁用 tls/ssl 证书验证。
脚本依赖 pyzabbix、pillow 模块:
pip install pyzabbix pillow
用法样例
将主机 www.debian.cn 的一个月的CPU负载数据保存为 ~/jan.png,具体时间跨度是 2019年01月至1月31日:
graphid=$(./zhgraphfinder.py -e p-hsg-mysql-2 | grep 'CPU load' | cut -d ':' -f 1)
./zgetgraph.py -s $(date --date 'jan 1 2019' +%s) -t 2678400 -f ~/jan.png $graphid
输出的图形如下:
使用 zproxyfinder.py 在 zabbix_sender 脚本中使用恰当的 Zabbix 代理,
zabbix_sender -k $ITEMKEY -o $ITEMVALUE -s $HOSTNAME -z $(zhproxyfinder.py $HOSTNAME)
使用 zhtmpllinker.py 将三个模板链接到指定的 hostgroup 中所有主机:
./zhtmpllinker.py -t "Template App Apache" "Template App MySQL" "Template OS Linux" -G "LAMP Servers"
使用 zhtmplunlink.py 将模板与 hostgroup 中的所有主机关联:
./zhtmplunlink.py -G "Webservers" -t "Template App MySQL"
从模板目录中,导入所有的 xml 模板,并详细显示导入过程:
./ztmplimport.py -v -C./templates/*.xml
从 itemid 为 12345 的监控项的最新项目值:
./zgethistory.py 12345 -C 1
从历史记录中查询一个监控项的值,并指定气质时间段:
./zgethistory.py -s $(date --date 'jan 1 2014' +%s) -t 7200 -e 1030
禁用主机名为 Google DNS 的主机上的,"Unavailable by ICMP"触发器:
./ztrigswitcher.py -D $(./zhtrigfinder.py -s "Unavailable by ICMP" -n "Google DNS")
在主机 webserver 上计算活动触发器的数目:
./zhtrigfinder.py -A "Webserver" | wc -l
switch 对 hostgroup 中所有主机的库存模式:
./zhinvswitcher.py -G"Linux Servers" -m manual
从 Zabbix 的资产清单中,列出所有的主机:
./zhinvswitcher.py --all-hosts
在指定的 hostgroup 中查找与以 mongo 开头的,名称匹配的主机列表:
./zghostfinder.py "mongodb of aws-sg1" | grep -i ^mongo
将指定主机的,可用内存的最后一个监控值打印出来:
./zgethistory.py -C 1 $(./zhitemfinder.py -k 'vm.memory.size[available]' -n Webserver)
对主机名中匹配字符串 zabbix 的所有受监控主机执行搜索,列出主机名:
./zhostfinder.py -m -S zabbix
从主机资产组中,以主机组为维度,按照指定关键字查询,生产一个 csv 文件:
./zgetinventory.py -G "Zabbix Servers" -F "os" "vendor" "contact" > report.csv
将主机名为 web001 的主机,名称更新为 webserver:
./zhostupdater.py web001 -V webserver
启用主机 web001,应用宏 {$APACHEPROC} 并更新资产表中的指定字段:
./zhostupdater.py web001 -E -M apacheproc=15 -I software_app_a="Apache"
查询最近一个小时内的,某主机组中的所有问题事件(限于 100个事件):
./zeventfinder.py -P -t 3600 -G 'Linux Servers'
使用指定的确认消息,来确认 三个事件:
./zeventacker.py -m"Power outage" 6578 6689 6590
在三个事件上打印详细信息,包括触发注释,操作和确认:
./zgetevent.py -ACL 6578 6689 6590
确认指定主机组中的主机上的所有的问题事件:
./zeventacker.py -m 'Foobar with Fabric :-(' $(./zeventfinder.py -i -P -t 900 -G 'Linux servers')
所有主机的Zabbix触发器事件:
./zeventfinder.py -L 10 --all-hosts -f
组合命令样例,查询受监控主机中,某一类主机的指定key值的最新状态:
for i in $(./zhostfinder.py -m -S mysql); do echo -n $i\ \ \ ; ./zgethistory.py -C 1 $(./zhitemfinder.py -k 'net.if.in[eth0]' -n $i) ; done
使用 zapi.py API客户机测试Zabbix调用:
Logging in on 'https://zabbix.debian.cn/' with user 'Admin'.
Welcome to the interactive Zabbix API client.
zapi: z host.get(filter={"host":"Zabbix Server"})
[{u'hostid': u'1001'}]
zapi:
文章末尾固定信息