租户入驻

物联网平台提供给企业(租户)两种入驻方式。您可以向物联网平台管理员申请开通物联网平台租户或直接使用卡奥斯天云租户入驻。

物联网平台租户

物联网平台的所有租户由物联网平台管理员统一管理，请联系物联网平台系统管理员申请开通租户并分配租户管理员。

卡奥斯天云租户

物联网平台支持卡奥斯天云租户(CUBA)直接登录，如您的企业已接入卡奥斯天云，在物联网平台时您可选择卡奥斯统一用户方式登录系统。

系统登录

物联网平台提供给用户两种登录方式。您可以使用管理员分配的账号登录或使用卡奥斯统一用户登录。

物联网平台账号密码登录

在物联网平台登录页面，输入管理员分配给您的账号和已设置的密码，点击登录按钮进入系统。

卡奥斯统一用户登录

在物联网平台登录页面，点击登录按钮下方的卡奥斯统一用户登录方式，跳转到卡奥斯统一用户中心的登录页面，登录您的卡奥斯账号即可跳转进入物联网平台。

首页

用户登录系统后，首先看到的是系统首页，展示当前企业(租户)在物联网平台的使用概况及功能引导。

首页上方展示当前租户使用物联网平台的概况数据，包括产品数量、在线/离线的设备数量，当日的告警触发量及接收的设备消息量。

首页中间展示近30天每一天(不包括当天)的告警触发量、接收的设备消息量，其中告警触发量区分不同级别展示，鼠标移入可展示每天的统计量。

首页下方展示物联网可为您提供的全部产品功能，您可以按照流程引导进行物联设备的接入与管理。

产品管理

产品是一类设备的模板。产品拥有这一批设备的共同属性，例如类型、型号、厂家、与物联网平台的通信传输方式等。

添加设备时必须选择所属产品，设备继承该产品的基础信息并以产品物模型为模板生成设备物模型。

综上，通过产品我们能更好地管理同类批量设备。

添加产品

在设备管理-产品管理页面，点击产品列表左上角的添加按钮，弹窗添加产品。填写对应产品信息，然后点击确定即可成功添加产品。

参数	描述
产品图片	产品可视化图像。系统设有默认图片，支持上传自定义图片。建议尺寸 600 * 600，格式限制为jpg/jpeg/png
产品标识	产品的英文名称，可以理解成产品在系统中的区分标识，租户内唯一。系统设有默认生成逻辑。支持英文字母、数字、下划线或中划线
* 产品名称	产品的中文名称，可以理解成产品对于用户的名称，租户内唯一。支持中文、英文字母、数字、标点符号
* 节点类型	设备接入物联网的类型。能选择直连设备、网关设备、网关子设备中的一种 直连设备：可以直接连接物联网平台进行通讯，不能挂载子设备，但也可作为子设备挂载到网关设备下的设备 网关设备：可以挂载子设备的直连设备。网关设备具有子设备管理模块，可以管理网关设备与子设备的拓扑关系 网关子设备：不能直接连接物联网平台，只能借助网关设备接入物联网平台的设备
规则链	设备物联数据接收处理的规则。不填写将使用系统内设的”根规则链”，支持选择租户内自定义配置的规则链
产品型号	产品/设备型号。支持中文、英文字母、数字、标点符号，例如某网关产品型号是T1800-DI-4G
生产厂商	产品/设备的生产厂家。支持中文、英文字母、数字、标点符号，例如某网关生产厂商是郑州龙兴物联科技有限公司
产品描述	产品描述/备注内容。支持中文、英文字母、数字、标点符号
* 传输方式	设备与物联网平台的通信传输方式。默认方式支持基本MQTT、HTTP和CoAP传输。还可选择MQTT、CoAP、LWM2M、SNMP其中的一种

管理产品

在设备管理-产品管理页面，您可查看到您当前租户下的全部产品，您可以查看产品详细信息、编辑产品信息、删除产品。

点击产品列表操作栏的查看，打开产品详情页面。您可以看到当前产品的全部详细信息。

点击产品列表操作栏的编辑，弹窗编辑产品，除了节点类型不可变更外，其他产品信息都可以编辑。

点击产品列表操作栏的删除，可将对应产品从系统删除，其已配置的物模型也会一并删除，请谨慎操作。

存在关联设备或关联告警规则的产品不可被删除，如需删除请先解除关联。

产品物模型测点

物模型是物理空间中的实体在物联网平台中的数字化表示，是附着在设备一种数据模型。

测点的全称是”设备遥测点位”，是设备上记录的数据监测点位，例如设备产量、监测液体浓度等。

经过对工业物联网市场充分调研发现：工业领域不同于消费领域，其核心需求是监测设备遥测数据，关注设备属性状态，故本物联网平台物模型管理重点关注属性和测点两部分。

在设备管理-产品管理-查看-物模型-测点页面，您可查看到您当前产品配置的物模型测点，您可以添加测点、编辑测点、删除测点。

点击产品物模型测点列表左上角的添加按钮，弹窗添加测点。填写详细测点信息，然后点击确定即可成功添加产品物模型-测点。

