Create and manage Alert Rules in Device Health

Device Health Alert Rules notify the right people about device conditions that need attention, such as a Portal Light going offline (so Kio Cloud stops receiving its data) or a battery-powered device with a low battery level. Use this article to create, edit, and enable or disable Alert Rules in Device Health.

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.

Device Health also offers an Escalation alert type. You use it to create an Escalation Alert Rule that notifies an additional Group when an active 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.

Create an Alert Rule

1. From the Kontakt.io Launchpad, select Device Health.

2. From the Settings menu, select Alert Rules.

3. Select Create Alert Rule. In the Create Alert Rule window, select Portal Light Offline or Battery Level Alerts.

   The rule wizard opens on the General step. The steps shown in the stepper across the top depend on the alert type. Each step opens with a short description; move between steps with Back and Next at the top right of the step, or select a step in the stepper.

4. General. Enter an Alert Name that uniquely identifies the rule, and choose the Alert Severity — Critical, High, Medium, Low, or Info. Optionally, add a Description.

5. Applies To (Battery Level rules only). Choose the devices the rule monitors — all devices, or specific device types. A Portal Light Offline rule has no Applies To step; it monitors your Portal Lights.

6. Locations. Choose where the rule applies — all locations, a specific campus and its buildings, or a specific building.

7. Conditions. 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.

8. Actions. Set how and who is notified when an alert is triggered. The step has three sections:

   • Notifications: choose the notification methods — Emails, Text Messages, and Webhooks (an external system, using a webhook created and managed in Company Settings). For each method, add recipients as individual email addresses or phone numbers, or select Users and User groups. See About Alert Rules actions and notification recipients.

   • Reminders: optionally send the notifications again if the alert isn't resolved within a set window of time (days, hours, or minutes). Set When to the alert status, Then to Resend configured notifications, and After or Repeat Every to the timing.

   • Escalations: optionally notify an additional Group if the alert still needs attention after a set amount of time. Set When, After, and Trigger (the Escalation Alert Rule to trigger). See About escalation alerts and Add an escalation to an Alert Rule.

   You don't need to set anything for the Device Health alerts list: every triggered alert appears in Alerts > List, whether or not a notification method is selected.

9. Summary. Review the rule. Each section has its own card; to change a section, select the edit (pencil) icon on its card.

10. In the page header, next to Cancel and Save, leave Enable after saving selected to start monitoring as soon as the rule is created, or clear it to create the rule disabled and enable it later.

11. Select Save. Save is available on the Summary step once every required field is complete; if it's unavailable, hover over it to see which steps are missing required fields.

12. In the Create ""? confirmation, review the settings and whether the rule will be enabled or disabled after creating, then select Create new rule. To go back to the rule instead, select Keep editing.

    Once saved, it can take a few minutes for the rule to begin monitoring the condition.

To leave without creating the rule, select Cancel, then select Discard new rule. Everything set up so far is lost.

Review the Alert Rules list

To see all Device Health Alert Rules, select Alert Rules from the Settings menu.

Each rule shows:

• Status: A toggle that enables or disables the rule, with Enabled or Disabled under it. Disabled rules are grayed out.
• Name: The rule name, with its severity and alert type (Portal Light Offline or Battery level alerts) under it. Select the name to open the rule on its Summary step.
• Locations: The campuses, buildings, or floors the rule covers, or All Locations.
• Applies to: For Battery Level rules, the device models the rule monitors.
• Conditions: What triggers an alert, such as Offline for 30 minutes, At least 10% offline, or Battery level: 20% or lower.
• Notifications: Email, SMS, or Webhook, with Reminders and Escalations under them when the rule has them.
• Updated: When the rule was last changed, and by whom. A Created column is also available; it is hidden by default.
• Actions: Icons to edit, duplicate, or delete the rule.

You can choose which columns to show, and reorder or resize them. Use Search to find a rule by name, and Filters to show rules by Status or Alert Type.

Edit an Alert Rule

1. From the Kontakt.io Launchpad, select Device Health.

2. From the Settings menu, select Alert Rules.

3. In the list, select the rule name (or the edit icon in its row). The rule opens on its Summary step.

4. On the card for the section you want to change, select the edit (pencil) icon. You can also select a step in the stepper.

5. When complete, select Save. Save stays unavailable until you change something.

6. In the Update ""? confirmation, review the sections that will be updated, then select Update rule. If the rule is enabled, the changes take effect immediately.

   Once saved, it can take a few minutes for the change to take effect.

To leave without saving, select Cancel. If you have unsaved changes, select Discard changes to lose them, or Keep editing to go back to the rule.

Example: edit an Alert Rule

Enable or disable an Alert Rule

When an Alert Rule is enabled, alerts are triggered when the condition set in the rule is reached. When it is disabled, no alerts trigger for that rule and no one is notified. A new rule is enabled when it's saved, unless Enable after saving is cleared. To enable or disable an existing rule, use its toggle in the Alert Rules list; editing a rule does not change its status.

Disable an Alert Rule 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.

1. From the Kontakt.io Launchpad, select Device Health.

2. From the Settings menu, select Alert Rules.

3. In the list, find the rule, then in its Status column, set the toggle to enable or disable the rule.

4. In the confirmation dialog, review what the rule covers, then select Enable rule or Disable rule. To leave the rule as it was, select Cancel.

   The dialog is titled "Enable “[rule name]”?" or "Disable “[rule name]”?". It summarizes the rule's Applies to, Locations, and Notifications, and explains the effect: monitoring starts or stops immediately.

   

   Each rule then shows Enabled or Disabled under its toggle. Disabled rules are grayed out.