您正在查看 KubeSphere 版本的文档:v3.0.0

KubeSphere v3.0.0 版本的文档已不再维护。您现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本

KubeSphere 告警和通知系统

什么是 KubeSphere 告警和通知系统

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

有关更多信息,请参见告警策略告警信息

备注

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

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

在 Linux 上安装

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

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

    vi config-sample.yaml
    

    备注

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

    alerting:
        enabled: true # Change "false" to "true"
    notification:
        enabled: true # Change "false" to "true"
    
  3. 使用配置文件创建集群:

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

在 Kubernetes 上安装

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

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

    vi cluster-configuration.yaml
    
  2. 在该本地 cluster-configuration.yaml 文件中,搜寻到 alertingnotification,并将 enabledfalse 改为 true,启用它们。完成后保存文件。

    alerting:
        enabled: true # Change "false" to "true"
    notification:
        enabled: true # Change "false" to "true"
    
  3. 执行以下命令开始安装:

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

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

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

    集群管理

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

    信息

    自定义资源定义 (CRD) 允许用户在不新增 API 服务器的情况下创建一种新的资源类型,用户可以像使用其他 Kubernetes 原生对象一样使用这些自定义资源。
  3. 资源列表中,点击 ks-installer 右边的三个点,选择编辑配置文件

    编辑 YAML

  4. 在该 YAML 文件中,搜寻到 alertingnotification,将 enabledfalse 改为 true。完成后,点击右下角的更新,保存配置。

    alerting:
        enabled: true # Change "false" to "true"
    notification:
        enabled: true # Change "false" to "true"
    
  5. 您可以通过执行以下命令,使用 Web Kubectl 工具来检查安装过程:

    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 的状态:

kubectl get pod -n kubesphere-alerting-system

如果组件运行成功,输出结果可能如下:

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