Alert integrations

Overview

Alert integrations allow users to receive alerts outside of Slingshot by connecting third-party services. Only Tenant admins can manage alerts from the Manage alert integrations page.

Role for managing alert integrations

• Tenant admin

Prerequisites

Before you begin, you will need a webhook URL for the specific Slack or Teams channel, or an API access key for PagerDuty.

Slack webhook retrieval

Follow the steps below to retrieve your Slack channel webhook:

1. Navigate to your Slack settings via your app’s management dashboard.
2. From there, select Incoming Webhooks, and toggle on Activate Incoming Webhooks.
3. Create an incoming webhook (if you haven’t) by clicking Add New Webhook to Workspace.
4. Select the desired channel and select Authorize.
5. You’ll be sent back to your app settings, where you should see a new entry under the Webhook URLs for Your Workspace section.
6. Your webhook URL will look something like this:
   https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
   ℹ️

   You will enter this webhook URL on the Slingshot Manage alert integrations page.

More detailed information can be found in Slack’s official documentation.

Microsoft Teams webhook retrieval

You can follow the following steps to retrieve your Microsoft Teams channel webhook:

1. Select the More options icon (three dots) next to the channel or chat you want to create a workflow for, and then select Workflows.
2. Select Post to a channel when a webhook request is received
3. Add/edit the name for this workflow.
4. Click Next.
5. Once the workflow is created, you’ll see a new dialog with the webhook URL that you can copy
6. Your webhook URL will look like this:
   https://prod-xx.westus.logic.azure.com/workflows/XXXXXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=XXXX-XX-XX\&XXXXXXXXXXXXXXXXXX
   
   ℹ️

   You will enter this webhook URL on the Slingshot Manage alert integrations page.

More detailed information can be found in MS Teams’ official documentation.

PagerDuty access key retrieval

You can follow the following steps to retrieve your PagerDuty access key:

1. In the Integrations Directory, search for and select your integration’s guide.
2. Go to Services > Service Directory and select the service where you’d like to add the integration
3. Select the Integrations tab and click Add another integration.
4. Select the integration(s) you use to send alerts to this service from the search bar, dropdown, or from our most popular integrations list.
5. Click Add.
6. Find your integration in the list and click on the right to view and copy your Integration Key.
   ℹ️

   You will enter your PagerDuty API access key instead of a webhook URL on the Slingshot Manage alert integrations page.
7. Continue with the instructions in the integration guide to complete configuration.

More detailed information can be found in PagerDuty’s official documentation.

Manage alert integrations

In Slingshot:

1. Navigate to Configurations > Alert integrations.
2. On the Manage alert integrations page, select Configure for the alert you want to configure.
   The Configure third-party integrations modal displays.
3. To enable third-party alerts, enter your webhook URL.
4. To disable third-party alerts, remove the webhook URL.
5. Select Save.

FAQs