2. 告警规则触发条件：基于时间序列数据的阈值触发、基于属性的条件触发、基于生命周期事件的触发
告警规则的触发条件是整个告警系统的“感知层”。ThingsBoard 提供了三种核心触发模式，分别对应设备运行过程中的不同数据维度：持续变化的时间序列数据、相对静态的设备属性，以及设备与平台交互的生命周期事件。理解这三种触发方式的适用场景与配置差异，是构建精准告警体系的基础。
2.1 触发条件类型概览
| 触发类型 | 数据来源 | 典型场景 | 评估频率 |
|---|---|---|---|
| 时间序列阈值触发 | 遥测数据流（温度、湿度、电压等） | 温度超过 60°C、电机电流异常波动 | 每次遥测上报时评估 |
| 属性条件触发 | 客户端/服务端/共享属性 | 设备固件版本过低、配置参数变更 | 属性更新时评估 |
| 生命周期事件触发 | 平台内部事件（连接、断开、激活、停用） | 设备离线超过 5 分钟、新设备首次激活 | 事件发生时即时触发 |
设计建议：在实际项目中，建议将“时间序列阈值触发”用于实时监控，“属性条件触发”用于配置合规检查，“生命周期事件触发”用于设备运维管理。三者可以组合使用，形成多层告警防护网。
2.2 基于时间序列数据的阈值触发
这是最常用的触发方式，适用于对设备上报的连续数值型遥测数据进行实时评估。ThingsBoard 支持多种阈值比较逻辑，包括：大于、小于、等于、范围内外、变化率等。
2.2.1 阈值触发配置参数
| 参数 | 说明 | 示例值 |
|---|---|---|
| 数据键 (Key) | 遥测数据中的字段名称 | temperature |
| 比较类型 | 大于、小于、等于、范围内、范围外 | GREATER_THAN |
| 阈值 | 触发告警的临界值 | 60.0 |
| 持续时间 | 条件满足后持续多久才触发（防抖动） | 300000 (5分钟) |
| 动态阈值 | 是否使用其他遥测键作为阈值来源 | max_temp_limit |
2.2.2 防抖动机制
设备数据在传输过程中可能存在瞬时毛刺或短暂波动。为避免告警频繁触发与恢复，ThingsBoard 提供了“持续时间”参数。只有当条件持续满足设定的时间窗口后，告警才会正式进入“已触发”状态。
配置示例：温度告警规则中设置“持续时间”为 300000 毫秒（5 分钟）。如果温度在 5 分钟内持续高于 60°C，则触发告警；如果期间温度回落，计时器自动重置。
2.3 基于属性的条件触发
属性触发关注的是设备的“状态”而非“数据流”。属性通常变化频率较低，但每次变更都可能意味着设备配置或状态的重大变化。ThingsBoard 支持对客户端属性、服务端属性和共享属性进行条件评估。
2.3.1 属性触发适用场景
- 固件版本合规检查：当设备上报的
firmwareVersion属性低于指定版本时触发告警。 - 配置参数异常：设备的
samplingInterval属性被修改为不合理值（如小于 1 秒）。 - 地理位置越界：设备的
latitude/longitude属性超出预设的地理围栏范围。
2.3.2 属性触发与时间序列触发的区别
| 对比维度 | 时间序列阈值触发 | 属性条件触发 |
|---|---|---|
| 数据变化频率 | 高（秒级/分钟级） | 低（小时级/天级） |
| 数据存储方式 | 时序数据库（Cassandra/TimescaleDB） | 键值存储（Redis/PostgreSQL） |
| 典型数据类型 | 数值型（浮点数、整数） | 字符串、布尔值、JSON 对象 |
| 防抖动支持 | 支持（持续时间参数） | 不支持（属性变更即触发） |
2.4 基于生命周期事件的触发
生命周期事件触发不依赖设备上报的数据，而是由 ThingsBoard 平台内部的事件总线驱动。当设备与平台之间的连接状态或设备本身的状态发生变更时，平台会自动生成事件并触发告警规则。
2.4.1 支持的生命周期事件类型
- 设备连接事件：设备成功连接到平台（MQTT/CoAP/HTTP）。
- 设备断开事件：设备与平台断开连接（正常断开或超时断开）。
- 设备激活事件：设备状态从“未激活”变为“激活”。
- 设备停用事件：设备状态从“激活”变为“停用”。
- 设备创建/删除事件：设备实体被创建或从平台中删除。
2.4.2 离线告警的典型配置
离线告警是生命周期事件触发最常见的应用。配置时需注意：
- 在告警规则中选择“设备断开事件”作为触发条件。
- 设置“告警类型”为
DEVICE_OFFLINE。 - 在“告警详情”模板中引用设备名称和断开时间。
- 可选：结合“清除规则”在设备重新连接时自动清除告警。
注意事项：生命周期事件触发不支持“持续时间”防抖动参数。设备频繁闪断（短时间内多次连接/断开）会导致告警风暴。建议在设备端或网络层增加重连延迟策略，或在告警规则中启用“告警去重”功能。
2.5 三种触发方式的协同关系
以下 SVG 图展示了三种触发方式在 ThingsBoard 告警引擎中的协同工作流程：
2.6 复合条件触发
在实际项目中，单一触发条件往往不足以准确描述告警场景。ThingsBoard 允许在一条告警规则中组合多个触发条件，支持 AND 和 OR 逻辑运算。
2.6.1 复合条件配置示例
规则名称：高温且离线复合告警
触发条件：
- 条件 A（时间序列）：temperature > 50°C（持续 2 分钟）
- 条件 B（生命周期）：设备断开事件
逻辑关系：A AND B
告警消息：设备 {{deviceName}} 在高温状态下离线，温度 {{temperature}}°C
最佳实践：复合条件触发时，建议将变化频率较高的条件（如时间序列阈值）作为主条件，将变化频率较低的条件（如属性值）作为辅助条件。这样可以减少评估引擎的计算开销，同时保证告警的准确性。
2.7 触发条件配置注意事项
- 数据键名一致性：确保告警规则中引用的数据键名与设备上报的遥测/属性键名完全一致（区分大小写）。
- 阈值范围合理性：避免设置过于敏感的阈值（如温度波动 0.1°C 即触发），建议结合历史数据分布确定合理阈值。
- 生命周期事件延迟：设备断开事件可能存在数秒的检测延迟（取决于 MQTT Keep Alive 设置），在设计离线告警时需考虑此延迟。
- 测试验证：在规则上线前，使用模拟设备或测试环境验证触发条件的正确性，避免误报或漏报。