资产是ThingsBoard物联网系统中的抽象实体,代表任何物理对象、空间或组织单位。 示例包括:建筑、房间、生产区域、场地、路灯、变电站或车辆。
资产的主要特征:
- 本身不产生遥测数据,但可与产生遥测的设备关联。
- 可有自身属性,如位置、类型或负责人。
- 用于分组设备及其他实体。
- 可参与层级结构,例如:变电站 ⟶ 线路 ⟶ 路灯。
- 参与ThingsBoard业务逻辑,如规则链、告警和仪表板。
资产有助于以逻辑化、高效的方式组织物联网项目,便于管理和扩展。
ThingsBoard支持通过Web界面和REST API进行资产管理。
实践视频课程 🎥
观看本实践视频课程,了解如何配置和管理ThingsBoard仪表板、资源和设备,以及如何在实际场景中使用它们。
如何创建、编辑和删除资产
租户管理员及具有相应权限的用户可在ThingsBoard中创建、编辑或删除资产。
创建资产
创建新资产:
- 进入 实体 ⟶ 资产。
- 点击右上角的「+」图标,在下拉菜单中选择「添加新资产」。
- 在资产创建表单中填写必填项:
- 名称——资产的唯一名称。
- 资产配置——默认使用「default」配置,可按需选择其他配置。
- Label、Description等可选字段可按需填写。
- 点击「添加」。
资产创建成功后会在列表中显示。
编辑资产
编辑现有资产:
- 在资产列表中定位并点击目标资产。
- 点击右侧的「铅笔」(✏️ 编辑)图标。
- 在编辑窗口中可修改以下字段:
- 名称
- 标签
- 资产配置
- 描述
- 修改完成后点击「应用更改」保存。
删除资产
删除资产:
- 在列表中找到资产并点击其旁的"垃圾桶"图标。
- 在弹出对话框中确认删除。
注意:删除资产不会删除与其关联的设备或其他实体,但会断开所有现有关系(如与设备、告警、仪表板等的关联)。
将资产设为公开
你可以将资产设为公开,使其数据对所有人可访问。 这适用于需要访问资产数据的公开演示仪表板或开放数据场景。
- 点击目标资产旁的“Make asset public”图标。
- 在弹窗中确认操作。
资产已公开。
如需取消公开并设为私有:
- 点击资产旁的"使资产私有"图标。
- 在弹出对话框中确认操作。
资产设为私有后将不再公开,引用它的公开仪表板也将无法访问其数据。
将资产分配给客户
你可以将资产分配给特定客户,以确保只有该客户相关用户可访问资产及其数据。
这是实现数据访问控制的关键步骤。客户用户只能看到自己被分配的资产,无法访问其他客户的资产或数据。
将资产分配给客户:
- 在列表中找到目标资产。
- 点击“Assign to customer”图标。
- 从下拉列表选择目标客户。
- 点击“Assign”确认。
该客户现在可访问资产及其数据。
之后可以按需取消分配或重新分配给其他客户。
- 点击"从客户取消分配"图标。
- 在弹出对话框中确认操作。
资产详情
点击资产可打开详情窗口,查看并管理该资产的各个方面。
复制资产ID
用于快速获取资产的唯一UUID。点击Copy asset Id即可复制到剪贴板。该ID用于API调用、集成与脚本。
属性
此选项卡显示与资产相关的客户端、服务端与共享属性,即静态或半静态键值对,如位置、类别、配置参数等元数据。
最新遥测
显示与资产关联的最新遥测值。遥测可来自关联设备,也可为建模手动添加。
- 添加遥测:点击“+”图标,输入键名、值类型和值。
- 删除遥测:点击垃圾桶图标,选择删除模式(全部数据、最新值、除最新外全部或按时间范围),并确认。
字段计算
显示通过公式基于现有属性或遥测计算得到的字段值,可在不修改设备固件的情况下派生参数。更多说明见字段计算。
告警规则
包含为该资产配置的告警规则,可查看阈值、触发逻辑与告警动作。更多说明见告警规则。
告警
显示与资产相关的全部当前及历史告警,用于跟踪警告、运行问题与关键事件。
事件
显示与资产相关的系统事件,如日志、警告、错误与生命周期活动,便于诊断与运维分析。
关系
显示该资产与设备、仪表板、资产、规则链等实体之间的有向关系,有助于理解系统结构中的交互关系。
审计日志
提供与资产相关的用户操作记录,包括创建、更新、配置变更与删除,用于审计与变更跟踪。
版本控制
支持使用基于Git的版本控制服务导出和恢复资产相关实体,用于备份、协作与配置版本管理。
管理资产关系:新增、查看、编辑、删除
在资产页面中,你可以创建、查看、编辑和删除资产与其他实体(资产、设备、客户等)之间的关系。详见实体与关系。
管理指定资产与其他实体的关系:
- 打开资产详情 ➜ 进入 Relations 选项卡。
新增关系:
- 在Direction选择器中选择 From(出站)或 To(入站)。
- 点击“+”图标(Add)。
- 在 Add relation 窗口中设置 Relation type(如 Contains、Manages),并选择 To entity(实体类型与目标实体)。
- 点击 Add 确认。
查看与筛选关系:
- 在“From”与“To”之间切换查看出站/入站关系。
- 使用搜索图标按关系类型或实体筛选。
编辑关系:
- 在列表中点击“铅笔”图标修改关系类型或目标实体,然后 Save。
删除关系:
- 点击关系旁的“垃圾桶”图标并确认删除。
后续步骤
-
连接设备 - 根据连接技术或方案学习如何连接设备。
-
数据可视化 - 配置ThingsBoard复杂仪表盘的说明。
-
数据处理与操作 - 学习使用ThingsBoard规则引擎。
-
IoT数据分析 - 学习使用规则引擎执行基本分析任务。
-
高级功能 - 了解ThingsBoard高级功能。
-
贡献与开发 - 了解ThingsBoard贡献与开发。