如果我们server主机不能访问外网，但是网络环境中有能访问外网的主机（暂称为B主机，假设它的IP为192.168.1.9），那么我们就把告警内容发到B主机，由B主机访问微信、钉钉接口发送告警消息

如果我们有上网的HTTP代理也可以，这样wgcloud-msg就可以部署到任何主机，只要这个主机能访问到HTTP代理即可

1、我们首先在B主机部署wgcloud-msg（告警消息推送助手）

点击下载告警消息推送助手wgcloud-msg

我们下载wgcloud-msg-v1.5.2.tar.gz后，解压，并启动运行，默认端口是10000，也可以在config/application.properties中修改端口

Linux启动程序用脚本start.sh，停止用脚本stop.sh

如果是windows，直接右键管理员身份运行wgcloud-msg-release.exe，也可以注册为系统服务，隐藏窗口运行

2、如果我们的server主机是Linux，我们首先在server主机新建告警脚本weixin.sh（此脚本文件名只是测试，我们可以修改为其他名称），内容如下，记得给weixin.sh赋加可执行权限

#!/bin/bash # -*- coding: utf-8 -*- ###SCRIPT_NAME:weixin.sh### ###send message from weixin for monitoring### content=$1 content=${content//\ /} time3=$(date "+%H:%M:%S") content="$time3，$content" echo "告警信息 : $content" content=${content//\"/} ding_url="http://192.168.1.9:10000" curl -i -X POST -H "'Content-type':'application/json'" -d '{"content":"'$content'"}' $ding_url

ding_url是wgcloud-msg-release的访问地址，需要改为自己实际部署wgcloud-msg-release的主机IP和端口

测试下脚本

记得先给weixin.sh添加可执行权限

chmod +x weixin.sh

测试发送

sh /home/weixin.sh "测试告警" 或者 bash /home/weixin.sh "测试告警"

我们计划在v3.6.4版本开始，在server程序中集成功能，直接给告警消息推送助手wgcloud-msg推送通知，不用再写如上的推送脚本了。当然如果想写的话也可以的，如上方式依然兼容

3、如果我们的server主机是Windows，我们在server主机新建告警脚本weixin.bat，内容如下

@echo off echo warn content is : %1 set timeHour=%time:~0,2% set timeMin=%time:~3,2% set timeSec=%time:~6,2% set content="WGCLOUD: %timeHour%:%timeMin%:%timeSec%, %1" set content=%content:"=% set ding_url="http://192.168.1.9:10000" curl -H "Content-Type: application/json" -d "{\"content\":\"%content%\"}" -s %ding_url%

提示：如果需要安装curl工具，在【常用工具】 里可以下载

测试发送

e:/weixin.bat "测试告警"

我们计划在v3.6.4版本开始，在server程序中集成功能，直接给告警消息推送助手wgcloud-msg推送通知，不用再写如上的推送脚本了。当然如果想写的话也可以的，如上方式依然兼容

4、修改server/config/application.yml如下配置项warnScript，注意是配置告警脚本的完全路径，然后重启server生效

#告警脚本绝对路径(若配置脚本，无论是否配置过邮件，都会执行该脚本)，可以为空，参考模板：server/template/sendMsg.sh warnScript: /wgcloud/weixin.sh #是否将告警内容转为unicode(针对告警脚本生效)，yes是，no否，钉钉微信等告警建议设置为yes，windows部署server需设置为yes，否则接受到会是乱码 warnToUnicode: yes

建议将warnToUnicode也设置为yes

wgcloud-msg的日志文件在log/目录下

5、修改wgcloud-msg的配置文件config/application.properties

根据需要修改配置，修改后重启wgcloud-msg程序生效

我们只配置自己需要的告警方式的选项值，不需要的告警方式默认为空即可

serverUrl尽量填写为自己的server主机IP和端口，如果不填写也可以，wgcloud-msg启动时候报请求不到serverUrl的错误也没有关系，忽略即可

#本程序运行的端口 msgPort=10000 #wgcloud-server端访问地址，将下方替换为server主机IP和web端口即可 serverUrl=http://localhost:9999 #是否使用代理服务器访问网络，不使用代理上网配置为空就可以，如果使用代理上网，配置格式如：http://代理服务器IP:端口 httpProxyUrl= #企业微信应用告警方式，不需要此方式告警，就不用填写或重置为空 #微信企业ID cropID= #企业微信应用Secret secret= #企业微中的应用id appID= #接受部门成员id，微信接收者，多个接收者用|隔开，如zhangsan|lisi userID= #企业微信机器人告警方式，access_token即为webHook地址的最后的key值，不需要此方式告警，就不用填写或重置为空 qywxAccessToken= #钉钉机器人告警方式，access_token即为机器人webHook地址的最后的access_token值，不需要此方式告警，就不用填写或重置为空 ddAccessToken= #飞书告警方式，webhook即为飞书机器人webHook地址，不需要此方式告警，就不用填写或重置为空 fsTitle= fsWebhook= #邮件告警方式，不需要此方式告警，就不用填写或重置为空 #发送邮箱SMTP服务器，如smtp.qq.com smtpHost= #发送邮箱的SMTP端口，如25或465 smtpPort= #发送邮箱帐号，如test@qq.com smtpUsername= #发送邮箱密码，如123456 smtpPassword= #接受邮件，多个邮件用;隔开，如test@qq.com smtpToUser= #告警邮件标题前缀，此功能需升级到专业版 mailTitlePrefix=[WGCLOUD]监测平台告警 #告警邮件内容后缀，此功能需升级到专业版 mailContentSuffix=WGCLOUD敬上 #告警脚本绝对路径，可以为空，如果您想使用告警脚本发送通知，可以在此处配置shell、bat、python、PowerShell等脚本 warnScript=/home/sendMsg.sh #是否启用检测wgcloud-server在线任务，如果不在线则会发送告警通知，yes启用，no不启用 serverCheckTask=yes

