Status Alerts

A Status Trigger uses the standard workflow – triggers > notifications > endpoints. You decide what you want to be notified about and who receives the notification. If status notifications are being used and someone no longer wants to receive them, remove that person as a recipient (endpoint or contact).

• Endpoints – When an endpoint's status switches to inactive, a notification is sent. Use License Status Triggers to notify you when you're close to using your allotted endpoints, or have reached the limit.

• Modules – When a module status is changed due to a missed heartbeat or an error, a notification is sent.

  For customers who have redundancy set up, you'll get module alert notifications for both the primary and secondary servers. UNP does not send notifications for unlicensed modules.

• Licenses – When a license goes into the warning state (yellow), a notification is sent. A warning state occurs when you're getting close to reaching the allotted number of endpoints or triggers, or when the license is close to expiring. When the license goes into a red state, another notification is sent. A red state occurs when the allotted number of endpoints or triggers is reached, or the license expired. You can customize the minimum number of licenses or days before receiving a license warning in the Licensing section of Global Settings.

• Redundancy Status – This trigger is only available when your UNP is licensed for Redundancy. These triggers are based on a system error – either a server is down and has failed over to another server, or there's a sync error between the primary and secondary servers.

Notifications are not triggered when the warning or error is resolved. For example, when endpoints are active again, modules are running again, or licenses have been updated.

When assigning endpoints and contacts to receive the notifications, it's advisable to include multiple communication methods for those who need to be alerted.

For example, if I only include IP phone endpoints as recipients for my status notifications and my phone module is down, then the notification can't be received. However, if I include contacts as recipients and I have my contacts email addresses, IP phones, and SMS text messages configured, even if my phone module is down, my key people will still be notified by email and text.

For multi-site organizations, triggers can be set up for individual sites.

1. Go to Configuration > Status Trigger
2. Select New Status Trigger.
3. For Name, enter a value to uniquely identify this trigger.

4. For Available in All Sites:

   • Enable to ensure all your site locations have access.
   • Disable and select a Site to limit which site has access.
5. Create Status Type Filters

   1. For Status Type, select Endpoint, Module, License, or Redundancy to specify what you are monitoring.

      Note: Redundancy is a licensed feature. If your organization is not licensed for it, you will not be able to select this option.

   2. Refer to Creating Status Type Filters for detailed information about creating filters.
   3. Select Add Filter.
   4. Repeat as necessary. Filters of the same Status Type are ORed, while Filters of different Status Type are ANDed.
6. For Only On Change, enable this selection, which will hide the Resend Interval Minutes setting, to ensure that notifications are only sent upon status change rather than periodically.

7. For Resend Interval Minutes, enter a time, in minutes, specifying how often you want to receive a status update. Values must be between 1 and 10800. For example:

   • 60, 1440, or 10800 – send a notification once an hour, once a day, or once a week.

   Tip: When you set your Status Type as Endpoint, this value must be greater than or equal to the Endpoint Inactive Timeout Minutes setting (default is 60) in Global Settings > Endpoints > Advanced Settings.

8. For Template Title and Template Body, combine static text with variables ( ) to craft the message to be sent through the notification.

   The variables include:

   • Name {Name} – returns the name or a description of the system.
   • Status {Status} – returns the status value.
   • Status Detail {StatusDetail} – returns details of the status.
   • Status Type {StatusType} – returns your selection for Status Type.
9. Select Save.

Creating Status Type Filters

For a single Status Trigger, you can set up multiple filters for different status types.

When you create multiple filters for the same Status Type, those filters will be ANDed, while any filter with multiple selections will be ORed within that filter For example, given the following filters:

This Status Alert will trigger:

• For Endpoints, when an update to an endpoint in the All Cleveland tag AND when the endpoint belongs to the Desktop OR Email modules.

• When an update occurs for any Module.

• An update related to licenses with the status License Expired OR License warning.

The following table shows a mapping of selections to behavior.

Status Type	Filter Type	Filter Value	Trigger notifications when updates happen on:
Endpoint	All	n/a	Any endpoint.
	Modules	Select one or more Modules.	Any endpoints related to the selected modules.
	Endpoints	Use the text filter to select one or more endpoints.	Any of the selected endpoints.
	Tags	Use the text filter to select one or more User tags.	Any endpoints linked to the selected tags.
Module	All	n/a	Any module.
	Modules	Select one or more Modules.	Any selected module.
	Statuses	Select one or more of the message status types.	Any modules updating with the selected status.
	Filter Term	Enter a string to filter on.	Any modules with the filter term in their status text.
License	All	n/a	Any module license.
	Modules	Select one or more Modules.	Any of the selected module licenses.
	Statuses	Select one or more types of license messages.	Any module licenses of the selected status.
Redundancy	All	n/a	All redundancy events.
	Statuses	Select one or more types of redundancy status messages.	Any redundancy event of the selected type.
	Filter Term	Enter a string to filter on.	Any redundancy event with the filter term in their status.

Create notifications and assign the triggers and recipients.

• Send all notifications to the same people – create one notification and assign all the triggers to it.
• Send individual notifications to different people – create a separate notification for each group of people.

For example, my network administrators need to be notified for redundancy issues but not any other issues. I'll create one notification for the redundancy trigger and assign my network admins as contacts. This way they'll get the notification to their desk phones and to their cellphones. I'll create another notification for the endpoint, module, and license status triggers and assign my UNP admins as recipients.

When a trigger is deleted, it's automatically removed from notifications. The notifications can still be sent from the interface.

If you need to update the notification with a new trigger or delete the notification altogether, it's a good idea to note which notification(s) are assigned to the trigger before you delete it.