参数	描述
* 测点标识	测点的英文名称，可以理解成测点在产品中的区分标识，同产品下唯一。支持英文字母、数字、下划线或中划线
* 测点名称	测点的中文名称，可以理解成测点对于用户的名称，同产品下唯一。支持中文、英文字母、数字、标点符号
* 数据类型	数据类型能选择string(文本)、int32(整数)、int64(时间戳)、float(小数)、bool(布尔型)、enum(枚举型)、json(结构体)中的一种 string(文本)：字符串文本类型，例如工业模拟手写打印机的当次打印文本内容是”Helle World !” int32(整数)：32位整数型，例如工业码垛机的当日计件量为1123件 int64(时间戳)：整数类型Int64的UTC时间戳格式，单位：毫秒，例如工业灌装机达成当期目标产量的时间是1670829600000 float(小数)：单精度浮点型，例如工业码垛机码垛货物的重量为192.58千克 bool(布尔型)：True/False的布尔型，例如工业摆渡机器人的运行状态用True表示上电，False表示未上电 enum(枚举型)：枚举型，例如工业可燃气体检测报警器的监测模式有天然气、煤气、一氧化碳等 json(结构体)：JSON对象，例如工业印刷机的印刷颜色是由Red、Green、Blue三个参数组成的结构体
* 单位	测点数据的单位。若数据本身没有描述单位，可选择”无”
测点标签	测点的分类。用户可定义测点类别，例如标记用于报警的点位
测点描述	测点描述/备注内容。支持中文、英文字母、数字、标点符号

点击产品物模型测点列表右上角的导入按钮，弹窗批量导入测点，在此下载”测点导入模板.xlsx”，填写后将EXCEL文件上传即可完成导入。

如果存在错误数据无法导入，系统会将错误信息转化成EXCEL文件，您可下载查看错误信息修正后再次导入。

点击产品物模型测点列表操作栏的编辑，弹窗编辑测点，所有测点信息都可以编辑。

点击产品物模型测点列表操作栏的删除，可将对应产品物模型-测点删除。测点存在关联告警规则时不可被删除。

产品物模型是设备物模型的模板，增删改产品物模型测点，不会影响此前已关联此产品添加的设备，新添加的设备会按最新的产品物模型为模板。

产品物模型属性

物模型是物理空间中的实体在物联网平台中的数字化表示，是附着在设备一种数据模型。

属性是设备运行工作的状态属性，其区别于监测点位的特征是数据变化频率不高，且更关注当前值，例如设备在线状态、设备软件版本号等。

经过对工业物联网市场充分调研发现：工业领域不同于消费领域，其核心需求是监测设备遥测数据，关注设备属性状态，故本物联网平台物模型管理重点关注属性和测点两部分。

在设备管理-产品管理-查看-物模型-属性页面，您可查看到您当前产品配置的物模型属性，您可以添加属性、编辑属性、删除属性。

点击产品属性列表左上角的添加按钮，弹窗添加属性。填写详细属性信息，然后点击确定即可成功添加产品物模型-属性。

参数	描述
* 属性标识	属性的英文名称，可以理解成属性在系统中的区分标识，同产品下唯一。支持英文字母、数字、下划线或中划线
* 属性名称	属性的中文名称，可以理解成属性对于用户的名称，同属性类型下唯一。支持中文、英文字母、数字、标点符号
* 属性类型	属性类型能选择服务端属性、共享属性、客户端属性中的一种 服务端属性：由物联网平台管理和维护，对设备不可见，例如对设备进行记录设备负责人信息、设备保养记录等 共享属性：由物联网平台管理和维护，对设备可见，例如设备当前固件版本号，设备可获取校验是否执行升级 客户端属性：由设备应用程序管理和维护，对物联平台可见，例如设备的运行模式
* 数据类型	数据类型能选择string(文本)、int32(整数)、int64(时间戳)、float(小数)、bool(布尔型)、enum(枚举型)、json(结构体)中的一种 服务端属性和共享属性需填写当前数据值内容及释义，客户端属性需定义数据范围及数据值的释义
属性描述	属性描述/备注内容。支持中文、英文字母、数字、标点符号

服务端属性和共享属性：填写设置的内容会展示在设备详情-属性状态，支持设置修改

1. 数据类型是string(文本)、int32(整数)、float(小数)、json(结构体)时，只需填写数据内容
2. 数据类型是int64(时间戳)时，需选择年月日时分秒
3. 数据类型是bool(布尔型)、enum(枚举型)时，需要填写各项值的释义内容，还需要选定一个当前的值

客户端属性：数据内容来自设备，平台设置数据范围对设备数据过滤处理并展示在设备详情-属性状态

1. 数据类型是string(文本)时，可以选填最大数据长度
2. 数据类型是int32(整数)、float(小数)时，可以选填数据范围的最小/最大值，还可以选填数据值对应的单位
3. 数据类型是int64(时间戳)时，平台按整数类型Int64的UTC时间戳(毫秒)格式校验转换
4. 数据类型是bool(布尔型)、enum(枚举型)时，需要填写各项值及对应值得释义内容
5. 数据类型时json(结构体)时，可以选填json对象

点击产品属性列表操作栏的编辑，弹窗编辑属性，所有属性信息都可以编辑。

点击产品属性列表操作栏的删除，可将对应产品物模型-属性删除。属性存在关联告警规则时不可被删除。

产品物模型是设备物模型的模板，增删改产品物模型属性，不会影响此前已关联此产品添加的设备，新添加的设备会按最新的产品物模型为模板。

设备管理

设备是具有传输数据能力的单位，设备继承产品基础信息且并以产品物模型为模板生成设备物模型。物联网平台中的设备应对应物理空间中的实体设备。

添加设备

在设备管理-设备管理页面，点击设备列表左上角的添加按钮，弹窗添加设备。填写对应设备信息，然后点击确定即可成功添加设备。

