Smart Alert field definitions
What this is
Every badge and field on the Smart Alerts tab, so the guide can stay short. For the steps, see Set up a Smart Alert.
Alert states
The badge on each alert in the list:
- Watching - enabled, condition currently false. The normal resting state.
- Triggering - the condition has gone true and is counting down Must hold for (s). Nothing sent yet.
- Active - the condition held, and you have been notified.
- Clearing - the condition has gone false and is counting down Clear after (s).
- Needs attention - the condition cannot be worked out at all, usually a value that has been deleted or renamed, or a threshold left blank. The reason is shown in the alert's row.
- Off - Enabled is cleared. Kept, but not watching.
An alert in Needs attention will never notify you. It is not a warning about your site, it is a warning about the alert itself. An alert already Active stays Active instead, so a reading that drops out never clears it.
Severity
Treat it as sets how urgent the alert reads. It does not change how the condition is evaluated and it does not choose a channel:
- Info - worth recording, not worth interrupting anyone.
- Warning - somebody should look today.
- Error - somebody should look now.
Every Smart Alert, at any level, is delivered under one notification category called Smart alerts. Whether that reaches your inbox as well as the in-app bell is set per person, not per alert. See Choose what you are notified about and Notification categories and settings field definitions.
Timing
- Must hold for (s) - how long the condition must stay true before you are notified. Zero notifies on the first reading.
- Clear after (s) - how long the condition must stay false before the alert clears.
- Notify once, do not track clearing - the alert still goes Active and still waits for the condition to go false before it re-arms; what it skips is the clearing notification. Use it for events with no natural end.
- Only during - restrict the alert to a time window and chosen weekdays. Outside the window the condition counts as false.
Condition rows
- IF and AND / OR - rows read in order, left to right, with no bracketing. OR does not bind tighter than AND. A rule holds at most 8 rows.
- Fixed value / Variable - compare against a number you type, or against another live reading.
- is / is not - shown instead of the usual comparisons when the value is only ever on or off. The two states are then offered by name.
Delivery
- Message - your own notification text. Left blank, the alert describes itself.
- Insert into message - the placeholders available, one pair per condition row. Each chip names the value it will read, so
{A1}and{B1}are the left and right side of the first row,{A2}and{B2}the second. Selecting a chip inserts it at your cursor. - Open on tap - which device the notification opens when tapped. Left on Automatic, it works this out from the values the alert uses.
Placeholders follow the row position, not the value. If you delete a condition row, the placeholders after it read a different value than they did before.
Numbered placeholders need logger software 9.335 or newer. Below that the legend offers only the first row, as {A} and {B}.
Tips for reading the list
- The coloured stripe on the left of each row is the severity, not the state. A red stripe on a Watching alert means an Error-level alert that is currently fine.
- The line at the top of the tab is how many alerts this logger holds and how many are Active. A logger holds at most 32.
- The list refreshes itself every few seconds. Refresh is only needed after changing something elsewhere, such as adding a computed variable.