NS1 status

Articles in this section

NS1 + Slack integration

  • Updated
Follow

NS1 users can configure Slack as a notifier to allow notifications related to your NS1 monitors to be sent through Slack. Slack notifications include the name of the monitor, the monitoring region, the up/down status, and a timestamp.

Follow the instructions below to configure this integration.

Step 1: Create a webhook in Slack

  1. Log into your Slack account and navigate to the Custom Integrations page (i.e., http://{workspace}.slack.com/apps/manage/custom-integrations).

    screen-slack_custom_integrations_page.png

  2. Click Incoming WebHooks, and then click Add Configuration.

    Note

    If you are not a system administrator for your workspace, you can click Request Configuration or talk to your system admin about setting up the webhook with NS1.

  3. Select a Slack channel or create a new one in which you want to receive the monitoring alerts. Note that you can configure notifications to be sent directly to individual users.

    Note

    Selecting a Slack channel in this step creates a default channel, but you can add multiple channels and/or users in the NS1 portal. See below for details.

  4. Click Add Incoming Webhooks to generate a webhook URL. Copy this URL as you will need it in the next step.

Step 2: Configure Slack notifications in the NS1 portal

  1. In the NS1 portal, navigate to the Monitors page from the main navigation. Click the name of an existing monitoring job (i.e., probe) to drill down into monitor details, and then click the Notifications tab in the sub-navigation.

    demo-navigate_to_notifications_tab.gif

    Note

    Refer to the Monitoring section of the NS1 Help Center for more information on creating specific types of monitoring jobs.

  2. Under Attach a notification list, select an existing notification list to which you want to add the Slack notifier and then click Edit List.

    Note

    If you do not have an existing notification list or you do not want to modify the existing lists, refer to Setting up notifications lists.

  3. Click Add New Notifier.

  4. Under Select Notifier Type, select Slack from the drop-down list., and then enter the following information:

    • Slackbot username - A name for the notification bot in Slack

    • Webhook URL - The unique URL generated in step 1

    • Slack channel/user - The channel or user to send notifications to

      Note

      Notifications can be sent to Slack channels and/or users. Be sure to include the @ or # symbol. The channel or user you enter here does not have to be the default channel entered in step 1 (i.e., in Slack). Channels or users entered in the NS1 portal override the default value.

  5. Click Add to list.

Now, when the up/down status of the monitor changes, the NS1 platform sends an alert via Slack to the channel(s) and/or user(s) specified in the Slack notifier(s) included in the notification list. Each notification includes the name of the monitor, the monitoring region, the up/down status of the monitored endpoint, and a timestamp.

You can configure notifications such that multiple notifications can be sent simultaneously to different channels and/or users. To do this, create multiple Slack notifiers within the same notification list pointing to different channels and/or users.

Related articles