HomeDocumentationRecipesChangelog
HomeRequest DemoContact
Documentation
HomeRequest DemoContact
Start typing to search…

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.

  1. 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.

  2. 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 ScopeDescription
    chat:writeSend messages as app name.
    users.profile:readView profile details about people in a workspace.
    users:readView people in a workspace.
    users:read.emailView email addresses of people in a workspace.

  3. 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.

  4. 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.

  5. 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,

  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

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, https://my-company.validio.io.

  • *Note:** This application link URL is predefined based on the web browser URL to your Validio instance. This is NOT the same as the request URL.

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