< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

Configure Slack Notifications

This tutorial demonstrates how to configure Slack notifications and add channels, which can receive notifications for alerting policies.

Prerequisites

You have an available Slack workspace.

Obtain a Slack OAuth Token

You need to create a Slack app first so that it can help you send notifications to Slack channels. To authenticate your app, you must create an OAuth token.

  1. Log in to Slack to create an app.

  2. On the Your Apps page, click Create New App.

  3. In the dialog that appears, enter your app name and select a Slack workspace for it. Click Create App to continue.

  4. From the left navigation bar, select OAuth & Permissions under Features. On the Auth & Permissions page, scroll down to Scopes and click Add an OAuth Scope under Bot Token Scopes and User Token Scopes respectively. Select the chart:write permission for both scopes.

  5. Scroll up to OAuth Tokens & Redirect URLs and click Install to Workspace. Grant the permission to access your workspace for the app and you can find created tokens under OAuth Tokens for Your Team.

Configure Slack Notifications on the KubeSphere Console

You must provide the Slack token on the console for authentication so that KubeSphere can send notifications to your channel.

  1. Log in to the web console with a user granted the role platform-admin.

  2. Click Platform in the top-left corner and select Platform Settings.

  3. Navigate to Slack under Notification Management.

  4. For Slack Token under Server Settings, you can enter either a User OAuth Token or a Bot User OAuth Token for authentication. If you use the User OAuth Token, it is the app owner that will send notifications to your Slack channel. If you use the Bot User OAuth Token, it is the app that will send notifications.

  5. Under Channel Settings, enter a Slack channel where you want to receive notifications and click Add.

  6. After it is added, the channel will be listed under Channel List. You can add up to 20 channels and all of them will be able to receive notifications of alerts.

    Note

    To remove a channel from the list, click the cross icon next to the channel.
  7. Click Save.

  8. Select the checkbox on the left of Notification Conditions to set notification conditions.

    • Label: Name, severity, or monitoring target of an alerting policy. You can select a label or customize a label.
    • Operator: Mapping between the label and the values. The operator includes Includes values, Does not include values, Exists, and Does not exist.
    • Values: Values associated with the label.

      Note

      • Operators Includes values and Does not include values require one or more label values. Use a carriage return to separate values.
      • Operators Exists and Does not exist determine whether a label exists, and do not require a label value.
  9. You can click Add to add notification conditions, or click icon on the right of a notification condition to delete the condition.

  10. After the configurations are complete, you can click Send Test Message for verification.

  11. To make sure notifications will be sent to a Slack channel, turn on Receive Notifications and click Update.

Note

  • After the notification conditions are set, the recepients will receive only notifications that meet the conditions.
  • If you change the existing configuration, you must click OK to apply it.
  1. If you want the app to be the notification sender, make sure it is in the channel. To add it in a Slack channel, enter /invite @<app-name> in your channel.

Receive Slack Notifications

After you configure Slack notifications and add channels, you need to enable KubeSphere Alerting and create an alerting policy for workloads or nodes. Once it is triggered, all the channels in the list can receive notifications.

The image below is a Slack notification example:

Note

  • If you update your Slack notification configuration, KubeSphere will send notifications based on the latest configuration.
  • By default, KubeSphere sends notifications for the same alert about every 12 hours. The notification repeat interval is mainly controlled by repeat_interval in the Secret alertmanager-main in the project kubesphere-monitoring-system. You can customize the interval as needed.
  • As KubeSphere has built-in alerting policies, if you do not set any customized alerting policies, your Slack channel can still receive notifications once a built-in alerting policy is triggered.

Receive the latest news, articles and updates from KubeSphere


Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.