云通道-操作文档

操作文档

01用户注册 --02 企业认证 --03 新建应用 --04 新建接收人/接收群组 --05 云通道接入zabbix 3.x配置 --06 云通道接入Open falcon0.2配置

01 用户注册

1、在灵犀首页（https://www.linkedsee.com/），点击右上角的【注册】按钮，进入如下所示页面，按照要求输入邮箱、密码、公司名称、手机号码和验证码，完成注册。

02 企业认证

为了规避平台风险，营造一个合法、可信的告警通道服务，要求使用灵犀云通道的用户必须提交企业认证。没有通过企业认证的用户无法进行正常充值、使用灵犀云通道服务。

1、在控制台概况页面，当未进行企业认证时，点击页面的【申请企业认证】按钮或左侧的企业认证导航进入企业认证页面。

2、在企业认证页面，填写企业名称、企业联系人姓名、企业地址和相应的证件类型、上传证件照，最后点击【提交申请】按钮，如下图所示。

3、提交申请后等待灵犀运营审核，最迟不超过24小时，审核完成后将会在控制台概况页看到认证状态的变更，如下图所示。

4、审核成功后，可点击控制台概况页【充值】按钮或左侧的充值导航进入充值页面。

03 新建应用

1、在控制台概况-我的应用中，点击【+新建应用】按钮，在弹窗中输入应用名称、选择通知场景，如下图所示。

2、在“新建应用”弹窗中，可看到默认勾选了告警通知（运维团队使用场景，提供了告警合并、风暴压制等策略）：“短信告警”和“电话告警”，没有勾选的内部通知（企业级内部使用场景，连通速度快、达到率高）：“短信通知”和“语音通知”。

3、已新建的应用开通的通知场景可以进行修改或再次开通。

04 新建接收人/接收群组

1、在控制台左侧导航，点击“通讯录”栏目，在通讯录-接收人Tab中，点击【+新增接收人】按钮，在弹窗中输入接收人信息（接收人、手机号、邮箱），如下图所示。

2、如您需要给群组发送通知，则需要新建接收群组，在通讯录-接收群组Tab中，点击【+新增接收群组】按钮，在弹窗中新增接受群组信息（接受群组名称、成员），如下图所示。

3、新建接收人/接收群组后，在接收人/接收群组列表中可看到接收人ID/接收群组ID，用于下一步API接入使用。

05 云通道接入zabbix 3.x配置

灵犀云通道作为一款专属通知通道API，可以接入任何系统，如运维常用的Zabbix、Ngions、Open-Falcon、prometheus、Cacti、监控宝等，如下图所示。

下面以Zabbix3.0为例给出了接入步骤。

云通道接入zabbix 3.x配置

1、配置zabbix的报警脚本

将脚本文件放入zabbix安装目录下（如默认目录usr/lib/zabbix/alertscripts/，自定义安装zabbix需要修改，请自行调整），通过命令设置脚本权限。

①发送给接收人的参考脚本 linkedsee_contact.sh，内容如下：

#! /bin/bash
SERVICE_TOKEN=$1
MESSAGE=$2

CONTENT=$MESSAGE
DATA="{\"receiver\":\"186xxxxxxxx\", \"type\":\"sms\",\"title\":\"alarm_sms\",\"content\":\"$CONTENT\"}"
curl -H "servicetoken:$SERVICE_TOKEN" -X POST -d "$DATA" "http://www.linkedsee.com/alarm/cloudchannel"

②发送给接收群组的参考脚本 linkedsee_contact_group.sh，内容如下：

#! /bin/bash
SERVICE_TOKEN=$1
MESSAGE=$2

CONTENT=$MESSAGE
DATA="{\"receiver\":\"q2017032416393xxxx\", \"type\":\"sms\",\"title\":\"alarm_sms\",\"content\":\"$CONTENT\"}"
curl -H "servicetoken:$SERVICE_TOKEN" -X POST -d "$DATA" "http://www.linkedsee.com/alarm/cloudchannel"

权限设置命令：
chown zabbix:zabbix linkedsee.sh；
chmod a+x linkedsee.sh；
inkedsee.sh为测试脚本

2、配置zabbix的通知方式

在Zabbix的“Administration-Media Types”页面，创建媒体类型，Name设置为linkedsee，Type选择Script，脚本名设置为linkedsee.sh，同时添加3个Script parameters。详见下图所示。

3、配置zabbix的灵犀用户

（1）在Zabbix的“Administrator-Users-User”页面，新建linkedsee用户。如下图所示。

（2）在Zabbix的“Administrator-Users-Media”页面，设置Type为linkedsee-alarm；同时在service_token中，填写之前复制备用的服务token。如下图所示。

