Notification lists specify which notifiers to use when sending monitoring-related notifications. NS1's monitoring solution lets you create monitors to track the up/down status of an endpoint as well as notification lists that indicate where to send monitoring alerts. When that monitor detects that an endpoint is down, it pushes alerts to all the notifiers specified in the attached notification list.
Native NS1 notification services include email, a custom webhook URL, and an NS1 data feed (sending monitoring alerts to an NS1 feed through a connected NS1 monitoring source). Note that NS1 Managed DNS integrates with third-party notification services like Slack and PagerDuty, but these integrations are not available in NS1 DDI.
Users can configure automatic failover to steer traffic away from down or underperforming endpoints. If configuring automatic failover via the NS1 portal, a notification list (__NS1__.notify_list) is auto-generated once you connect a monitor to the answer metadata. In order to automatically update answer metadata, a notification list must include an NS1 data feed. If you are configuring automatic failover via API, you must manually create the notification list.
Instructions: Setting up notification lists
Follow the instructions below to create a notification list and attach it to a monitoring job (monitor).
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.
Adjust the notification settings, as desired:
Attach a notification list
Select an existing notification list from the drop-down menu. If necessary, you can click Edit Lists to change the list name or selected notifiers. Note that you will need to navigate back to the Notification Settings screen.
Notify Delay (optional)
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.
Notify Repeat (optional)
Enter the amount of time (in seconds) between each notification. If a value is set, NS1 will continue to send you notifications at a frequency determined by the Notify Repeat field until the monitor is back up. If no value is set, NS1 will send you one notification when it detects the monitor is down.
Notify Fallback (optional)
Select the checkbox 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.