产品定价 立即试用
专业版
创建与清除告警
入门 文档 指南 安装 架构 API 常见问题
目录

创建与清除告警

使用场景

假设您的制冷设备配备温度传感器,定期向ThingsBoard上报遥测数据。

正常工作温度范围为2°C至5°C。若上报温度超出此范围,应视为异常状态。

目标是:

  • 当温度低于 2°C 或高于 5°C创建告警
  • 当温度回到可接受范围内时自动清除告警

虽然示例做了简化,但展示了适用于冷藏存储食品物流工业制冷系统等实际IoT部署场景的通用遥测监控模式

为突出平台能力而非手动配置,本指南使用可导入到ThingsBoard的预设告警规则配置。 您可快速理解告警规则的工作方式,查看其逻辑,并在自己的IoT场景中复用或调整。


前置条件

在继续前,请先阅读 告警规则 文档,了解本指南中使用的告警创建、触发条件和告警生命周期管理概念。

此外,需要有一台设备用于测试告警触发,可使用现有设备或按以下步骤新建设备

  1. 进入 实体 ⇾ 设备
  2. 点击右上角 「+ 添加设备」 按钮,选择 「添加新设备」
  3. 使用如下参数创建设备:
     • 设备名称:Thermometer
     • 设备配置:thermostat
  4. 点击 添加 完成创建。

设备即可上报遥测并用于告警规则测试。

建议:在设备配置级别应用告警规则,避免为多台同类型设备重复配置,并保证告警行为一致。


告警规则配置

需要创建两条独立的告警规则,分别负责不同温度阈值和告警类型。

高温告警规则

  • 告警类型:高温
  • 创建告警条件:温度 > 5°C
  • 清除告警条件:温度 ≤ 5°C

低温告警规则

  • 告警类型:低温
  • 创建告警条件:温度 < 2°C
  • 清除告警条件:温度 ≥ 2°C

每次收到目标实体的遥测时都会评估告警规则:

  • 读取上报的温度值
  • 与创建和清除条件进行比较
  • 若满足条件,则创建、更新或清除告警

步骤1. 导入高温告警规则

  1. 下载 高温告警规则 配置文件。
  2. 进入 告警 ⇾ 告警规则
  3. 点击右上角 「+ 添加告警规则」,选择 「导入告警规则」
  4. 指定您的设备设备配置作为目标实体。
  5. 点击 添加 完成导入。

步骤2. 导入低温告警规则

  1. 下载 低温告警规则 配置文件。
  2. 告警 ⇾ 告警规则 中点击 「+ 添加告警规则」,选择 「导入告警规则」
  3. 指定您的设备设备配置作为目标实体。
  4. 点击 添加

验证告警触发

要验证告警规则是否正常,请上报若干温度值。
最简单的方式是使用 检查连接。也可使用以下命令:

⚠️ 请将
 • $THINGSBOARD_HOST_NAME 替换为您的ThingsBoard主机名或IP地址。
 • $ACCESS_TOKEN 替换为设备访问令牌。

  1. 触发高温告警。
    上报超过上限的温度值(例如7°C)。

    1
    
    curl -v -X POST http://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header Content-Type:application/json --data "{temperature:7}"
    
  2. 清除高温告警。
    上报正常范围内的温度值(例如4°C)。

    1
    
    curl -v -X POST http://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header Content-Type:application/json --data "{temperature:4}"
    
  3. 触发低温告警。
    上报低于下限的温度值(例如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. 清除低温告警。
    再次上报可接受范围内的温度值(例如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上查看告警状态,确认行为正确。


另请参阅


后续步骤