6、如上就配置完成了，我们可以手动测试下脚本，能否发送告警消息

#windows测试 D:\wgcloud>weixin.bat "hello" #Linux测试 [root@VM-4-17-centos linux]#sh weixin.sh "hello"

7、如果想动态给指定用户发送告警消息，如何处理

也可以的，目前支持企业微信应用和邮件方式

其他方式我们可以在暂时变通下，把要发送的指定用户ID加到告警内容里，这样我们看到告警内容就知道是给谁发的了

我们只需要在告警脚本的最后一行，添加参数toUser，toUser就是我们要发给的用户ID，格式要求分别等同于上面第[5]条中的userID和smtpToUser

当告警脚本传递toUser参数时候，且不为空，wgcloud-msg工具就会发送给toUser用户，否则发送给上面第[5]条中的userID或smtpToUser的配置值

提示：仿照【2】和【3】中content的替换双引号为空，把参数toUser的值里面的双引号也替换为空，不然可能报json格式错误

#(1) Linux脚本说明 #将双引号替换为空，不然可能报json格式错误 toUser=${toUser//\"/} #Linux告警脚本最后一行，添加toUser curl -i -X POST -H "'Content-type':'application/json'" -d '{"content":"'$content'","toUser":"'$toUser'"}' $ding_url #(2) Windows脚本说明 #将双引号替换为空，不然可能报json格式错误 set toUser=%toUser:"=% #windows告警脚本最后一行，添加toUser curl -H "Content-Type: application/json" -d "{\"content\":\"%content%\",\"toUser\":\"%toUser%\"}" -s %ding_url%

8、怎么根据标签名称、告警级别或者给指定用户发送告警消息

也可以的，使用告警脚本实现，就是修改下上面【5】中的配置项warnScript

我们只需要在告警脚本的最后一行，添加参数toUser，toUser就是我们要发给的用户ID，格式要求分别等同于上面第[5]条中的userID和smtpToUser

参数groups，就是标签名称，多个标签名称会使用英文逗号隔开

参数warnLevel，就是告警级别分别为：重要，一般，信息

当告警脚本传递toUser、groups、warnLevel参数时候，且不为空，warnScript告警脚本就可以使用这些参数

提示：仿照【2】和【3】中content的替换双引号为空，把参数toUser、groups、warnLevel的值里面的双引号也替换为空，不然可能报json格式错误

#(1) Linux脚本说明 #将双引号替换为空，不然可能报json格式错误 toUser=${toUser//\"/} groups=${groups//\"/} warnLevel=${warnLevel//\"/} #Linux告警脚本最后一行，添加toUser curl -i -X POST -H "'Content-type':'application/json'" -d '{"content":"'$content'","toUser":"'$toUser'","groups":"'$groups'","warnLevel":"'$warnLevel'"}' $ding_url #(2) Windows脚本说明 #将双引号替换为空，不然可能报json格式错误 set toUser=%toUser:"=% set groups=%groups:"=% set warnLevel=%warnLevel:"=% #windows告警脚本最后一行，添加toUser curl -H "Content-Type: application/json" -d "{\"content\":\"%content%\",\"toUser\":\"%toUser%\",\"groups\":\"%groups%\",\"warnLevel\":\"%warnLevel%\"}" -s %ding_url%

查看如何书写warnScript告警脚本

9、wgcloud-msg也可以监控wgcloud-server的进程是否存活

有时候我们想监控wgcloud的server服务是否在正常运行，那么wgcloud-msg可以胜任这个工作，我们可以把wgcloud-msg部署到任何主机，只要它能访问通wgcloud-server即可

然后我们只需要配置上面【5】中的配置文件中的参数serverUrl即可，只要wgcloud-msg能访问通serverUrl即可

如果wgcloud-msg访问不到serverUrl，那么就会发送告警通知（配置了什么告警方式就会发送什么方式的通知），默认每5分钟检测一次serverUrl

监控wgcloud-server的进程是否存活的告警通知，有静默机制，默认2小时内不会重复发送，2小时后如果还是访问不到wgcloud-server，那么会继续发送通知

如果不想监控wgcloud-server的服务，如何关闭呢，我们只需要修改下配置文件config/application.properties中的参数serverCheckTask=no，改为no即可，然后重启下wgcloud-msg程序就生效了