New: the AI firewall watches every module and explains each incident in plain words. See how it works

Troubleshooting rules and alarms

Why an alarm did not open, repeats or never clears, and why a Rules-card rule did not run, ran twice or was refused, with the checks to make.

Work through the table for your symptom. Most problems are a key that does not match, a debounce that waits for readings that never come, or a place in Manual.

An alarm did not open

CheckHow
The root flow evaluates alarm rulesThe organisation’s (or profile’s) root flow must contain the Alarm rules block. See Hosts, the root flow and profile root flows.
The data is stored at allOpen the device’s Telemetry tab. No values means the problem is earlier. See Data does not arrive.
The key matches exactlyKeys are case-sensitive. The rule list marks Unknown key for keys the profile does not declare.
The rule is enabled and savedThe tab shows unsaved changes until you click Save rules.
The device belongs to this profileRules apply to the profile’s devices only.
The value is a number>, <, >=, <= on text that is not a number are always false.
The threshold attribute existsWith { "attribute": … }, a device without that server or shared attribute is not checked.
The debounce can be reachedWith Seconds (device time), the time advances only when readings arrive. A device that reports every 10 minutes needs at least two true readings.
The topic filterA leaf with Only from topic ignores messages from other topics.
The reading is not late or out of orderReadings older than the newest one evaluated are skipped (unless evaluateBackfill). Late readings open alarms quietly, with Backfilled.

An alarm opened but nobody was told

See Troubleshooting notifications. Common causes: the rule has no notify block, the severity is below minSeverity, the device is muted, the alarm was backfilled, or the change was throttled (timeline: Notification held back (throttle)).

The same alarm opens again and again

CauseFix
The value hovers at the thresholdAdd hysteresis, or debounce by readings.
The alarm flaps faster than dampening allowsIt is marked Flapping and held open; raise holdSec or maxTransitions.
Two rules of the same typeImpossible in one profile; but a flow block may raise the same type. Check Related > Raised by on the alarm page.

One alarm per device and type is the rule: a condition that fires again while the alarm is active only increases Fired n times.

An alarm never clears

CauseFix
An explicit clear condition that never becomes trueCheck the device sends that key and value.
The device stopped sending the rule’s keysMessages without the rule’s keys are no samples. Clear by hand, or add an offline alarm.
Duration debounce with no new readingsSame: nothing advances without readings.
Flapping holdClears after the condition has been clear for holdSec.
The rule was switched offIts open alarms stay open. Clear them by hand or switch the rule on.
Raised by a Rules-card action or a flowSuch alarms have no condition; they clear only by a clear action, a flow or a person.

An alarm opened again right after I cleared it

It should not: after a manual clear the rule waits until the condition has been false once. If a new alarm opened, the condition did go false and true again, or a flow raised it. Check the timeline.

A Rules-card rule did not run

CheckHow
The place is in ManualThe card shows the banner, the rule shows Stopped: Manual. Also check assets above the place.
The rule is Off or Needs attentionSwitch it on; edit and save a rule that needs attention.
The trigger is an edgerises above fires only when the value crosses. If it was already above when you saved, nothing fires until it drops and rises again. Use Run now, or go to Auto with Apply the rules now.
“stays so for” was cancelledA message that ended the match cancels the wait.
A condition was falseHistory names the first failing condition (“Room 1 · temperature is 26.4, not above 28”).
A missing value“… has no stored value”: the device never sent that key, or it is an attribute rather than telemetry.
Time zoneA time trigger uses the organisation’s time zone; time windows use the place’s. See Time, sunrise/sunset, dates and holidays.
HolidayWithout a holiday calendar no day is a holiday.
OverlapWith Ignore the new one, a trigger while a run is under way (including its waits) is ignored.
The guard paused itPaused by a guard: the automation engine paused the rule’s flow. See Protections and failed messages.

A rule ran but a device did nothing

Message in HistoryMeaning
“skipped: device is in Manual”The device or an asset above it is in Manual.
A failed command stepThe command was refused or timed out; open the device’s commands. See Commands do not reach the device.
“no device to act on”The Every profile row has no device in the place.
“n devices; only the first 200 are acted on”Split the rule by place or profile.

A rule ran twice

  • Two triggers fired (for example goes offline and an alarm on the same event). Use Ignore the new one.
  • A value trigger with changes fires on every change, including small ones.
  • Run them side by side lets runs overlap.

Saving is refused

MessageFix
“Type the value to compare with.”Fill in the value of the trigger.
“Type the lowest and the highest value of the range.”Both ends, lowest first.
“Sunrise and sunset need the place’s location: set it on the place first.”Set latitude and longitude on the asset.
“Only a rule that just notifies or raises alarms may run in Manual; …”Untick Also runs in Manual.
“Starting another rule hands the run over to it, so it has to be the last step …”Move Start it to the end.
“A rule cannot switch or run itself.”Pick another rule.
“At most 20 actions, the ones inside choices included.”Split the rule.
“… is not a device of this place.” / “More than one device is called …”Fix the formula’s device names.
“This device type has no such command.”The profile’s command catalog does not have it.
A permission errorYou may not send one of the rule’s commands, or you lack Add, change, switch on or off and delete rules.

Alarm rules cannot be saved

MessageFix
“A key names a telemetry key: no spaces and not a number.”Put the value in Value, not in Key.
“Another rule of this profile has this type.”Types are unique per profile.
“Between 10 seconds and 7 days.”The offline delay is out of range.
“The alarm rules changed at the same time; try again.”Reload and save again.

Still stuck? See Getting help.