参数	描述
设备图片	设备可视化图像。系统设有默认图片，支持上传自定义图片。建议尺寸 600 * 600，格式限制为jpg/jpeg/png
设备标识	设备的英文名称，可以理解成设备在系统中的区分标识，租户内唯一。系统设有默认生成逻辑。支持英文字母、数字、下划线或中划线
* 设备名称	设备的中文名称，可以理解成设备对于用户的名称，允许名称重复。支持中文、英文字母、数字、标点符号
* 所属产品	选择设备所属产品(物模型模板)，会继承产品的节点类型、型号厂家等基础属性信息，并以产品物模型为模板生成设备物模型
地理位置	记录设备当前所在地理位置信息，可以直接鼠标选择地图中的坐标点，也可以搜索地图中的地点
设备描述	设备描述/备注内容。支持中文、英文字母、数字、标点符号
* 凭据类型	设备数据对接物联网平台的认证鉴权的凭据类型。默认以Access Token的方法生成设备唯一令牌。也可选择Access Token、X.509、MQTT Basic中的一种 Access Token：使用Token访问令牌的方式对设备鉴权认证 X.509：使用X.509数字证书对设备鉴权认证 MQTT Basic：使用MQTT客户端账号密码对设备鉴权认证
* 令牌/密钥/客户端	设备数据对接物联网平台的认证鉴权的凭据。物联网平台以此处配置的令牌/密钥/客户端信息与设备建立安全通信。

在设备管理-设备管理页面，点击设备列表右上角导入按钮，弹窗批量导入设备，在此下载”设备导入模板.xlsx”，填写后将EXCEL文件上传即可完成导入。

如果存在错误数据无法导入，系统会将错误信息转化成EXCEL文件，您可下载查看错误信息修正后再次导入。

管理设备

在设备管理-设备管理页面，您可查看到您当前租户下的全部设备，您可以查看设备详细信息、编辑设备信息、删除设备。

点击设备列表右上角的导出按钮，可以将页面筛选的所有设备列表导出为EXCEL表格文件。

点击设备列表操作栏的查看，打开设备详情页面。您可以看到当前设备的全部详细信息。

点击设备列表操作栏的编辑，弹窗编辑设备，除了所属产品不可变更外，其他设备信息都可以编辑。

点击设备列表操作栏的删除，可将对应设备从系统删除，其已配置的物模型及遥测数据记录也会一并删除，请谨慎操作。存在关联告警规则的设备不可被删除。

设备物模型测点

物模型是物理空间中的实体在卡奥斯物联网平台中的数字化表示，是附着在设备一种数据模型。

测点的全称是”设备遥测点位”，是设备上记录的数据监测点位，例如设备产量、监测液体浓度等。

设备物模型是以所属产品当时的物模型配置为模板生成的，生成后独立管理，您可对设备物模型进行单独配置，不会影响到产品物模型。

经过对工业物联网市场充分调研发现：工业领域不同于消费领域，其核心需求是监测设备遥测数据，关注设备属性状态，故本物联网平台物模型管理重点关注属性和测点两部分。

在设备管理-设备管理-查看-物模型-测点页面，您可查看到您当前设备配置的物模型测点，您可以添加测点、编辑测点、删除测点。

点击设备物模型测点列表左上角的添加按钮，弹窗添加测点。填写详细测点信息，然后点击确定即可成功添加设备物模型-测点。

参数	描述
* 测点标识	测点的英文名称，可以理解成测点在系统中的区分标识，同设备下唯一。支持英文字母、数字、下划线或中划线
* 测点名称	测点的中文名称，可以理解成测点对于用户的名称，同设备下唯一。支持中文、英文字母、数字、标点符号
* 数据类型	数据类型能选择string(文本)、int32(整数)、int64(时间戳)、float(小数)、bool(布尔型)、enum(枚举型)、json(结构体)中的一种 string(文本)：字符串文本类型，例如工业模拟手写打印机的当次打印文本内容是”Helle World !” int32(整数)：32位整数型，例如工业码垛机的当日计件量为1123件 int64(时间戳)：整数类型Int64的UTC时间戳格式，单位：毫秒，例如工业灌装机达成当期目标产量的时间是1670829600000 float(小数)：单精度浮点型，例如工业码垛机码垛货物的重量为192.58千克 bool(布尔型)：True/False的布尔型，例如工业摆渡机器人的运行状态用True表示上电，False表示未上电 enum(枚举型)：枚举型，例如工业可燃气体检测报警器的监测模式有天然气、煤气、一氧化碳等 json(结构体)：JSON对象，例如工业印刷机的印刷颜色是由Red、Green、Blue三个参数组成的结构体
* 单位	测点数据的单位。若数据本身没有描述单位，可选择”无”
测点标签	测点的分类。用户可定义测点类别，例如标记用于报警的点位
测点描述	测点描述/备注内容。支持中文、英文字母、数字、标点符号

点击设备物模型测点列表右上角的导入按钮，弹窗批量导入测点，您在此下载”测点导入模板.xlsx”，填写后将EXCEL文件上传即可完成导入。

如果存在错误数据无法导入，系统会将错误信息转化成EXCEL文件，您可下载查看错误信息修正后再次导入。

点击设备物模型测点列表操作栏的编辑，弹窗编辑测点，所有测点信息都可以编辑。

点击设备物模型测点列表操作栏的删除，可将对应设备物模型-测点删除。测点存在关联告警规则时测点不可被删除。

设备物模型是以所属产品当时的物模型配置为模板附着到设备上的模型，因此增删改设备物模型-测点时，不会影响所属产品物模型。

设备物模型属性

物模型是物理空间中的实体在物联网平台中的数字化表示，是附着在设备一种数据模型。

属性是设备运行工作的状态属性，其区别于监测点位的特征是数据变化频率不高，且更关注当前值，例如设备在线状态、设备软件版本号等。

设备的物模型是以所属产品当时的物模型配置为模板生成的，生成后独立管理，您可对设备物模型进行单独配置，不会影响到产品物模型。

