配置 Slack 通知

本教程演示如何配置 Slack 通知及添加频道,以便接收告警策略的通知。

准备工作

您需要准备一个可用的 Slack 工作区。

获取 Slack OAuth 令牌 (Token)

首先,您需要创建一个 Slack 应用,以便发送通知到 Slack 频道。若想认证您的应用,则必须创建一个 OAuth 令牌。

  1. 登录 Slack 以创建应用

  2. Your Apps 页面,点击 Create New App

  3. 在出现的对话框中,输入应用名称并为其选择一个 Slack 工作区。点击 Create App 继续。

  4. 在左侧导航栏中,选择 Features 下的 OAuth & Permissions。在 Auth & Permissions 页面,下滑到 Scopes,分别点击 Bot Token ScopesUser Token Scopes 下的 Add an OAuth Scope,两者都选择 chart:write 权限。

    slack-scope

  5. 上滑到 OAuth Tokens & Redirect URLs,点击 Install to Workspace。授予该应用访问您工作区的权限,您可以在 OAuth Tokens for Your Team 下看到已创建的令牌。

    oauth-token

在 KubeSphere 控制台上配置 Slack 通知

您必须在 KubeSphere 控制台提供 Slack 令牌用于认证,以便 KubeSphere 将通知发送至您的频道。

  1. 使用具有 platform-admin 角色的帐户登录 Web 控制台。

  2. 点击左上角的平台管理,选择平台设置

  3. 导航到通知管理下的 Slack

    slack-notification

  4. 对于服务器配置下的 Slack Token,您可以选择使用 User OAuth Token 或者 Bot User OAuth Token 进行认证。如果使用 User OAuth Token,将由应用所有者往您的 Slack 频道发送通知;如果使用 Bot User OAuth Token,将由应用发送通知。

  5. 接收频道设置下,输入您想要收取通知的频道,点击添加

  6. 添加完成后,该频道将在已设置频道下列出。您最多可以添加 20 个频道,所有已添加的频道都将能够收到告警通知。

    备注

    若想从列表中移除频道,请点击频道右侧的 × 图标。
  7. 点击保存

  8. 若想确保通知将会发送到 Slack 频道,请开启接收通知并点击更新

    备注

    如果您更改了现有配置,则必须点击更新以应用更改。
  9. 若想由应用发送通知,请确保将其加入频道。请在 Slack 频道中输入 /invite @<app-name> 将应用加入至该频道。

    add-app

接收 Slack 通知

配置 Slack 通知并添加频道后,您需要启用 KubeSphere 告警,并为工作负载或节点创建告警策略。告警触发后,列表中的全部频道都将能接收通知。

以下图片为 Slack 通知的示例:

example-notification

备注

  • 如果您更新了 Slack 通知配置,KubeSphere 将根据最新配置发送通知。

  • 默认情况下,KubeSphere 大约每 12 小时针对同一告警发送通知。告警重复间隔期主要由 kubesphere-monitoring-system 项目中 alertmanager-main 密钥的 repeat_interval 所控制。您可以按需自定义间隔期。

  • KubeSphere 拥有内置告警策略,在不设置任何自定义告警策略的情况下,只要内置告警策略被触发,您的 Slack 频道仍能接收通知。


感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。