云服务
云服务支持 NAT 网络下的远程管理与多端消息推送扩展。
本功能用来解决下列场景无法通过IP直接推送问题
- 公网云服务无法通过IP地址直接推送给报警灯的问题。
- 告警发送者与设备网段不一致,IP不可达的情况
- 以及所有告警发送端 无法通过IP地址访问到终端的情况

- 转发对设备的Api请求,包含常规告警Api
在PostMan中,将原本通过IP地址方式推送给设备的URL,替换为控制基地址+Path,其他数据保持不变。
举例:
原来的推送地址为
http://<设备IP地址>/api/api/send_msg新的推送地址为
<控制基地址>/api/send_msg
具体的案例(注意红色为变化部分)
原告警推送地址:
http://192.168.0.66/api/api/send_msg
云端推送地址:
https://api.eyegroup.cc/alerter/636fadf4-c9cc-7957-e0d8-73a99e8f128b/api/send_msg
发送即可得到返回结果:

V1.7.3
Section titled “V1.7.3”-
激活
点击更新控制基地址,获取最新的设备基地址。
-
启动服务
创建好控制基础地址后,打开
云服务配置中的云服务开关,稍等片刻后状态会变为在线-已注册,同时界面会展示设备当前的控制基地址。 -
绑定组织(可选操作)
点击绑定组织按钮,输入组织OID,点击确定后,会提示已绑定到的组织。

V1.7.0
Section titled “V1.7.0”-
绑定
使用微信,扫描
云服务配置中的二维码,在手机界面中点击生成新地址,创建设备在云端的控制基地址。 -
启动服务
创建好控制基础地址后,打开
云服务配置中的云服务开关,稍等片刻后状态会变为在线-已注册,同时界面会展示设备当前的控制基地址。

使用前提
终端具备外网访问权限
启用服务
-
首先配置好设备的网络,让其可以链接外网。 然后登录后台管理页面进入
系统设置->云服务配置,使用手机微信扫描管理二维码,见下图。
-
使用手机微信扫描二维码之后,会进入到生成地址界面,点击
生成新推送地址按钮,可以生成设备的新推送地址,见下图。
-
得到新的推送地址后,回到设备云服务配置界面,启用云服务开关,等待5秒后,当云服务状态显示为正常后,即启用配置完毕。
使用推送地址
推送地址的使用非常简单,只需要像常规Api那样推送告警信息即可。请参见常规Api使用
请求接口的Postman界面演示效果见下图

返回结果的说明
使用云服务推送接口返回值与使用常规Api推送给设备数据结构大体相同,但是有部分字段变化,以下为对字段变化的说明。
data/data:表示当前队列中待同步的告警数量。即有多少报警还未被设备拉取。如果该值过大,请检查设备是否离线、或告警发送速度过快导致告警积压。
data/last_pull:新增字段,表示设备上次从平台同步数据的时间。如果时间与现在时间差距过大,请检查设备是否离线。
data/id:推送信息的id,暂时无用。
注意事项
目前云平台对告警信息保存时间限制为5天,期限内没有同步则会被清理!