KubeSphere 告警和通知系统

什么是 KubeSphere 告警和通知系统

告警和通知是可观察性的两个重要构件，与监控和日志密切相关。KubeSphere 中的告警系统与其主动式故障通知 (Proactive Failure Notification) 系统相结合，使用户可以基于告警策略了解感兴趣的活动。当达到某个指标的预定义阈值时，会向预先配置的收件人发出告警，您可以自行设置通知方式，包括 Email、企业微信和 Slack 等。有了功能强大的告警和通知系统，您就可以迅速发现并提前解决潜在问题，避免您的业务受影响。

有关更多信息，请参见告警策略和告警信息。

备注

建议同时启用告警和通知功能，这样用户可以及时收到告警通知。

在安装前启用告警和通知系统

在 Linux 上安装

当您在 Linux 上安装多节点 KubeSphere 时，需要创建一个配置文件，该文件列出了所有 KubeSphere 组件。

  1. 基于在 Linux 上安装 KubeSphere 的教程，您需要创建一个默认文件 config-sample.yaml。通过执行以下命令修改该文件：

    1. vi config-sample.yaml

    备注

    如果您采用 All-in-One 安装，则不需要创建 config-sample.yaml 文件，因为可以直接创建集群。一般来说，All-in-One 模式是为那些刚接触 KubeSphere 并希望熟悉系统的用户而准备的。如果您想在该模式下启用告警和通知系统（例如用于测试），请参考下面的部分，查看如何在安装后启用告警和通知系统。

  2. 在该文件中，搜寻到 alerting 和 notification，并将 enabled 的 false 改为 true。完成后保存文件。

    1. alerting:
    2.     enabled: true # Change "false" to "true"
    3. notification:
    4.     enabled: true # Change "false" to "true"

  3. 使用配置文件创建集群：

    1. ./kk create cluster -f config-sample.yaml

在 Kubernetes 上安装

在 Kubernetes 上安装 KubeSphere 的过程与教程在 Kubernetes 上安装 KubeSphere 中的说明大致相同，不同之处是需要先在 cluster-configuration.yaml 文件中启用告警和通知系统（可选组件）。

  1. 下载 cluster-configuration.yaml 文件，然后打开并开始编辑。

    1. vi cluster-configuration.yaml

  2. 在该本地 cluster-configuration.yaml 文件中，搜寻到 alerting 和 notification，并将 enabled 的 false 改为 true，启用它们。完成后保存文件。

    1. alerting:
    2.     enabled: true # Change "false" to "true"
    3. notification:
    4.     enabled: true # Change "false" to "true"

  3. 执行以下命令开始安装：

    1. kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.0.0/kubesphere-installer.yaml
    3. kubectl apply -f cluster-configuration.yaml

在安装后启用告警和通知系统

  1. 以 admin 身份登录控制台。点击左上角的平台管理，选择集群管理。

    集群管理

  2. 点击自定义资源 CRD，在搜索栏中输入 clusterconfiguration。点击结果查看其详细页面。

    信息

    自定义资源定义 (CRD) 允许用户在不新增 API 服务器的情况下创建一种新的资源类型，用户可以像使用其他 Kubernetes 原生对象一样使用这些自定义资源。

  3. 在资源列表中，点击 ks-installer 右边的三个点，选择编辑配置文件。

    编辑 YAML

  4. 在该 YAML 文件中，搜寻到 alerting 和 notification，将 enabled 的 false 改为 true。完成后，点击右下角的更新，保存配置。

    1. alerting:
    2.     enabled: true # Change "false" to "true"
    3. notification:
    4.     enabled: true # Change "false" to "true"

  5. 您可以通过执行以下命令，使用 Web Kubectl 工具来检查安装过程：

    1. kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

    提示

    您可以通过点击控制台右下角的锤子图标找到 Web Kubectl 工具。

验证组件的安装

如果您在下图所示界面中可以看到告警消息和告警策略，说明安装成功，因为安装组件之后才会显示这两部分。

告警

执行以下命令来检查 Pod 的状态：

  1. kubectl get pod -n kubesphere-alerting-system

如果组件运行成功，输出结果可能如下：

  1. NAME                                       READY   STATUS      RESTARTS   AGE
  2. alerting-client-744c794979-xvsbz           1/1     Running     2          36m
  3. alerting-db-ctrl-job-jwdsh                 0/1     Completed   0          36m
  4. alerting-db-init-job-sj2nv                 0/1     Completed   0          36m
  5. alerting-executor-59ff88f484-2l57d         2/2     Running     0          36m
  6. alerting-manager-5dc9d6cd46-jshkw          1/1     Running     0          36m
  7. alerting-watcher-dcb87b665-sm87b           1/1     Running     0          36m
  8. notification-db-ctrl-job-phxsx             0/1     Completed   3          36m
  9. notification-db-init-job-8q5rf             0/1     Completed   0          36m
  10. notification-deployment-748897cbdf-2djpr   1/1     Running     0          36m