Configure Slack Notifications

    You have an available Slack workspace.

    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 .

    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.

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

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

    2. Navigate to Slack under Notification Management.

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

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

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

    6. Click Save.

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

    8. You can click Add to add notification conditions, or click on the right of a notification condition to delete the condition.

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

    10. 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 in your channel.

    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:

    • If you update your Slack notification configuration, KubeSphere will send notifications based on the latest configuration.
    • 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.