使用场景
假设您的制冷设备配备温度传感器,定期向ThingsBoard上报遥测数据。
正常工作温度范围为2°C至5°C。若上报温度超出此范围,应视为异常状态。
目标是:
- 当温度低于 2°C 或高于 5°C 时创建告警
- 当温度回到可接受范围内时自动清除告警
虽然示例做了简化,但展示了适用于冷藏存储、食品物流和工业制冷系统等实际IoT部署场景的通用遥测监控模式。
为突出平台能力而非手动配置,本指南使用可导入到ThingsBoard的预设告警规则配置。 您可快速理解告警规则的工作方式,查看其逻辑,并在自己的IoT场景中复用或调整。
前置条件
在继续前,请先阅读 告警规则 文档,了解本指南中使用的告警创建、触发条件和告警生命周期管理概念。
此外,需要有一台设备用于测试告警触发,可使用现有设备或按以下步骤新建设备:
- 进入 实体 ⇾ 设备。
- 点击右上角 「+ 添加设备」 按钮,选择 「添加新设备」。
- 使用如下参数创建设备:
• 设备名称:Thermometer
• 设备配置:thermostat - 点击 添加 完成创建。
设备即可上报遥测并用于告警规则测试。
建议:在设备配置级别应用告警规则,避免为多台同类型设备重复配置,并保证告警行为一致。
告警规则配置
需要创建两条独立的告警规则,分别负责不同温度阈值和告警类型。
高温告警规则
- 告警类型:高温
- 创建告警条件:温度 > 5°C
- 清除告警条件:温度 ≤ 5°C
低温告警规则
- 告警类型:低温
- 创建告警条件:温度 < 2°C
- 清除告警条件:温度 ≥ 2°C
每次收到目标实体的遥测时都会评估告警规则:
- 读取上报的温度值
- 与创建和清除条件进行比较
- 若满足条件,则创建、更新或清除告警
步骤1. 导入高温告警规则
- 下载 高温告警规则 配置文件。
- 进入 告警 ⇾ 告警规则。
- 点击右上角 「+ 添加告警规则」,选择 「导入告警规则」。
- 指定您的设备或设备配置作为目标实体。
- 点击 添加 完成导入。
步骤2. 导入低温告警规则
- 下载 低温告警规则 配置文件。
- 在 告警 ⇾ 告警规则 中点击 「+ 添加告警规则」,选择 「导入告警规则」。
- 指定您的设备或设备配置作为目标实体。
- 点击 添加。
验证告警触发
要验证告警规则是否正常,请上报若干温度值。
最简单的方式是使用 检查连接。也可使用以下命令:
⚠️ 请将
• $THINGSBOARD_HOST_NAME 替换为您的ThingsBoard主机名或IP地址。
• $ACCESS_TOKEN 替换为设备访问令牌。
-
触发高温告警。
上报超过上限的温度值(例如7°C)。1
curl -v -X POST http://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header Content-Type:application/json --data "{temperature:7}"
-
清除高温告警。
上报正常范围内的温度值(例如4°C)。1
curl -v -X POST http://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header Content-Type:application/json --data "{temperature:4}"
-
触发低温告警。
上报低于下限的温度值(例如1°C)。1
curl -v -X POST http://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header Content-Type:application/json --data "{temperature:1}"
-
清除低温告警。
再次上报可接受范围内的温度值(例如4°C)。1
curl -v -X POST http://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header Content-Type:application/json --data "{temperature:4}"
每步完成后,在 告警 页面、设备详情内的对应标签页或dashboard上查看告警状态,确认行为正确。