Slack
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 steps before you add a Validio notification channel for Slack:
Important
You can find more detailed instructions for these steps in the guide, Setting up a Slack App for Validio.
-
In your Slack App Management dashboard, create a Slack App for Validio.
You will use authentication and secret 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. -
Slack uses scopes to give your app permissions to perform actions, such as posting messages to your workspace. For more information, see Slack documentation on assigning scopes to an app.
In your App Management dashboard under Features > OAuth and Permissions > Scopes, add the following scopes Bot Token Scopes to your app:Slack Scope Description chat:write
Send messages as app name. users.profile:read
View profile details about people in a workspace. users:read
View people in a workspace. users:read.email
View email addresses of people in a workspace. -
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 in your App Management dashboard, under Features > Interactivity & Shortcuts. For more information, see Slack documentation for configuring a request URL for your app. -
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.
-
To allow the app to post messages, invite the installed app to any Slack channels where notifications will be sent.
Add a Notification Channel for Slack
To add a new notification channel for Slack,
- In Validio, navigate to Notifications > Channels and click + New Channel.
- From the Channel type list, select Slack.
- Select the Namespace where the channel will be created.
- Enter the Name, Channel ID, Token, Signing Secret, and Application Link URL to configure the channel. For more information, see Slack Configuration Parameters.
- (Optional) Check Interactive Message to manage or triage the incident from the notification message.
- (Optional) Test the channel.
- Click Create.
Slack Configuration Parameters
Field | Description |
---|---|
Channel type | Select Slack as the Channel type to send notifications to. |
Namespace | Select the namespace where the channel will be created. Only users who are assigned to the same namespace will have access to this channel. |
Name | Identifier for this Validio channel, used to configure notification rules. |
Channel ID | ID of the channel in your Slack workspace where the notification messages will be sent. You can find the channel ID in the Slack channel details. |
Token | The OAuth access token for Slack app you created. You can find the token under Settings > Basic Information > OAuth and Permissions in your Slack app. |
Signing Secret | The secret for the Slack app you created. You can find this value under Settings > Basic Information > App Credentials in your Slack app. |
Application link URL | The URL for your Validio application instance, which will be used to send notifications. For example,
|
Interactive Message | (Optional) Select to manage or triage the incident from the notification message sent to Slack. |
Notifying Multiple Slack Channels with one Slack Bot
You can use one Slack bot to notify in more than one Slack channel, but you need to create a Validio channel 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. For more information, see Notification Rules.
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.
Updated 8 days ago