转自:http://blog.sina.com.cn/s/blog_87113ac20102w7hp.html
Zabbix可以通过多种方式把告警信息发送到指定人,常用的有邮件,短信报警方式,但是越来越多的企业开始使用zabbix结合微信作为主要的告警方式,这样可以及时有效的把告警信息推送到接收人,方便告警的及时处理。
1、 微信企业号注册与使用
企业号注册:https://qy.weixin.qq.com/
2、企业号使用教程
2.1、通讯录添加企业员工
登录新建的企业号,通过提前把企业成员信息添加到组织或者部门,需要填写手机号、微信号或邮箱,通过这样方式让别人扫码关注企业公众号,为了后面企业号推送消息给企业成员。
#新增账户,填写信息
3、 应用中心创建应用
#可见范围还可以添加不同管理组,接受同一个应用推送的消息,注:可见范围选择部门名称或者部门成员
4、给部门设置管理员
设置--->功能设置---->权限管理---->新建管理组
管理员需要事先关注企业号,并且设置好邮箱地址
#需要确定管理员有权限使用应用发送消息,需要管理员的CorpID和Sercrt。(重要)
#准备事项:
微信企业号
企业号已经被部门成员关注
企业号有一个可以发送消息的应用(test-msg),一个授权管理员(test-msg),可以使用应用给成员发送消息
#需要先添加管理员信息,然后使其关注企业号
#需要得到的信息
成员账号
组织部门ID
应用ID
CorpID和Secret
5、微信接口调用
调用微信接口需要一个调用接口的凭证:access_token
通过CorpID和Secret可以获得access_token
微信企业号接口调试地址: http://qydev.weixin.qq.com/debug
#
6、 脚本调用原理
#设置脚本执行路径,编辑zabbix_server.conf文件,添加一行
AlertScriptsPath=/opt/zabbix/share/zabbix/alertscripts
6.1、Shell脚本使用
#curl -s -G url 获取 AccessToken
# curl --data url 传送凭证调用企业号接口
[root@zabbix alertscripts]# cat wechat.sh
#!/bin/bash
#########################################################################
# File Name: wechat.sh
# Author: shaonbean
# Email: shaonbean@qq.com
# Created Time: Sun 24 Jul 2016 05:48:14 AM CST
#########################################################################
# Functions: send messages to wechat app
# set variables
CropID='wx11ac451376ae0e98'
Secret='M3FMhnFh8nTI6SxLAEbbLLZaj-1BpZIyqkJRskeMMUXObGx4mfQsAg7Jw-nUMXe9'
GURL="https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=$CropID&corpsecret=$Secret"
#get acccess_token
Gtoken=$(/usr/bin/curl -s -G $GURL | awk -F" '{print $4}')
PURL="https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=$Gtoken"
#
function body() {
local int AppID=10 #企业号中的应用id
local UserID="touser" #部门成员id,zabbix中定义的微信接收者
local PartyID=8 #部门id,定义了范围,组内成员都可接收到消息
local Msg=$(echo "$@" | cut -d" " -f3-) #过滤出zabbix传递的第三个参数
printf '{ '
printf ' "touser": "'"$UserID""", "
printf ' "toparty": "'"$PartyID""", "
printf ' "msgtype": "text", '
printf ' "agentid": "'" $AppID """, "
printf ' "text": { '
printf ' "content": "'"$Msg""" "
printf ' }, '
printf ' "safe":"0" '
printf '} '
}
/usr/bin/curl --data-ascii "$(body $! $2 $3)" $PURL
#http://qydev.weixin.qq.com/wiki/index.php?title=消息类型及数据格式
#测试:
bash wechat.sh test hello.world!
{"errcode":0,"errmsg":"ok","invaliduser":"all user invalid"}
6.2、python脚本
#安装simplejson
wget https://pypi.python.org/packages/f0/07/26b519e6ebb03c2a74989f7571e6ae6b82e9d7d81b8de6fcdbfc643c7b58/simplejson-3.8.2.tar.gz
tar zxvf simplejson-3.8.2.tar.gz && cd simplejson-3.8.2
python setup.py build
python setup.py install
#下载wechat.py脚本
git clone https://github.com/X-Mars/Zabbix-Alert-WeChat.git
cp Zabbix-Alert-WeChat/wechat.py /opt/zabbix/share/zabbix/alertscripts/
chmod +x wechat.py && chown zabbix:zabbix wechat.py
#脚本修改
#!/usr/bin/python
#_*_coding:utf-8 _*_
import urllib,urllib2
import json
import sys
import simplejson
def gettoken(corpid,corpsecret):
gettoken_url = 'https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=' + corpid + '&corpsecret=' + corpsecret
print gettoken_url
try:
token_file = urllib2.urlopen(gettoken_url)
except urllib2.HTTPError as e:
print e.code
print e.read().decode("utf8")
sys.exit()
token_data = token_file.read().decode('utf-8')
token_json = json.loads(token_data)
token_json.keys()
token = token_json['access_token']
return token
def senddata(access_token,user,subject,content):
send_url = 'https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=' + access_token
send_values = {
"touser":"touser", #企业号中的用户帐号,在zabbix用户Media中配置,如果配置不正常,将按部门发送。
"toparty":"8", #企业号中的部门id。
"msgtype":"text", #消息类型。
"agentid":"10", #企业号中的应用id。
"text":{
"content":subject + ' ' + content
},
"safe":"0"
}
# send_data = json.dumps(send_values, ensure_ascii=False)
send_data = simplejson.dumps(send_values, ensure_ascii=False).encode('utf-8')
send_request = urllib2.Request(send_url, send_data)
response = json.loads(urllib2.urlopen(send_request).read())
print str(response)
if __name__ == '__main__':
user = str(sys.argv[1]) #zabbix传过来的第一个参数
subject = str(sys.argv[2]) #zabbix传过来的第二个参数
content = str(sys.argv[3]) #zabbix传过来的第三个参数
corpid = 'wx11ac451376ae0e98' #CorpID是企业号的标识
corpsecret = 'M3FMhnFh8nTI6SxLAEbbLLZaj-1BpZIyqkJRskeMMUXObGx4mfQsAg7Jw-nUMXe9' #corpsecretSecret是管理组凭证密钥
accesstoken = gettoken(corpid,corpsecret)
senddata(accesstoken,user,subject,content)
#28,29,31行分别改为用户账号,部门ID,和应用ID
#48,49 改为CropID和Secret
#文中使用的用户为,test-msg,部门iD为8,应用ID为10.
#脚本测试
[root@zabbix alertscripts]# ./wechat.py test-msg test hello
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=wx11ac451376ae0e98&corpsecret=M3FMhnFh8nTI6SxLAEbbLLZaj-1BpZIyqkJRskeMMUXObGx4mfQsAg7Jw-nUMXe9
{u'invaliduser': u'all user invalid', u'errcode': 0, u'errmsg': u'ok'}
#可以显示成功
7、脚本路径设置
#将脚本放到zabbix默认执行的路径下
mv wechat.php wechat.sh /opt/zabbix/share/zabbix/alertscripts/
chown zabbix:zabbix /opt/zabbix/share/zabbix/alertscripts/wechat.php
chmod +x /opt/zabbix/share/zabbix/alertscripts/wechat.php
或
chown zabbix:zabbix /opt/zabbix/share/zabbix/alertscripts/wechat.sh
chmod +x /opt/zabbix/share/zabbix/alertscripts/wechat.sh
#设置脚本的启动用户为zabbix,并给脚本可执行权限
#修改zabbix_server.conf文件,添加脚本执行目录
AlertScriptsPath=/opt/zabbix/share/zabbix/alertscripts
#修改完成重启zabbix_server
/etc/init.d/zabbix_server restart
8、Zabbix-web前端设置
8.1、设置通知媒介
8.2、创建用户
8.3、创建触发动作及发送内容
告警主题:
Default subject:{TRIGGER.STATUS}: {TRIGGER.NAME}
Trigger host:{HOSTNAME}
Trigger ip:{HOST.IP}
Trigger time:{EVENT.DATE}:{EVENT.TIME}
Trigger: {TRIGGER.NAME}
Trigger status: {TRIGGER.STATUS}
Trigger severity: {TRIGGER.SEVERITY}
Trigger URL: {TRIGGER.URL}
Item values:
1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}
2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}
Original event ID: {EVENT.ID}
恢复主题:
Default subject:{TRIGGER.STATUS}: {TRIGGER.NAME}
Trigger host:{HOSTNAME}
Trigger ip:{HOST.IP}
Trigger time:{EVENT.DATE}:{EVENT.TIME}
Trigger: {TRIGGER.NAME}
Trigger status: {TRIGGER.STATUS}
Trigger severity: {TRIGGER.SEVERITY}
Trigger URL: {TRIGGER.URL}
Item values:
1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}
2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}
Original event ID: {EVENT.ID}
#
#设置完成记得新增或更新(add&update)
9、测试微信告警发送
#主动触发相关trigger告警,查看微信发送状态
#
#到此Zabbix-3.0.3结合微信告警完成。
10、 注意事项及报错处理
#Zabbix-web页面新增用户权限处理,发送对象选择(应用ID)
#应用当中可见范围选择注意(选这要发送的对象(部门,及部门成员))