Notification lists specify which notifiers to use when sending monitoring-related notifications.
The NS1 monitoring solution allows you to create monitors that track the up/down status of a specified device or endpoint. Users can configure notification lists that specify where monitoring alerts should be sent. The notifiers specified in the notification list can include native NS1 services (including email, custom webhook, and NS1 API), as well as third-party integrations (Slack, PagerDuty, and HipChat).
A notification list is attached to a monitor so that, when that monitor detects that an endpoint is “down,” it pushes alerts to all the notifiers specified in the list. Users can configure automatic failover so that traffic is automatically steered away from the “down” or underperforming endpoints.
If configuring automatic failover via the NS1 portal, a notification list is created for you during the setup process. This happens as soon as you connect a monitor to the answer metadata. The auto-generated notification list will look like this: __NS1__.notify_list. Refer to this article for more information. Please note that users configuring automatic failover via API must manually create the notification list.
This article includes a list of supported notifiers that you can include in a notification list, as well as instructions or setting up notification lists and attaching them to monitors.
Native NS1 notification services include:
Sends monitoring alerts via email to specific user(s).
Sends monitoring alerts to a custom webhook URL.
NS1 data feed*
Sends monitoring alerts to an NS1 feed through a connected NS1 monitoring source.
NS1 Managed DNS integrates with the following third-party notification services:
*Indicates a notifier type that is also supported by NS1 Private DNS / Enterprise DDI network configurations.
In order to automatically update answer metadata, a notification list must include an NS1 data feed.
The instructions below explain the process for creating a notification list, and then attaching it to a monitoring job.
Step 1: Create a notification list.
In the NS1 portal, navigate to the Monitors tab.
Click Notification Lists.
- Click Create a Notification List.
Enter a Notification List Name.
Click Add a new notifier or select an available notifier from the list. If adding a new notifier, select the type from the drop-down list and enter the requested information.
Refer to the corresponding instructions via the links under Supported notifiers at the top of this article. Note that you can add multiple notifiers to the notification list at once.
- Once all notifiers are selected, click Save List and Notifiers.
Step 2: Attach a notification list to a monitor.
Refer to the articles for instructions on how to a new monitor (by monitor type):
In the portal, navigate to the Monitors tab.
Locate the monitor to which you want to attach the notification list. Click the menu icon next to the monitor, and click Edit.
- Click the Notifications tab.
Under Attach a notification list, select a notification list from the drop-down menu. Optionally, you can click Edit Lists to modify list settings. Once you are redirected, you will need to follow the steps above to navigate back to the Notification Settings screen.
Optionally, under Notify Delay, enter the amount of time (in seconds) the system should wait before sending a notification. As a best practice, this value should be higher than the frequency value.
Optionally, under Notify Repeat, enter the number of times to push the same alert.
Optionally, check the box next to Notify Fallback to receive a notification when a previously failed monitoring job returns to an “up” status.
Optionally, check the box next to Notify Regional to receive a notification upon any regional failure.
Click Save Changes.
Now, when a monitor detects that a server/endpoint is “down,” it pushes an alert to all notifiers specified in the attached notification list.