经过对工业物联网市场充分调研发现：工业领域不同于消费领域，其核心需求是监测设备遥测数据，关注设备属性状态，故本物联网平台物模型管理重点关注属性和测点两部分。

在设备管理-设备管理-查看-物模型-属性页面，您可查看到您当前设备配置的物模型属性，您可以添加属性、编辑属性、删除属性。

点击设备物模型属性列表左上角的添加按钮，弹窗添加属性。填写详细属性信息，然后点击确定即可成功添加设备物模型-属性。

参数	描述
* 属性标识	属性的英文名称，可以理解成属性在系统中的区分标识，同设备下唯一。支持英文字母、数字、下划线或中划线
* 属性名称	属性的中文名称，可以理解成属性对于用户的名称，同属性类型下唯一。支持中文、英文字母、数字、标点符号
* 属性类型	属性类型能选择服务端属性、共享属性、客户端属性中的一种 服务端属性：由物联网平台管理和维护，对设备不可见，例如对设备进行记录设备负责人信息、设备保养记录等 共享属性：由物联网平台管理和维护，对设备可见，例如设备当前固件版本号，设备可获取校验是否执行升级 客户端属性：由设备应用程序管理和维护，对物联平台可见，例如设备的运行模式
* 数据类型	数据类型能选择string(文本)、int32(整数)、int64(时间戳)、float(小数)、bool(布尔型)、enum(枚举型)、json(结构体)中的一种 服务端属性和共享属性需填写当前数据值内容及释义，客户端属性需定义数据范围及数据值的释义
属性描述	属性描述/备注内容。支持中文、英文字母、数字、标点符号

服务端属性和共享属性：填写设置的内容会展示在设备详情-属性状态，支持设置修改

1. 数据类型是string(文本)、int32(整数)、float(小数)、json(结构体)时，只需填写数据内容
2. 数据类型是int64(时间戳)时，需选择年月日时分秒
3. 数据类型是bool(布尔型)、enum(枚举型)时，需要填写各项值的释义内容，还需要选定一个当前的值

客户端属性：数据内容来自设备，平台设置数据范围对设备数据过滤处理并展示在设备详情-属性状态

1. 数据类型是string(文本)时，可以选填最大数据长度
2. 数据类型是int32(整数)、float(小数)时，可以选填数据范围的最小/最大值，还可以选填数据值对应的单位
3. 数据类型是int64(时间戳)时，平台按整数类型Int64的UTC时间戳(毫秒)格式校验转换
4. 数据类型是bool(布尔型)、enum(枚举型)时，需要填写各项值及对应值得释义内容
5. 数据类型时json(结构体)时，可以选填json对象

点击设备物模型属性列表操作栏的编辑，弹窗编辑属性，所有属性信息都可以编辑。

点击设备物模型属性列表操作栏的删除，可将对应设备物模型-属性删除。属性存在关联告警规则时不可被删除。

设备物模型是以所属产品当时的物模型配置为模板附着到设备上的模型，因此增删改设备物模型-属性时，不会影响所属产品物模型。

属性状态

属性状态可查看设备已配置物模型属性的最新数据，用于监控设备最新状态。

在设备管理-设备管理-查看-属性状态页面，您可查看到您当前设备配置的物模型属性的最新状态，您也可以设置/变更部分属性值。

设备属性包括三种类型，他们用不同颜色的卡片区分：蓝色表示服务端属性、绿色表示共享属性、橙色表示客户端属性

服务端属性和共享属性的值是由平台设置定义的，您可以在属性状态页面变更属性值内容

服务端属性特殊情况：”在线状态”、”上次活跃时间”、”上次连接时间”、”上次断开连接时间”、”不活跃报警时间”这5个属性状态由平台针对每台设备自动生成，不可手动修改

共享属性特殊情况：”升级包名称”、”升级包版本”、”升级包标签”、”升级包签名算法”、”升级包签名”、”升级包大小”、”升级包下载地址”这7个属性状态由平台在设备OTA升级时自动生成，不可手动修改

客户端属性的值只能是由设备上传的，值的范围释义是平台设置的，设备上传的属性数据会与设备配置物模型属性进行匹配后展示，这就意味着一定要与设备共同约定好属性信息并配置到设备物模型，否则可能无法查看到完整数据

点击部分服务端属性和共享属性属性状态卡片右上角的设置按钮，弹窗设置服务端属性/共享属性。您可以在此编辑修改为当前属性状态最新值。

遥测数据

遥测数据可查看设备已配置物模型测点的实时数据以及历史数据，用于查看/分析设备的实时数据及历史状况。

设备上传的遥测数据信息会与设备配置物模型测点信息进行匹配后展示，这就意味着一定要与设备共同约定好遥测点位信息并配置到设备物模型，否则可能无法查看到完整数据

在设备管理-设备管理-查看-遥测数据页面，您可查看到您当前设备配置的物模型测点的实时遥测数据，您也可以查看历史遥测数据记录。

点击遥测数据卡片右上角的历史数据按钮，弹窗遥测记录。您可在此查看到时间由近及远的遥测数据记录，您也可以自由筛选时间段进行查看。

对于”int32(整数)”和”float(小数)”数据类型的测点，还提供了可视化折线图的方式方便您分析数据变化趋势。您亦可以自由筛选时间段进行查看，系统会展示所选时间段内最新的100条数据绘制成图。

子设备管理

子设备管理是网关类型设备的独有功能。网关设备与子设备建立关联关系后，表示网关设备可代理所关联的子设备进行设备认证、遥测数据上传等与物联网平台的通信。

直连设备、网关设备、网关子设备都可作为子设备挂载到网关设备上进行通信

对于已被关联到网关设备上的直连设备、网关设备，其即可通过网关设备接入物联网平台，也可直接连接物联网平台

