Alert Rules let you get notified for device conditions that commonly require attention, such as Portal Lights going offline (so data is not received by Kio Cloud) and battery-powered devices with low battery levels.
Important: Device prerequisite: For an Alert Rule to monitor a device, the device's Deployment Status must be set to Deployed. See Manage the Deployment Status of your devices.
Before you begin
Managing Alert Rules is restricted to users assigned the Administrator role in Device Health.
Types of alerts
Device Health has two alert types. For the full settings of each rule type, see About Device Health Alert Rules.
| Alert type | Description | Condition (when reached, an alert is triggered) |
|---|---|---|
| Portal Light Offline | Monitors a Portal Light's connection to Kio Cloud, confirming it is connecting to the local Wi-Fi network and sending data to Kio Cloud. An Offline status is commonly caused by a network or power issue, or by no BLE devices being within range of a Portal Light. | When any Portal Light is offline for a specified amount of time; when a specified quantity of Portal Lights are offline; when a specified percentage of Portal Lights are offline. |
| Battery Level | Monitors the battery levels of battery-powered BLE devices, so you know when a device's remaining battery life is getting low and can schedule a replacement. | When any device has a battery level below a specified percentage; when a specified quantity of devices have a battery level below a specified percentage. |
Device Health also offers an Escalation alert type. You use it to create an Escalation Alert Rule that notifies an additional Group when an alert still needs attention after a set amount of time. See About escalation alerts, Create an Escalation Alert Rule, and Add an escalation to an Alert Rule.
How to create a new Alert Rule
From the Kontakt.io Launchpad, select Device Health.
From the Settings menu, select Alert Rules.
-
Select Create Alert Rule, then select the alert type — Portal Light Offline or Battery Level.
The rule wizard opens and guides you through each step. The steps shown depend on the alert type.
General. Enter an Alert Name that uniquely identifies the rule, and choose the Alert Severity — Critical, High, Medium, Low, or Info. Leave Activate Alert Rule after saving selected to start monitoring as soon as you save, or clear it to enable the rule later.
Applies To. Choose the devices the rule monitors — all devices, or specific device types. (A Portal Light Offline rule monitors your Portal Lights.)
Locations. Scope the rule to all locations, a specific campus and its buildings, or a specific building.
-
Condition. Set the condition that triggers an alert:
Portal Light Offline: when any Portal Light is offline for a set amount of time, when a set number of Portal Lights are offline, or when a set percentage of Portal Lights are offline.
Battery Level: when any device's battery level falls below a set percentage, or when a set number of devices fall below a set percentage.
Schedule. Choose when the rule monitors — Always On, or only between the dates you set.
-
Actions. Set how and who is notified when an alert is triggered. The step has three parts:
Recipients: choose the notification channels — Email (specified email addresses), Text (SMS) (specified mobile phone numbers), and Webhook (an external system, using a webhook created and managed in Company Settings).
Reminders: optionally send the notifications again if the alert isn't resolved within a set window of time (days, hours, or minutes).
Escalations: optionally notify an additional Group if the alert still needs attention after a set amount of time. See About escalation alerts and Add an escalation to an Alert Rule.
Select Save. Once saved, it can take a few minutes for the rule to begin monitoring the condition.
How to edit an Alert Rule
From the Kontakt.io Launchpad, select Device Health.
From the Settings menu, select Alert Rules.
In the list, find the rule, then in its Action column, select the edit icon.
Next to the setting you want to update, select the edit icon.
-
When complete, select Save.
Once saved, it can take a few minutes for the change to take effect.
Example: edit an Alert Rule
How to turn an Alert Rule on or off
When an Alert Rule is on, alerts are triggered when the condition set in the rule is reached.
Turn an Alert Rule off when you do not want alerts to be triggered. This is helpful during short-term conditions, such as a system deployment when not all infrastructure devices are online yet, or a planned Wi-Fi network outage when you do not want alerts sent.
From the Kontakt.io Launchpad, select Device Health.
From the Settings menu, select Alert Rules.
In the list, find the rule, then in its Status column, set the toggle to on or off.