Notifications
SquaredUp can alert you when the state of any monitor changes by sending notifications.
This short video (2 mins 40) shows how to enable monitoring for a tile and add a new notification rule:
The Settings > Notifications page allows you to manage your notification destinations. You are able to Add, Edit, Pause and Delete destinations.
Once you have added destinations, they will be shown in a table on the Settings > Notifications page. The table shows the number of workspaces and rules using the destination. Clicking on the Workspace number displays which workspaces are using the destination, and how many rules in the workspace are using the destination.
Adding a destination
To set a notification rule, you must have first configured a destination to send that notification to.
There are a number of destinations that be configured, which range from a simple email to configuring a custom webhook.
Refer to the specific documentation for instructions on configuring each destination type:
Notification rules
Notification rules are added via the Monitors page (accessed via the left-hand menu) and are used to specify which monitor state changes should trigger a notification to send to a given destination.
Rules are made up of three parts:
- Trigger: The list of entities (e.g. tile monitors) whose state change can trigger a notification to a selected destination.
- Integration: The supported list of endpoints upon which a destination is configured.
- Options: Include a tile preview in the notification message (enabled by default).
Saved notification rules are displayed in a table on the Monitors page. The table shows the Status, Trigger and Destination for each notification rule in the selected workspace.
A notification rule is listed as either Active or Disabled. A notification rule is Disabled if the destination is paused or deleted via the Settings > Notification page.
While it won’t be listed as disabled, a notification rule will also cease to function if it has been set to trigger when monitors change state but the workspace no longer contains any monitors (or the specific monitors the rule was monitoring are deleted).
Setting notification rules
To configure the notification rule in SquaredUp:
- Select Monitors from the left-hand menu.
- Select Add notification rule then configure the following options.
- Trigger:
Select the Trigger for your notification. By default, this is set to All monitors in this workspace. Click on the Trigger to change it, and then click Save to confirm your selection. Choose from:- This workspace state only: Notify when the workspace changes state.
- All monitors in this workspace: Notify when any monitor within the workspace changes state. The notification message will include details of the monitor that has changed state, as well as details of the state change.
- Selected monitors in this workspace: Notify when specific monitors within the workspace change state. Functions the same as All monitors in this workspace, but allows you to only trigger on a subset. For example, only on database monitors.
- Integration:
Select the integration that you want to use from the list. - Destination:
You will see a list of all destinations that have been added for the selected integration. Click on the destination you want to use. If your desired destination is not listed, select + Add destination to configure one. See Adding a destination. - Configure the following Options:
- Include an image of the tile in the notification:
A preview image of the tile is included in the notification, you can switch this off with the toggle. - Dark / Light:
Choose whether the notification preview is displayed in dark mode or light mode. - Optionally, configure an interval to send repeat notifications if a monitor stays in an error or warning state. See Repeat notifications.
- Include an image of the tile in the notification:
- Trigger:
- Click Save.
Repeat Notifications
This feature is available with a Pro or Enterprise plan
Repeat notifications allow you to receive alerts at custom intervals if a monitor remains in an error or warning state, for the purpose of ongoing issue tracking.
- Repeat notifications can only be used with triggers targeting monitors’ state changes, not with triggers targeting workspaces' state changes.
- When the repeat notification settings are changed during an ongoing notification cycle, the new settings immediately take effect, potentially stopping further notifications, even if previous notifications indicated more would be sent.
When setting up a notification rule, users can enable repeat notifications and customize them with the following options:
- Interval:
- Interval between repeat notifications. Maybe fixed or increasing depending on interval type
- Options range from 30 minutes to 24 hours (default is 1 hour).
- Interval Type:
- Select either either Fixed or Increasing.
- When selecting Increasing (default), the repeat interval doubles each time (for example, 1 hour, 2 hours, 4 hours, etc.).
- Max occurrences:
- Maximum number of repeat notifications for a state change
- Options range from 1 to 10 (with 5 as the default).
- Trigger state:
- the monitor states that can trigger repeat notifications
- Options are Errors only (default) and Errors and Warnings.