在设备管理-设备管理-查看-网关子设备页面，您可查看到当前网关设备所关联的全部子设备，您也可以新绑定子设备或解绑子设备。

点击子设备列表左上角的绑定按钮，弹窗绑定子设备。勾选要绑定的子设备，然后点击确定即可成功将所选设备作为子设备与当前网关设备关联。

点击子设备列表操作栏的解绑，即可解除子设备与当前网关设备的关联关系。一台设备作为子设备同时至多关联一台网关设备，解除绑定后设备可再次被其他网关设备绑定关联。

告警规则

物联网平台支持通过自由配置告警规则逻辑，支持多级别、多触发条件、复合触发器、自动消除等各类复杂场景的设备告警。

添加告警规则

在运维监控-告警规则页面，点击添加按钮，打开添加告警规则页面。

首先，需要填写告警规则基础信息，确定当前规则所适用的对象。

参数	描述
* 规则名称	告警规则的名称，租户内唯一。支持中文、英文字母、数字、标点符号，至多50个字符
* 产品名称	规则适用对象——产品。可以选择租户下的任一产品，表示此规则适用于此产品下的全部设备
设备标识	规则适用对象——设备。必须先选择产品再选择设备，可以选择产品下的任一设备，选择设备表示规则只对此单设备生效
规则描述	规则描述/备注内容。支持中文、英文字母、数字、标点符号

告警规则即可应用到一批同类型的多台设备(产品)，也可应用到单台设备。

• 当告警规则只选择产品不选择设备时，规则对所选产品的全部设备都生效。

• 当告警规则选择产品后又选择了设备时，规则只对所选择的设备生效。

其次，，告警规则中至少要配置1条触发规则，系统会依据所配置的触发规则对应生成告警记录。

点击告警级别/启用规则/触发类型后的按钮可分别设置触发规则逻辑。

参数	描述
规则预览	触发规则的整体预览内容
* 告警级别	告警的严重等级。只能是紧急、重要、次要、提示、不重要中的一种 严重等级由大到小排序：紧急 > 重要 > 次要 > 提示 > 不重要
* 启用规则	触发规则的启用逻辑。只能是始终启用、定时启用、自定义启用中的一种 始终启用：规则全天24小时始终启用 定时启用：规则可设置每周某几天的固定时间段启用，例如每周一到周五8点至20点启用 自定义启用：规则可设置每周某几天的自定义时间段启用，例如每周六6点至18点、周日9点至12点启用
* 触发类型	触发规则的触发方式。有简单、持续时间、重复次数三种可选 简单：满足触发条件即触发 持续时间：持续满足触发条件多长时间后触发，例如持续满足触发条件5分钟触发 重复次数：重复满足触发条件多少次后触发，例如重复满足触发条件达3次触发
* 触发条件	触发条件的标识符及单个触发条件的预览内容 一条触发规则可存在多个触发条件，须全部满足条件才可触发告警
* 告警内容	此触发规则的描述/备注内容。在设备触发此规则生成告警记录时会展示给用户

点击触发条件区域表格下方的添加条件，弹窗触发条件。

选择告警规则适用的产品物模型/设备物模型的测点标识，系统自动识别所选物模型的数据类型，给出适用于当前物模型数据类型的筛选器类型，您可自由设置筛选器类型及对应的筛选值。

结合"且"/"或"这两种触发方式，可以实现多样化的复合型触发条件。

参数	描述
* 标识名称	物模型测点标识(名称)。当告警规则应用到产品不具体到单个设备时，此处选择的是产品物模型测点；当告警规则应用到具体单个设备时，此处选择的是对应设备物模型测点
* 触发方式	满足”全部”筛选器触发：满足全部的筛选器条件时才触发，即”且”的关系 满足”任一”筛选器触发：满足任一的筛选器条件时就触发，即”或”的关系
* 筛选器-类型	当物模型测点的”数据类型”是string(文本) / enum(枚举型) / json(结构体)时，比较的是字符串 当物模型测点的”数据类型”是int32(整数) / float(小数)时，比较的是数字 当物模型测点的”数据类型”是bool(布尔型)时，比较的是真假
* 筛选器-值	对应筛选器类型比较的值/内容

同一条触发规则里的多条触发条件(可对应多个物模型测点)同时满足，才能触发对应级别的告警。

每条告警规则允许配置至多5条不同级别的触发规则(默认有5种告警级别)。

另外，每条告警规则支持您配置至多1条消除规则，满足消除规则的配置时告警记录会自动消除。

点击下方添加消除规则按钮即可添加告警的消除规则，若不需要告警消除可点击卡片右上角的删除按钮取消设置消除规则。

参数	描述
规则预览	消除规则的整体预览内容
* 启用规则	消除规则的启用逻辑(同触发规则)。只能是始终启用、定时启用、自定义启用中的一种 始终启用：规则全天24小时始终启用 定时启用：规则可设置每周某几天的固定时间段启用，例如每周一到周五8点至20点启用 自定义启用：规则可设置每周某几天的自定义时间段启用，例如每周六6点至18点、周日9点至12点启用
* 触发类型	消除规则的触发方式(同触发规则)。有简单、持续时间、重复次数三种可选 简单：满足触发条件即触发 持续时间：持续满足触发条件多长时间后触发，例如持续满足触发条件5分钟触发 重复次数：重复满足触发条件多少次后触发，例如重复满足触发条件达3次触发
* 触发条件	触发条件的标识符及单个触发条件的预览内容(同触发规则) 一条消除规则可存在多个触发条件，须全部满足条件才可触发告警
* 消除内容	此消除规则的描述/备注内容。在设备触发此消除规则将告警记录消除处理时会展示给用户

