Send notifications to designated Slack channels.

Prerequisites for Adding a Slack Notification Channel

To send Validio notifications to designated channels in Slack, you will first need to create and configure an app in Slack with the permissions to communicate with your Validio installation. Complete the following sections before you add a Validio notification channel for Slack.

Create a Slack App for Validio

Create a Slack application. You will need to use the credentials from the created app to set up a Slack channel within Validio. This enables Validio to send messages to any configured Slack channels and process user interactions on those messages (such as muting incidents from Slack).

For more information, see Slack documentation on creating a new Slack app.

Set up App Permissions

Slack requires scopes to give your app permissions to perform actions, such as posting messages to your workspace. Validio requires the following Bot Token Scopes scopes:

• chat:write
• users.profile:read
• users:read
• users:read.email

After creating the app, add the scopes to the app. For more information, see Slack documentation on assigning scopes to an app.

Configure App Request URL

To interact with the Slack messages sent from Validio (for example, to mute incidents using Slack), Slack needs to be able to communicate back to Validio. Enable this communication by configuring the Slack app with a Request URL. The value should be the /slack-webhook https endpoint of your Validio installation. For example, https://my-company.validio.io/slack-webhook.

You can find this URL under Interactivity & Shortcuts in your Slack App. For more information, see Slack documentation for configuring a Request URL for your app.

Install App to Workspace

Install the app to the Slack workspace where it will be used.

For more information, see Slack documentation for installing an app to a workspace.

Add the Installed App to Slack Channels

To allow the app to pose messages, invite the app to any Slack channels where notifications will be sent.

Add a Slack Channel

To add a new notification channel for Slack,

1. In Validio, navigate to Notifications > Channels and click + New Channel.
2. From the Channel type list, select Slack.
3. Select the Namespace where the channel will be created.
4. Enter the Name, Channel ID, Token, Signing Secret, and Application Link URL to configure the channel. For more information, see Slack Configuration Parameters.
5. (Optional) Check Interactive Message to manage or triage the incident from the notification message.
6. (Optional) Test the channel.
7. Click Create.

Slack Configuration Parameters

Configuring Multiple Slack Channels with one Slack Bot

If you want to use one Slack bot to notify in more than one Slack channel, you need to create a new notification channel in Validio for each Slack channel. The notification channels can use the same parameters (Token, Signing Secret, and so on), except Channel ID which will be specific to the individual channels.

Slack Notification

When the notification rule is triggered, a notification is sent to the specified Slack channel. The Slack notification includes the following:

Notification header:

• Headline: Number of incidents and name of affected source.
• Start and End: Specifies the read period of the data alerted for.

Individual incident layout:

• Incident: Specifies type of validator, filter, and threshold.
• Segment: Specifies which segment triggered the threshold.
• Bounds and value: Bounds set by the threshold (expected value) and the actual value that triggered the threshold.
• View: Link to the specific segment in the platform that triggered the threshold.
• See more: Expand the Slack message. By default, two segments are displayed in a collapsed state. An expanded state displays up to 10 segments.

📘

Note

Validio does not send notifications for backfilled incidents.