Alert Rules provide a method to get notified for various device conditions that commonly require attention. These conditions include instances where Portal Lights are offline resulting in data not being received by Kio Cloud, situations where Kio Cloud has not received data from your Kontakt.io BLE-only Tags and Infrastructure devices, and battery-powered devices with low battery levels. For more information, see Alert Rule examples by use case.
Important
Device prerequisite: For an Alert Rule to monitor a device, the device's Deployment Status is required to be set to Deployed. Learn more.
Managing Alert Rules is restricted to users assigned to the Administrator role in Device Health.
Topics in this article:
The Portal Light Offline alert rule monitors and keeps track of Portal Lights' connection to Kio Cloud - to ensure they're connecting to the local WiFi network and sending data to Kio Cloud without issues.
This alert is crucial for ensuring the seamless and uninterrupted flow of data between Portal Lights and Kio Cloud, which also includes the data received from Kontakt.io BLE-only devices that are within range of Portal Lights.
The cause of an Offline status is commonly network or power related or that there were no BLE-only devices within range of a Portal Light that resulted in no data being received by Kio Cloud.
The following is required when creating a Portal Light Offline Alert Rule.
|
Setting |
Information required |
|---|---|
|
General |
Alert Name: uniquely identifies the rule. Alert Severity: Critical (in addition to notifications, emits an audio alert within Kio Cloud), High, Medium, Low, info Activate Alert Rule after saving: By default, this option is selected and rule is set to a status of enabled to actively monitor the condition. To disable the alert, deselect Activate Alert Rule after saving. You can always enable the alert at a later time. |
|
Locations |
The options include:
|
|
Conditions |
When the condition is reached, an alert is activated. The options include:
|
|
Actions |
Set how and who is notified when an alert is activated. The options include:
Alert Reminder: For those mission critical devices, you have the option to enable alert notifications to be sent again in the event that an alert is not advanced to resolved within a designated window of time (days, hours, or minutes). |
Monitors the battery levels of battery-powered BLE-only devices.
This alert is useful when you want to know when devices' battery life remaining is getting low - allowing a proactive task to schedule a battery or device replacement.
The following is required when creating a Low Battery Alert Rule.
|
Setting |
Information required |
|---|---|
|
General |
Alert Name: uniquely identifies the rule. Alert Severity: Critical (in addition to notifications, emits an audio alert within Kio Cloud), High, Medium, Low, info Activate Alert Rule after saving: By default, this option is selected and rule is set to a status of enabled to actively monitor the condition. To disable the alert, deselect Activate Alert Rule after saving. You can always enable the alert at a later time. |
|
Locations |
The options include:
|
|
Applies to |
Sets what devices are monitored by the rule. The options include:
|
|
Conditions |
When the condition is reached, an alert is activated. The options include:
|
|
Actions |
Set how and who is notified when an alert is activated. The options include:
Webhooks: sends alerts to an external system by a Webhook created and managed within Company Settings. Alert Reminder: For those mission critical devices, you have the option to enable alert notifications to be sent again in the event that an alert is not advanced to resolved within a designated window of time (days, hours, or minutes). |
Monitors and keeps tracks of devices' Last Seen timestamp. Last Seen timestamp identifies when data for a device was last received by Kio Cloud.
This alert type is useful for keeping track of devices' statuses and ensuring that their data is being received by Kio Cloud regularly.
The following is required when creating a Last Seen Alert Rule.
|
Setting |
Information required |
|---|---|
|
General |
Alert Name: uniquely identifies the rule. Alert Severity: Critical (in addition to notifications, emits an audio alert within Kio Cloud), High, Medium, Low, info Alert Severity: identifies the severity of alerts activate by the rule; options include Critical, High, Medium, Low, Info. Activate Alert Rule after saving: By default, this option is selected and rule is set to a status of enabled to actively monitor the condition. To disable the alert, deselect Activate Alert Rule after saving. You can always enable the alert at a later time. |
|
Applies to |
Sets what devices are monitored by the rule. The options include:
|
|
Locations |
The options include:
|
|
Conditions |
When the condition is reached, an alert is activated. The options include:
|
|
Actions |
Set how and who is notified when an alert is activated. The options include:
|
The following provides a brief description of each alert type and the condition being monitored.
|
Alert Type |
Description |
Condition When the condition is reached, an alert is activated. |
|---|---|---|
|
Portal Light Offline |
The Portal Light Offline alert rule monitors and keeps track of Portal Lights' connection to Kio Cloud - to ensure they're connecting to the local WiFi network and sending data to Kio Cloud without issues. This alert is crucial for ensuring the seamless and uninterrupted flow of data between Portal Lights and Kio Cloud, which also includes the data received from Kontakt.io BLE-only devices that are within range of Portal Lights. The cause of an Offline status is commonly network or power related or that there were no BLE-only devices within range of a Portal Light that resulted in no data being received by Kio Cloud. |
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 |
|
Last Seen |
Monitors and keeps tracks of devices' Last Seen timestamp. Last Seen timestamp identifies when data for a device was last received by Kio Cloud. This alert type is useful for keeping track of devices' statuses and ensuring that their data is being received by Kio Cloud regularly. |
When a monitored device has not been seen for a specified number of minutes, hours, or days. |
|
Low Battery |
Monitors the battery levels of battery-powered BLE-only devices. This alert is useful when you want to know when devices' battery life remaining is getting low - allowing a proactive task to schedule a battery or device replacement. |
When any device has a battery level that falls below a certain percentage When a specified quantity of devices have a battery level that falls below a certain percentage |
-
From the Kio Cloud Launchpad, select Device Health.
-
From the Settings menu, select Alert Rules.
-
Select CREATE ALERT RULE > select the type of alert .You are guided through each configuration step.
-
Once saved, it can take up to 15 minutes for the alert to begin monitoring the condition.
Click on image to view in full screen.
Example: create a new Alert Rule
-
From the Kio Cloud Launchpad, select Device Health.
-
From the Settings menu, select Alert Rules.
-
From the list, locate the rule > from its Action column, select the edit icon
.
-
From the setting to update, select the edit icon
-
When complete, select SAVE.
Once saved, it can take up to 15 minutes for the alert change to take effect.
Example: edit an Alert Rule
When an Alert Rule is enabled, alerts are activated when the condition set in the rule is reached.
You can disable an Alert Rule when you do not want alerts to be triggered. This is helpful during short-term conditions, such as during a system deployment and not all of the infrastructure devices are operational and online. Or if there is a planned Wi-Fi network outage and you do not want alerts sent during the outage time period.