最后，检查一下触发规则和消除规则的配置符合理想设定后，点击提交即可成功添加告警规则。

新添加的告警规则默认是禁用状态，需要手动启用才能正常监控设备数据生成告警记录。

管理告警规则

在运维监控-告警规则页面，您可查看到您当前租户下配置的全部告警规则，您可以查看告警规则详情、编辑告警规则、删除告警规则、启用/禁用告警规则。

点击告警规则列表操作栏的查看，打开告警规则详情页面。您可以看到当前告警规则的全部详细信息。

点击告警规则列表操作栏的编辑，打开编辑告警规则页面。除了告警规则适用的产品和设备外，其他信息都可以编辑。

点击告警规则列表操作栏的删除，可将对应告警规则从系统删除，自此不再触发告警，请谨慎操作。

若需临时使告警规则不生成告警，可点击告警规则列表操作栏的启用/禁用，变更告警规则的状态。

告警记录

当设备数据满足告警规则时，会依据设置好触发规则生成对应级别的告警记录。告警级别的判定是由大到小遍历，可能升级，但不降级。

例如设备刚开始满足次要级别告警规则，触发了次要级别的告警记录，后又满足了重要级别的告警规则，则原生成的次要级别的告警记录会升级成重要级别。

再例如设备刚开始就满足重要级别告警规则，触发了重要级别的告警记录，后不满足重要级别的告警规则但满足次要级别的告警规则，原生成的重要级别的告警记录不变，不会降级成次要级别。

一台设备对于一条告警规则同时至多存在1条告警记录，即当设备数据多次满足告警规则时，不会生成多条告警记录，直至您手动处理或系统消除。

告警严重等级由大到小排序：紧急 > 重要 > 次要 > 提示 > 不重要

告警记录的状态有以下3种：

1. 待处理：满足告警触发规则，生成的告警记录。(若存在消除规则，则当前不满足消除规则)
2. 已处理：曾满足告警触发规则，生成了告警记录，后人工手动处理了告警记录。(若存在消除规则，则在手动处理告警时未满足消除规则)
3. 已消除：曾满足告警触发规则，生成了告警记录，在手动处理前又满足告警消除规则，系统自动将告警记录标记为已消除。(仅对已配置了消除规则的告警规则才会触发)

查看告警记录

在运维监控-告警记录页面，您可查看到您当前租户下的全部设备的告警记录，列表按时间倒序排列，最新的告警记录展示在最上方，您也可以自由筛选设备/状态/时间等不同角度查看告警记录。

点击告警记录列表操作栏的查看，弹窗告警数据 。展示JSON格式告警日志的详细内容。

处理告警

对于”待处理”状态的告警记录，点击告警记录列表操作栏的处理，弹窗告警处理。手动输入处理详情内容后，点击确定即可将当前告警记录状态变更未”已处理”。

处理详情支持中文、英文字母、数字、标点符号，最多500个字符

设备调试

实体设备端配置开发完成后，您可使用物联网平台的设备远程调试功能，从物联网平台下发指令到设备端进行处理，设备响应后的处理结果也会返回展示在物联网平台。

设备调试功能仅支持对MQTT协议传输的设备！

在运维监控-设备调试页面，请先在上方选择要调试的产品及设备后，点击开始调试按钮，随后连接成功后进入设备调试状态。

在左侧调试指令区域输入下发给设备端的JSON格式的指令，随后点击发送指令即将指令发送至设备，设备收到指令后同步响应，物联网平台会将详细日志内容展示在右侧调试日志。

设备调试结束后，请手动点击上方结束调试按钮。

设备地图

设备地图是基于GIS地图实现的设备监控功能，您可以以全局视角总览设备地理位置分布及状态。

地图配置

物联网平台提供标准地图和卫星地图两种视图查看，您可以点击设备地图右上角地图样式按钮，弹窗地图配置，配置您需要的地图视图。

查看设备信息

在运维监控-设备地图页面，您可以查看到当前租户下的各设备的地理位置信息，也支持您查找单台设备。

在运维监控-设备地图页面左侧的地图区域部分，您可以通过鼠标双击/鼠标滚轮/点击缩放按钮的方式来查看您需要的地图区域。

地图上的标点以颜色区分表示设备在线/离线状态，您可以点击标点，弹窗设备概况，展示当前设备、设备状态、设备详细地理位置，设备名称及所属产品可点击跳转到对应详情页，方便您快速查看设备/产品的详细信息。

在运维监控-设备地图页面右侧的设备列表部分，默认您看到的是租户下全部有地理位置信息的设备，您可以按照产品或状态筛选设备，也可以直接输入设备标识或名称，查找到对应设备后在列表点击要查看的设备，即可快速定位到设备所处的地理位置信息并查看到设备概况。

远程升级

远程升级是由物联网平台统一管理设备固件/软件包，平台可添加升级任务并监控升级状态。需要设备具备OTA固件/软件管理功能才能实现。

添加升级包

在运维监控-远程升级页面，点击添加按钮，弹窗添加升级包。

填写升级信息并上传升级包文件，然后点击确定即可成功将升级包上传至云端管理。

