Skip to content

Create and Clear Alarms

Monitor a temperature sensor and automatically create and clear alarms when readings go outside an acceptable range. This recipe uses importable alarm rule configurations so you can examine the logic and adapt it for your own scenario.

Assume your refrigeration equipment has a temperature sensor that periodically publishes telemetry to iRis Cloud. The normal operating range is 2 °C – 5 °C. Outside this range, the condition is treated as abnormal:

  • Create an alarm when temperature drops below 2 °C or rises above 5 °C.
  • Clear the alarm automatically when temperature returns to the normal range.

This pattern applies to cold storage, food logistics, and industrial refrigeration monitoring.

Review the Alarm rules documentation before proceeding — it covers alarm creation, trigger conditions, and the alarm lifecycle.

You also need a HMI Device to test with. Use an existing HMI Device or create a new one:

  1. Navigate to Entities ⇾ Devices.
  2. Click + and select Add new device.
  3. Set Name to Thermometer, enter the HMI Device’s Access token, and click Validate. Leave License code empty to use the free trial, or enter a license code and click Validate (see Register a License to a HMI Device).
  4. Click Add.
  5. Click Thermometer in the list, click the edit (pencil) button, set Device profile to thermostat, and click Apply changes.

Two alarm rules cover the two failure conditions:

RuleAlarm typeSeverityCreate whenClear when
High temperatureHigh temperatureCriticaltemperature > 5temperature ≤ 5
Low temperatureLow temperatureWarningtemperature < 2temperature ≥ 2

Each rule is evaluated on every incoming telemetry message: the value is read, compared against the create and clear conditions, and the alarm is created, updated, or cleared accordingly.

Step 1. Import the High temperature alarm rule

Section titled “Step 1. Import the High temperature alarm rule”
  1. Download the alarm rule configuration file: high_temperature_alarm_rule.json
  2. Go to Alarms ⇾ Alarm rules.
  3. Click + and select Import alarm rule.
  4. Upload the downloaded file.
  5. Click Import.
  6. Specify your HMI Device or device profile as the target entity.
  7. Click Add.

Step 2. Import the Low temperature alarm rule

Section titled “Step 2. Import the Low temperature alarm rule”
  1. Download the alarm rule configuration file: low_temperature_alarm_rule.json
  2. In Alarms ⇾ Alarm rules, click + and select Import alarm rule.
  3. Upload the downloaded file.
  4. Click Import.
  5. Specify your HMI Device or device profile as the target entity.
  6. Click Add.

Publish test telemetry values using Check connectivity or the curl commands below.

Trigger the High temperature alarm — publish a value above 5 °C: