mirror of
https://github.com/kubesphere/website.git
synced 2025-12-28 14:43:02 +00:00
Translated configure-Slack (#1366)
* Translated configure-slack-notifications Signed-off-by: adakisme <serenashe@yunify.com> * Translated configure-Slack Signed-off-by: adakisme <serenashe@yunify.com> * File modified Signed-off-by: adakisme <serenashe@yunify.com>
This commit is contained in:
parent
07863501cf
commit
f87e7ebf0c
|
|
@ -82,4 +82,5 @@ The image below is a Slack notification example:
|
|||
- 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.
|
||||
|
||||
{{</ notice >}}
|
||||
{{</ notice >}}
|
||||
|
||||
|
|
|
|||
|
|
@ -1,10 +1,87 @@
|
|||
---
|
||||
title: "Configure Slack"
|
||||
keywords: 'KubeSphere, Kubernetes, custom, platform'
|
||||
description: ''
|
||||
linkTitle: "Configure Slack"
|
||||
title: "配置 Slack 通知"
|
||||
keywords: 'KubeSphere, Kubernetes, Slack, 通知'
|
||||
description: '配置 Slack 通知及添加频道来接收告警策略、事件、审计等通知。'
|
||||
linkTitle: "配置 Slack 通知"
|
||||
weight: 8724
|
||||
---
|
||||
|
||||
TBD
|
||||
本教程演示如何配置 Slack 通知及添加频道,以便接收告警策略的通知。
|
||||
|
||||
## 准备工作
|
||||
|
||||
您需要准备一个可用的 [Slack](https://slack.com/) 工作区。
|
||||
|
||||
## 获取 Slack OAuth 令牌 (Token)
|
||||
|
||||
首先,您需要创建一个 Slack 应用,以便发送通知到 Slack 频道。若想认证您的应用,则必须创建一个 OAuth 令牌。
|
||||
|
||||
1. 登录 Slack 以[创建应用](https://api.slack.com/apps)。
|
||||
|
||||
2. 在 **Your Apps** 页面,点击 **Create New App**。
|
||||
|
||||
3. 在出现的对话框中,输入应用名称并为其选择一个 Slack 工作区。点击 **Create App** 继续。
|
||||
|
||||
4. 在左侧导航栏中,选择 **Features** 下的 **OAuth & Permissions**。在 **Auth & Permissions** 页面,下滑到 **Scopes**,分别点击 **Bot Token Scopes** 和 **User Token Scopes** 下的 **Add an OAuth Scope**,两者都选择 **chart:write** 权限。
|
||||
|
||||

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

|
||||
|
||||
## 在 KubeSphere 控制台上配置 Slack 通知
|
||||
|
||||
您必须在 KubeSphere 控制台提供 Slack 令牌用于认证,以便 KubeSphere 将通知发送至您的频道。
|
||||
|
||||
1. 使用具有 `platform-admin` 角色的帐户登录 Web 控制台。
|
||||
|
||||
2. 点击左上角的**平台管理**,选择**平台设置**。
|
||||
|
||||
3. 导航到**通知管理**下的 **Slack**。
|
||||
|
||||

|
||||
|
||||
4. 对于**服务器配置**下的 **Slack Token**,您可以选择使用 User OAuth Token 或者 Bot User OAuth Token 进行认证。如果使用 User OAuth Token,将由应用所有者往您的 Slack 频道发送通知;如果使用 Bot User OAuth Token,将由应用发送通知。
|
||||
|
||||
5. 在**接收频道设置**下,输入您想要收取通知的频道,点击**添加**。
|
||||
|
||||
6. 添加完成后,该频道将在**已设置频道**下列出。您最多可以添加 20 个频道,所有已添加的频道都将能够收到告警通知。
|
||||
|
||||
{{< notice note >}}
|
||||
|
||||
若想从列表中移除频道,请点击频道右侧的 **×** 图标。
|
||||
|
||||
{{</ notice >}}
|
||||
|
||||
7. 点击**保存**。
|
||||
|
||||
8. 若想确保通知将会发送到 Slack 频道,请开启**接收通知**并点击**更新**。
|
||||
|
||||
{{< notice note >}}
|
||||
|
||||
如果您更改了现有配置,则必须点击**更新**以应用更改。
|
||||
|
||||
{{</ notice >}}
|
||||
|
||||
9. 若想由应用发送通知,请确保将其加入频道。请在 Slack 频道中输入 `/invite @<app-name>` 将应用加入至该频道。
|
||||
|
||||

|
||||
|
||||
## 接收 Slack 通知
|
||||
|
||||
配置 Slack 通知并添加频道后,您需要启用 [KubeSphere 告警](../../../../pluggable-components/alerting/),并为工作负载或节点创建告警策略。告警触发后,列表中的全部频道都将能接收通知。
|
||||
|
||||
以下图片为 Slack 通知的示例:
|
||||
|
||||

|
||||
|
||||
{{< notice note >}}
|
||||
|
||||
- 如果您更新了 Slack 通知配置,KubeSphere 将根据最新配置发送通知。
|
||||
|
||||
- 默认情况下,KubeSphere 大约每 12 小时针对同一告警发送通知。告警重复间隔期主要由 `kubesphere-monitoring-system` 项目中 `alertmanager-main` 密钥的 `repeat_interval` 所控制。您可以按需自定义间隔期。
|
||||
|
||||
- KubeSphere 拥有内置告警策略,在不设置任何自定义告警策略的情况下,只要内置告警策略被触发,您的 Slack 频道仍能接收通知。
|
||||
|
||||
{{</ notice >}}
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 156 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 162 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 200 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 82 KiB |
Loading…
Reference in New Issue