HomeDocumentationRecipesChangelog
HomeRequest DemoContact
Documentation
HomeRequest DemoContact

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:

  1. Create and configure an app in Slack with the necessary permission scopes to communicate with your Validio installation.
  2. Install the app in your Slack workspaces and relevant channels where you want to route incident notifications from Validio.

You can find step-by-step instructions for creating and configuring the Slack app in the following guide, Setting up a Slack App for Validio.

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