（3）在Zabbix的“Administrator-Users-Permissions”页面，设置User type为“Zabbix Super Admin”。如下图所示。

4、配置zabbix的触发动作

（1）在Zabbix的“Configuration-Actions-Action”页面，创建告警通知策略，名称为linkedsee，主题为trigger和resolve。如下图所示。

（2）在Zabbix的“Configuration-Actions-Operation”页面，配置发送对象为linkedsee-alarm。如下图所示。

5、完成zabbix配置

Zabbix 3.x配置部分完成。请您触发一条告警，检查是否配置成功。

如果未成功，请确认是否按照上述步骤进行配置。如果确认没有问题，请随时联系我们
我们将及时为您提供支持。热线电话：010-84148522；QQ：1178189833

06 云通道接入Open falcon0.2配置

Open-falcon是小米运维团队从互联网公司的需求出发，根据多年的运维经验，结合SRE、SA、DEVS的使用经验和反馈，开发的一套面向互联网的企业级开源监控产品。

目前open falcon0.2支持LinkedSee灵犀云通道短信/语音通知API快速接入，只需一个API即可快速对接Open Falcon，快速让您拥有告警通知功能，90%的告警压缩比。云通道短信/语音通知接口接入步骤如下：

1、创建应用，获取应用token

用户注册云通道，创建应用成功之后，点击查看应用token，如下所示：

附注：token在后续的api接入步骤中使用。请复制后保存，以备后续使用。

2、获取token后拼接URL

获取token后，需要跟LinkedSee灵犀云通道的短信和语音告警url进行拼接，

发送短信通知地址为：

https://www.linkedsee.com/alarm/falcon_sms/there_is_your_token

发送语音通知地址为：

https://www.linkedsee.com/alarm/falcon_voice/there_is_your_token

发送短信告警地址：

https://www.linkedsee.com/alarm/falcon_sms/there_is_your_token/alarm_sms

发送电话告警地址：

https://www.linkedsee.com/alarm/falcon_voice/there_is_your_token/alarm_phone

如若目前创建的应用的token为：d7a11a42aeac6848c3a389622f8，

则发送短信通知地址为：

https://www.linkedsee.com/alarm/falcon_sms/d7a11a42aeac6848c3a389622f8

发送语音通知的地址为:

https://www.linkedsee.com/alarm/falcon_voice/d7a11a42aeac6848c3a389622f8

则发送短信告警地址为：

https://www.linkedsee.com/alarm/falcon_sms/d7a11a424b6adaeac6848c3a389622f8/alarm_sms

发送电话告警的地址为：

https://www.linkedsee.com/alarm/falcon_voice/d7a11a424b6adaeac6848c3a389622f8/alarm_phone

3、配置open falcon：

将上面的url配置在open falcon alarm模块的配置文件cfg.json中，可以基于cfg.example.json修改，目前直接适配falcon0.2。接口部分如下所示，

附注：更多相关内容可以查看open-falcon Alarm模块帮助文档

"api": {
        "im": "http://127.0.0.1:10086/wechat", //微信发送网关地址
        "sms": "http://127.0.0.1:10086/sms", //短信发送网关地址
        "mail": "http://127.0.0.1:10086/mail", //邮件发送网关地址
        "dashboard": "http://127.0.0.1:8081", //dashboard模块的运行地址
        "plus_api":"http://127.0.0.1:8080", //falcon-plus api模块的运行地址
        "plus_api_token": "default-token-used-in-server-side" //用于和falcon-plus api模块服务端之间的通信认证token
},

将上一步的URL写在下方标红处，如下所示：

若发短信，则把短信发送网关地址替换为上一步中拼接的URL，若要发送语音消息，则将sms处的地址替换为语音对应的url，目前falcon暂不支持同时发送语音和短信通知，若要同时使用语音和短信报警，可以开通LinkedSee云告警服务，同时还支持微信和邮件报警。

4、触发告警

Open Falcon配置完成后，请您触发一条告警，检查是否配置成功。目前Open Falcon接入之后LinkedSee灵犀云通道之后，语音播报通道是固定内容的语音，若想使用动态语音播报和更多高级告警功能，欢迎使用云告警产品。

接入帮助：https://www.linkedsee.com/standard/support/#/access-falcon

目前云通道免费版默认为短信10条，电话10通，完成接入配置之后，为保证信息安全，需要点击申请企业认证，填写企业认证相关信息审核通过之后即可充值购买更多的短信和语音告警数量。充值成功之后，可以查看用量统计和通知记录，帮助您更好的监控硬件性能，提升效率。

附注：如果未成功，请确认是否按照上述步骤进行配置。如果确认没有问题，可以联系我们。我们将及时为您提供支持。热线电话：010-84148522

产品

客服

关于

更多