参数	描述
* 升级包名称	升级包的名称。支持中文、英文字母、数字、标点符号
* 版本号	升级版本号。支持英文、数字、点号、连字符或下划线
* 升级产品	升级对象产品。可以选择租户下的任一产品，表示此升级包适用此产品的设备
* 升级类型	只能选择固件升级和软件升级的一种 固件：固件是硬件设备的灵魂，固件升级直接决定着设备的功能及性能 软件：软件是建立在固件版本之上的，软件升级可以提升体验或交互
* 签名方式	升级包的签名。默认是以SHA-256的方式生成签名，支持您选择MD5、SHA-256、SHA-384、SHA-512、CRC-32、MURMUR3-32、MURMUR3-128中的其一方式，自定义签名内容 签名对于支持安全启动的设备十分重要，设备启动过程中会对升级包的签名进行校验，签名出错可能会导致升级设备无法启动
* 升级包文件	升级包文件。文件类型只能是zip .rar .bin .apk的一种，且文件大小不超过2GB，文件名称须为1~20个英文、数字、点号、连字符或下划线
* 升级包描述	升级包的描述/备注内容。支持中文、英文字母、数字、标点符号

升级包一旦添加，不可修改。在添加升级任务到设备前，可以删除升级包。

管理升级包

在运维监控-远程升级页面，您可以查看到当前租户下的全部升级包，您可以查看升级包详细信息、添加升级任务、删除升级包。

点击升级包列表操作栏的查看，打开升级包详情页面，您可以看到当前升级包的全部详细信息。您可以在此校验签名，也可以下载升级包源文件查看。

点击升级包列表操作栏的删除，可将对应升级包从系统删除，升级包的源文件会丢失，请谨慎操作。已经添加升级任务的升级包不可被删除。

添加升级任务

点击升级包列表操作栏的升级，弹窗添加升级任务，选择本次您要升级的设备，点击确定即可将升级任务推送至设备，设备收到后会响应升级。

在运维监控-远程升级-查看-升级任务页面，点击添加按钮，也可以添加升级任务。

查看升级任务

在运维监控-远程升级-查看-升级任务页面，您可以查看到您当前升级包已经添加了的哪些设备的升级任务，您可以在此监控跟进设备升级进度状态。

点击升级任务列表操作栏的查看，弹窗升级详情，您可以查看到当前设备关于此升级包的升级历史记录。

元数据查询

物联网平台存储的遥测数据支持您随时查询、导出，方便您对设备数据进行存档分析。

在元数据查询页面，请先在上方选择要查询的”设备”-”测点”后，点击搜索按钮，随后元数据列表即展示时间由近及远的遥测数据记录明细。

您可以在线查看筛选的数据值，也可以将数据记录导出为Excel表格。

规则引擎

规则引擎是一个用于复杂事件处理的高度可定制和可配置的工具。规则引擎支持过滤、丰富和转换由物联设备上传的数据，也可以实现触发“通知”或“与外部系统进行通信”等各种操作。

以下是一些可以通过规则引擎配置的常见用例：

• 在保存到数据库之前对接收的遥测数据进行验证和转换。
• 将多个设备的遥测数据复制出来进行汇总统计。
• 自定义alarms告警规则，实现告警的创建、处理、清除。
• 调用外部系统的REST API。
• 集成第三方消息队列例如：Kafka等。

添加规则链

在规则引擎页面，点击添加按钮，弹窗添加规则链。填写对应规则链信息，然后点击确定即可成功添加规则链。

参数	描述
* 规则链名称	规则链对于用户的名称。具有唯一性。支持中文、英文字母、数字、标点符号
调试模式	规则链当前是否进入是调试模式
规则链说明	规则链说明/备注内容。支持中文、英文字母、数字、标点符号

配置规则链

新添加的规则链默认是空白的，需要手动配置。点击规则链列表操作栏的打开，进入规则链配置页面。

首先，您可从左侧节点列表拖动需要的节点到右侧画布中，在弹窗添加规则节点中填写对应信息，然后点击确定即可成功添加节点。

节点	描述
筛选	使用JS脚本筛选传入的消息，输出结果为True或False
发起者类型路由器	根据发起者类型路由传入的消息到对应的链上，如”Device”, “Asset”等
消息类型	根据消息类型过滤传入的消息，输出结果为True或False
消息类型路由器	按消息类型路由传入的消息，如消息类型满足预设则路由到对应的链，不满足则路由到其他链
发起者字段	将获取到的发起者字段映射后添加到消息元数据中
脚本转换	通过JS脚本变更消息体、消息元数据、消息类型
物模型过滤	按物模型配置的测点、属性对数据进行过滤
消息生成器	根据配置的周期规则和JS函数自动生成消息（便于模拟测试）
保存时序数据	根据配置的TTL参数保存时序数据，接受“POST_TELEMETRY_REQUEST”类型的消息
设备配置文件	根据设备配置文件来处理传入的消息，如根据设备配置文件中的告警规则，自动生成或消除告警
日志	将配置JS函数的传入消息转换为字符串，并将最终值记录到图板日志文件中
消息计数	对指定时间间隔内的消息进行计数，并生成带有消息计数的”POST_TELEMETRY_REQUEST“类型的消息
RPC调用请求	向设备发起RPC调用请求
保存属性	根据配置的属性范围保存实体属性，接受“POST_ATTRIBUTES_REQUEST”类型的消息
MQTT	以Qos为AT_LEAST_ONCE的方式，将消息发送到MQTT Broker
Rest Api调用	调用外部的Rest Api接口
kafka	通过Kafka的生产者将消息发送到Kafka服务器
······	······

其次，您需要在右侧画布中使用连接线将已添加的规则节点连接并确定关联关系，组成完整的规则链。

规则节点之间存在关联性每个节点都有对应关系类型，用于标识关系的逻辑标签。

当规则节点生成输出消息时，它总是将消息路由到下一个指定的节点并通过关系类型进行关联。

表示成功与否的规则节点关系是Success和Failure。

表示逻辑运算的规则节点可以是True或False。

一些特定的规则节点可能使用完全不同的关系类型例如：“Post Telemetry”、“Attributes Updated”等

最后，检查一下规则链的配置符合理想设定后，点击画布右上角的保存按钮，即可成功保存此规则链配置。

