设备列表

平台通过设备列表,对该租户下的设备进行统一管理,同时租户下的客户只能管理分配给自己的设备。

前置条件

租户管理员 或 **客户 **登录平台。如果需要使用新的设备配置,请通过 设备配置 进行添加。

操作步骤

添加设备

点击左侧菜单,“设备管理 => 设备列表 => 新增设备”,完成信息输入,如需添加设备凭证点击“下一步”,否则点击“确认”按钮。

image-20220308115335717

参数说明

描述输入参数
设备图片非必填用于显示设备的图片
设备名称必填设备的名称,长度限制为255个字符。
设备类型必填设备类型:网关设备、直连设备、网关子设备,平台能直接接入的平台
设备配置必填设备的相关传输方式、告警配置、告警通知都是通过设备配置进行的配置。
所属组织必填代表该设备归属的组织
设备标签非必填对设备进行标注
设备位置非必填选择设备的安装位置,便于之后在 地理位置 页面准确的定位设备位置。
备注非必填对设备进行备注

添加设备凭证

用户勾选"填写协议"按钮,才可以添加该设备的凭证。

image-20220308115930521

参数说明

描述输入参数
凭证类型必填设备访问平台的凭证,支持Access Token、X.509、MQTT basic
访问令牌必填(Access Token)访问令牌,长度限制为32个字符。
RSA公钥必填(X.509)RSA公钥
客户端ID必填(MQTT basic)MQTT的客户端ID,保证客户端ID唯一
用户名必填(MQTT basic)MQTT的客户端用户名
密码非必填(MQTT basic)MQTT的客户端密码
  • 设备详情

详情:可以查看设备的基本信息,同时可以 复制设备ID复制访问令牌管理设备凭证

实时数据:设备端上报的数据

告警:设备上报数据通过设备配置后产生的告警数据

image-20220308152901237

说明:

1、设备信息旁有个帮助信息,点击可以查看当前设备的Topic连接信息。直连设备:v1/devices/me/telemetry 网关设备:v1/gateway/telemetry

2、告警数据只会在状态为“清除已确认清除未确认”的情况下,才会产生新的告警。

设备配置

用户可以通过设备配置,将同一类型的设备进行统一管理,例如:全是水表设备可以创建一个统一的水表设备配置。

前置条件

部署ThingsKit平台,并用租户管理员登录平台。并且已经创建了组织,如需创建请前往

操作步骤

设备配置:可对设备使用的队列条件、传输条件、告警条件、告警通知进行配置。

添加设备信息

点击左侧菜单“设备管理 => 设备配置 => 新增设备配置”,完成信息录入,如果要进行传输配置、告警配置及告警通知等设置,则点击“下一步”,否则点击“确认”按钮

image-20220304095702247

参数说明

描述输入参数
配置名称必填设备配置的名称,长度限制为255个字符。
规则链非必填目前只支持默认的规则链
队列处理非必填高优先级:代表使用该配置的设备队列消息优先进行处理。主要:代表设备队列消息低于高优先级高于顺序执行。顺序执行:代表队列消息按正常的入栈顺序进行处理。
描述非必填对设备配置进行描述

添加传输配置

默认选中Default,点击“下一步”,如上一步信息填写有误,则点击“上一步”。

说明:需要自定义Topic的MQTT传输协议和其他协议将在之后版本提供,敬请期待。

添加告警配置

告警配置可以配置多个报警规则,且一个规则可以配置五种不用程度的告警,分别是:危险重要次要警告不确定

image-20220308140039819

创建报警规则条件

报警规则,可以通过设备的遥测值进行控制,同时可以通过条件类型来决定是否告警。条件类型包含了简单、持续时长、重复。

简单:一但满足触发条件就产生告警。

持续时长:在配置完成后,设备上报的数据满足触发条件,开始计时,在规定时间内只要数据一直满足触发条件则告警,否则清除计时。

重复:满足触发条件达到一定的数量后,才真正的产生告警。

启用规则

启用规则包含了始终启用定时启用自定义启用,平台默认始终启用。

注意:

1、同一个告警规则在告警时,第一次告警将产生一条告警数据,同时状态为“Active 未确认”,在没有将告警数据处理为“清除已确认”的状态将不会产生新的告警数据。

2、同一个告警规则如果第一次告警数据等级为“危险”,在没有将告警数据处理为“清除已确认”的状态,低等级的告警数据不会更新数据。如第一条产生的告警数据是低等级的告警,在第二次告警等级高于第一次的告警等级,告警数据将会更新为高等级的数据。

清除报警规则

清除规则,可以通过设备的遥测值,自动清除报警,不需要人为手动确认。

参数说明

描述输入参数
报警类型必填对报警规则的描述,例如:高温报警
报警严重程度必填等级由高到低:危险、重要、次要、警告、不确定
报警规则条件必填通过添加的条件,一但上报的数据满足条件将产生告警
报警启用规则必填规则包含:始终启用、定时启用、自定义启用

添加告警通知

告警通知,一但设备产生告警平台将通过短信和邮件的形式通知告警联系人。

image-20220309140349602

注意:在选择告警联系人之前,需要创建好告警联系人,及配置好消息模板。具体操作请查看 告警联系人消息模板

参数说明

描述输入参数
告警通知联系人必填联系人可以多选
告警通知方式必填通知方式可以多选,目前支持 邮件短信

地理位置

地理位置是通过地图的形式,将设备位置设备信息历史数据呈现地图上,让用户管理更加方便。

前置条件

部署ThingsKit平台,用 租户管理员客户 登录平台

操作步骤

点击左侧菜单,“设备管理 => 地理位置”,输入查询条件,点击“查询”按钮。

image-20220308161221648

  • 设备信息

设备信息详情与 设备列表 里面的设备详情一致。

  • 历史数据

历史数据可以根据不同时间维度聚合维度进行查询

image-20220308162336293