核心概念

使用加加云桥之前，建议先花三分钟了解平台的核心概念。这些词会贯穿所有文档页面，理解了它们，后面的操作就顺理成章。

设备与接入

设备（Device）

设备是平台的监控对象——一台温湿度传感器、一部电梯、一个电表，都可以是一台"设备"。每台设备在平台里有一条独立的档案记录，包括名称、类型、在线状态等。

直连设备

自己连接平台的设备。它通过 MQTT 协议直接与平台通信，用平台分配的访问令牌（Access Token）证明身份。

网关设备

现场设备多、协议杂时，通常由一台网关统一汇聚数据：网关自己连接平台，其下的子设备不直接连平台，数据由网关代为上报。平台按子设备的外部 ID区分数据归属。

外部 ID

子设备在网关侧的标识。网关上报数据时用"设备名"标记数据属于哪台子设备，这个名字必须与平台建档时填写的外部 ID 完全一致，否则数据会被丢弃。

访问令牌（Access Token）

每台设备创建后由平台生成的一串凭证，等同于设备的身份。设备连接 MQTT 时把它填入用户名即可完成认证。令牌在设备详情页随时可以查看，请妥善保管、不要外传。

数据

遥测（Telemetry）

设备随时间不断上报的测量数据，如温度、湿度、电压。每个数据点带有时间戳，平台会长期保存并支持画历史曲线。遥测是平台里数据量最大、更新最频繁的数据。

属性（Attribute）

描述设备相对稳定的状态信息，如设备型号、固件版本、安装位置。与遥测不同，属性同一个名字只保留最新一个值，适合存放"这台设备现在是什么状态"而不是"它随时间怎么变"。

数据点与时间戳

每条遥测数据就是一个数据点：字段名 + 值 + 时间戳。字段名由设备端决定，平台原样展示；时间戳可以由设备自带（推荐），也可以省略、由平台按收到报文的时间补上。

告警

告警规则（计算字段）

一条"数据满足什么条件就触发告警"的规则。规则绑定在某台设备上，可以配置多个严重等级的条件组（如温度超 60° 触发"警告"、超 80° 触发"严重"），还支持"持续 N 分钟才算超限"这类防抖条件，以及满足某条件后自动清除告警的清除规则。

告警等级

告警按严重程度分为五级：未知、警告、次要、重要、严重。在规则里按等级配置不同的触发条件。

告警状态

一条告警的生命周期用状态表达：活跃（条件触发中）→ 已确认（人工确认过、正在处理）→ 已清除（数据恢复正常，或人工清除）。全程留痕，方便事后复盘。

组织与权限

租户（Tenant）

使用平台的独立企业单位。不同租户之间数据完全隔离，互相看不见对方的设备、数据和告警。租户拥有设备数、用户数、每日消息量等资源配额。

客户（Customer）

租户内部再细分的交付对象。设备可以分配给客户，客户账号登录后只能看到分配给自己的设备——这是设备厂商"把系统开放给最终用户"的关键机制。

三级角色

平台的权限体系：系统管理员（平台运营方，管租户与配额）→ 租户管理员（企业管理员，管设备、告警、客户）→ 客户用户（最终使用者，只读）。详见《角色分级规则》。

配额

每个租户都有一份配额模板约束资源用量：最大设备数、最大客户用户数、每日最大消息数。其中每日消息数超限后，当天超出的报文会被直接丢弃，因此大批量接入前请先评估上报频率。

---

下一步：想动手操作，直接进入《快速上手》。