管理规则链

在规则引擎页面，您可查看到您当前租户下的全部规则链，您可以编辑规则链信息、导出规则链、设置为根规则链、删除规则链。

点击规则链列表操作栏的编辑，弹窗编辑规则链，所有信息都可以编辑。

点击规则链列表操作栏的设置为根规则链，可将对应规则链设置成租户的核心规则链，所有传输消息都将按此规则链进行处理。

点击规则链列表操作栏的导出，可将对应规则链导出为JSON文件。

点击规则链列表操作栏的删除，可将对应规则链从系统删除。

用户管理

每一位物联网平台的使用者，都可以看作是一位用户。

每个企业(租户)可以添加管理多名用户，用户间的操作互不影响。

添加用户

在系统管理-用户管理页面，点击添加按钮，弹窗添加用户，根据实际情况，填写对应账号个人信息，然后点击确定即可成功添加用户。

参数	描述
头像	右上角展示的头像图片。系统内设默认头像，可上传自定义图片。建议尺寸 600 * 600，格式限制为jpg/jpeg/png
* 账号	用户在系统的唯一标识且一经设置不可修改，可用于系统登录。支持英文字母、数字、符号
用户名	用户昵称。系统设有默认生成逻辑。可自定义设置。支持中文、英文字母、数字、标点符号，最多20个字符
手机号	用户手机号，限制国内手机号格式，具有唯一性(暂不可用于登录)
邮箱	用户邮箱，限制邮箱格式，具有唯一性(暂不可用于登录)
角色	可选当前租户内的角色，系统内默认租户管理员角色，不同角色拥有不同的菜单功能权限
用户说明	对用户的说明/备注内容。支持中文、英文字母、数字、标点符号

新添加的用户是未激活状态，需要手动激活并创建登录密码才能正常登录使用系统。

您可复制用户激活链接发送给账号使用者，引导其用浏览器打开，输入账号要设置的登录密码即可成功激活。

管理用户

在系统管理-用户管理页面，您可查看到您当前租户下的全部用户，您可以查看用户详细信息、编辑用户信息、启用/禁用用户账号。

点击用户列表操作栏的查看，打开用户详情页面。您可以在此看到当前账号的全部详细信息。

点击用户列表操作栏的编辑，弹窗编辑用户，除了账号不能变更外，其他信息都可以编辑。

点击用户列表操作栏的禁用，对应正常的用户状态变为”已禁用”，并限制其正常登录和使用物联网平台(仅正常状态的用户可被禁用)。

点击用户列表操作栏的启用，对应已禁用的用户状态变为”正常”，解除禁用限制使其可正常登录使用物联网平台(仅已禁用状态的用户可被启用)。

角色管理

物联网平台采用RBAC-基于角色的访问控制体系，每位用户都有所属角色，用户与权限之间通过角色进行关联。

添加角色

在系统管理-角色管理页面，点击添加按钮，弹窗添加角色，填写对应角色信息，然后点击确定即可成功添加角色。

参数	描述
* 角色标识	角色的英文名称，可以理解成角色在系统中的区分标识，同租户下唯一。支持英文字母、数字、下划线或中划线
* 角色名称	角色的中文名称，可以理解成角色对于用户的名称，同租户下唯一。支持中文、英文字母、数字、标点符号
角色描述	角色描述/备注内容。支持中文、英文字母、数字、标点符号

新添加的角色默认是没有任何权限的，需要点击角色列表操作栏的权限，弹窗分配权限，勾选您需要分配给当前角色的功能菜单项，然后点击确定即可为角色分配权限。

权限变更会实时影响所有属于该角色的用户，请变更权限时尽量考虑影响面，避免影响业务正常开展进行。

管理角色

在系统管理-角色管理页面，您可查看到您当前租户下配置的全部角色，您可以配置角色权限、编辑角色、删除角色。

点击角色列表操作栏的权限，弹窗编辑角色，您可以查看到当前角色已配置的功能菜单权限，也可以通过勾选/取消勾选配置您希望赋予当前角色的权限。

点击角色列表操作栏的编辑，弹窗编辑角色，除了角色标识不能变更外，其他信息都可以编辑。

点击角色列表操作栏的删除，可将对应角色从系统删除，已关联用户的角色不允许删除。

审计日志

物联网平台会记录系统各节点的操作日志，支持您随时筛选类型、时间段进行查看，常用于审计。

在系统管理-审计日志页面，展示时间由近及远的操作日志记录明细，您也可以查看日志的详细信息。

点击审计日志列表操作栏的添加，弹窗日志详情 。展示JSON格式操作日志的详细内容。

个人中心

物联网平台支持所有用户自行维护个人信息，包括头像、用户名、手机号、邮箱、登录密码等。

点击物联网平台右上角头像位置，再点击用户中心即可进入个人中心页面，展示当前用户账号的详细信息。

修改头像

点击头像下方的修改头像按钮，弹窗修改头像，点击图像区域选择要本地新头像文件，然后点击确定即可成功修改。

头像建议尺寸 600 * 600，格式限制为jpg/jpeg/png，图片大小不超过2M。

修改用户名

点击用户名内容后的修改，弹窗修改用户名，填写要更新的用户名，然后点击确定即可成功修改。

用户名支持中文、英文字母、数字、标点符号，最多20个字符。

更改登录密码

点击登录密码内容后的修改，弹窗修改密码，填写原登录密码及新登录密码，然后点击确定即可成功修改。

登录密码要求10-32位，且需包含大小写字母、数字、符号的两种及以上。

退出登录

点击物联网平台右上角头像位置，再点击退出登录即可退出当前账号登录，退回到系统登录页面。