实体概述
在 ThingsBoard 中,实体 是表示平台内物理对象或业务概念的核心组件。您可在此查看ThingsBoard实体列表。
ThingsBoard Edge 支持与边缘计算相关的实体。
可用的Edge实体
- Devices(设备): 物理物联网设备(传感器、执行器、控制器)。
- Assets(资产): 用于分组和管理物联网生态系统的真实世界对象(例如机器、建筑、工厂)。
- Customers(客户): 分配给特定设备/资产的组织或用户。
- Users(for PE)(用户): 管理并与边缘资源交互的人员。
- Entity Views(实体视图): 所选实体数据的预定义视图。
- Alarms(告警): 异常或预定义条件的警报。
- Dashboards(仪表板): 遥测及设备数据的可视化。
- Rule Chains(规则链): 本地数据处理与自动化逻辑。
除 Customers 和 Users 外,大多数实体可在 Edge 上创建。这些实体可在 Server 上创建,然后 分配 给 Edge实例。
Devices 和 Assets 实体分别具有 Device Profiles 和 Asset Profiles 配置模板。
实体核心功能
属性
Attributes(属性)是与实体相关的结构化数据(如设备型号、位置、token)。 其存储在本地数据库中,可用于可视化、分析、逻辑配置及与其他服务集成。
若要全面了解 ThingsBoard属性,请参阅 Working with IoT Attributes 文档。 您也可参阅Edge Attributes文章,了解 Edge 特有属性。
遥测
Telemetry(遥测)指从物联网设备收集并由 Rule Chain 处理的 时序数据。
Telemetry 以 键值对 形式存储:
- Key(键): 遥测字段(如temperature、humidity、voltage)。
- Value(值): 数值或字符串(如25.4°C、45%、”ON”)。
示例:
1
2
3
4
5
{
"temperature": 25.4,
"humidity": 45,
"status": "ON"
}
您可在此了解更多关于遥测数据的使用。
默认情况下,ThingsBoard Edge 与 ThingsBoard Cloud 同步遥测数据。 在互联网中断期间,遥测 本地 存储,并在连接恢复后发送到 Cloud。
关系
Relation(关系)功能定义实体间的连接,并帮助建模物理对象之间的真实层级关系。
以下参数定义实体间的关系层级:
- Direction(方向): 描述实体之间的关联方式。
- “Outbound relation - From”: 表示关系 源自 该实体(该实体为源)。
- “Inbound relation - To”: 表示关系 指向 该实体(该实体为接收方)。
- Relation type(关系类型): 描述实体间连接的性质。
- “Contains”: 表示实体是另一个实体的一部分(如Device A是Asset A的一部分)。
- “Manages”: 表示实体负责管理另一个实体(如Asset A管理Device A)。
实体关系图示例如下:

下一步
-
Getting started guide(入门指南)- 快速概览 ThingsBoard Edge 主要功能。预计 15–30 分钟完成:
-
Installation guides(安装指南)- 了解如何在各种操作系统上安装 ThingsBoard Edge 并连接到 ThingsBoard Server。
-
Edge 规则引擎:
-
Rule Chain Templates(规则链模板)- 了解如何使用 ThingsBoard Edge 规则链模板。
-
Provision Rule Chains from cloud to edge(从云端向 Edge 下发规则链)- 了解如何从云端向 Edge 下发边缘规则链。
-
- 安全:
- gRPC over SSL/TLS - 了解如何为 Edge 与云端之间的通信配置 gRPC over SSL/TLS。
-
功能:
-
Edge Status(Edge 状态)- 了解 ThingsBoard Edge 上的 Edge Status 页面。
-
Cloud Events(云端事件)- 了解 ThingsBoard Edge 上的 Cloud Events 页面。
-
-
使用场景:
-
Manage alarms and RPC requests on edge devices(在边缘设备上管理告警和 RPC 请求)- 本指南展示如何在 Edge 上生成本地告警并向连接到 Edge 的设备发送 RPC 请求:
-
Data filtering and traffic reduce(数据过滤与流量削减)- 本指南展示如何从 Edge 向云端仅发送过滤后的设备数据:
-
- Roadmap(路线图)- ThingsBoard Edge 路线图。