Slack

The Slack integration lets you send Validio data quality notifications to designated Slack channels, with optional interactive message features for triaging incidents directly from Slack.

Slack notifications with metric graph and management options in threads

In Validio, you configure Slack in two steps: create a Slack integration that holds the app credentials once, then create one or more channels that point that integration at specific Slack channels.

Prerequisites for Adding a Slack Integration

Before creating the Slack integration in Validio, you must create and configure an app in Slack with the necessary permission scopes to communicate with your Validio installation. Follow the step-by-step instructions in Setting up a Slack App for Validio.

After completing the Slack app setup you should have:

  • A Bot User OAuth Token with the xoxb- prefix. You can find and generate this token under Features > OAuth & Permissions > OAuth Tokens. (You will need to install the app to your workspace to generate the token.) Validio uses the bot token to authenticate your app for sending messages.
  • (Required only if you enable interactive messages.) An App-Level Token with the xapp- prefix. You can find and generate this token under Settings > Basic Information > App-Level Token. Validio uses the app token to retrieve user events from Slack.
  • (Required only if you enable interactive messages.) Socket Mode enabled on the Slack app. Navigate to Settings > Socket Mode > Connect using Socket Mode to enable the feature.
  • The Channel ID of each Slack channel you plan to notify. You can find the channel ID in the Slack channel's details.

Create a Slack Integration

  1. In Validio, navigate to Workspace > Integrations and click + New integration.
  2. From the Integration type list, select Slack.
  3. Enter a Name for the integration, for example "Production Slack".
  4. Enter the Bot token from your Slack app.
  5. (Optional) Enable Interactive messages so users can manage incidents directly from Slack. When this option is enabled, the App-level token field is required — enter the App-Level Token you generated for your Slack app.
  6. (Optional) Click Test integration to verify the connection.
  7. Click Create integration.

Slack integration configuration

Create a Notification Channel for Slack

After the integration is created, add a channel that points to a specific Slack channel.

  1. In Validio, navigate to Notifications > Channels and click + New channel.
  2. Under Integration, select the Slack integration you created.
  3. Enter a Name for the channel. This name is used when you reference the channel from notification rules.
  4. Enter the Slack channel ID of the destination channel in your Slack workspace. You can find the channel ID in the Slack channel details.
  5. Select the Namespace where the channel will be created. Only users who are assigned to the same namespace will have access to this channel.
  6. Click Create.

Slack Channel Configuration Parameters

FieldDescription
IntegrationSelect an existing Slack integration. If no Slack integration exists, create one first at Workspace > Integrations.
NameIdentifier for this Validio channel, used to label it in the channels list.
Slack channel IDID of the channel in your Slack workspace where notification messages will be sent.
NamespaceNamespace where the channel will be created. Only users who are assigned to the same namespace will have access to this channel.

Notifying Multiple Slack Channels with One Integration

You can reuse a single Slack integration for many Slack channels. Create a new Validio channel for each Slack channel and select the same integration; only the Slack channel ID differs between them.

Slack Notification

Example of a Slack notification, zoomed in on the metric graph and with management options in threads

When a notification rule on the Slack channel triggers, a notification is sent to the specified Slack channel. Incident notifications are grouped together and details are provided in threads. You can update the status and owner, mute future notifications, and add comments within the message thread. For more information, see Adding Notification Rules.

Incident notifications also show the source owner and incident priority in the message body, so on-call engineers can route the alert without opening Validio.

📘

Notifications on Backfilled Validators

Validio does not send notifications for incidents when backfilling validators.