安装 Whizard

1. 在 KubeSphere Enterprise 中启用 Whizard 可观测中心（需加载对应 License）

Whizard 在 KubeSphere Enterprise v3.3.1 及以上版本已默认集成，可以通过简要配置快速开启 Whizard 可观测中心功能。

1.0 先决条件

想成功和正确地安装部署 Whizard 可观测中心，需要以下前置条件。

  • 一个 Kubernetes 集群
  • 已安装部署 KuberSphere Enterprise
  • 已申请并加载对应 License

1.1 在 KubeSphere Enterprise 4.x 版本启用 Whizard 可观测中心

修改 WhizardTelemetry 监控扩展组件配置，对以下部分修改、保存并更新配置后，开始安装。

  1. whizard-monitoring-helper:
  2.   whizardHelper:
  3.     enabled: true   ## set true to enable whizard
  5. whizard:
  6.   enabled: true
  8. whizardAgentProxy:
  9.   enabled: true
  11. whizard-agent-proxy:
  12.   config:
  13.     gatewayUrl: "http://172.31.73.206:30990"   ## set whizard gateway url，default is http://{host_cluster_node_ip}:30990
  15. kube-prometheus-stack:
  16.   prometheus:
  17.     # agentMode need to be set to true when enable whizard
  18.     agentMode: true

启用 Whizard 可观测中心后，除了需要在 WhizardTelemetry 监控扩展组件 进行配置外，您还需要在 WhizardTelemetry 平台服务 及 WhizardTelemetry 告警管理 修改对应配置，请参考其组件文档。

1.2 在 KubeSphere Enterprise 3.x 版本启用 Whizard 可观测中心

在KubeSphere 3.3.1 版本首次集成 Whizard 可观测中心，在 3.X 版本通过 ks-installer 集成部署。Whizard 可观测中心要求启用多集群管理。

注: 如果已经安装了 KubeSphere Enterprise，再启用Whizard可观测中心时，需要将status.monitoring.status 字段置空 kubectl edit cc -n kubesphere-system ks-installer

  1. status:
  2.   monitoring:
  3.     status: ""            #将status从'enabled'置空以重新部署monitoring
  4.   ……

1.2.1 在host 集群启用 Whizard 可观测中心服务

当您在 Kubernetes 上安装 KSE 时并启用Whizard 可观测中心服务时，服务会通过 NodePort 方式暴露 30990 端口，供 member 集群将数据推送至 host 集群。

  1. 下载 cluster-configuration.yaml 文件并进行编辑。

    1. vi cluster-configuration.yaml

  2. 在 cluster-configuration.yaml 文件中，搜索 whizard 字段，将 enabled 的 false 更改为 true 以启用分布式可观测中心，完成后保存文件。

    1. monitoring:
    2.   whizard:
    3.     client:              #在host集群无需编辑client配置
    4.       clusterName: ''
    5.       gatewayUrl: ''
    6.     enabled: true        #将“false”更改为“true”。
    7.     server: 
    8.       nodePort: 30990    #默认在host集群开放30990端口与client进行通信，可根据实际网络模型自行配置

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

    1. kubectl apply -f cluster-configuration.yaml

1.2.2 在 member 集群启用 Whizard client服务，将数据接入 host 集群

  1. 下载 cluster-configuration.yaml 文件并进行编辑。

    1. vi cluster-configuration.yaml

  2. 在 cluster-configuration.yaml 文件中，搜索 whizard 字段，将 enabled 的 false 更改为 true,并配置 gatewayUrl 及 clusterName 以启用分布式可观测中心的 client 端，完成后保存文件。

    1. monitoring:
    2.   whizard:
    3.     client:              
    4.       clusterName: ''    #member集群名称，必须与kubeSphere多集群管理中注册的集群名称保持一致
    5.       gatewayUrl: ''     #gateway服务暴露地址, 默认为http://{host_cluster_node_ip}:30990
    6.     enabled: true        #将“false”更改为“true”。
    7.     server:              #在member集群无需编辑server配置
    8.       nodePort: 30990

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

    1. kubectl apply -f cluster-configuration.yaml

2. 使用 Helm 快速部署和管理 Whizard

helm 独立部署方式可以在 Kubernetes 环境下使用 helm chart 完成独立部署，无需过多依赖，可使用 Whizard 离线部署包快速完成部署。

  1. # 安装依赖的 prometheusrule CRD
  2. kubectl apply -f https://github.com/prometheus-operator/kube-prometheus/blob/main/manifests/setup/0prometheusruleCustomResourceDefinition.yaml
  4. # 获取 Whizard 部署包并使用 helm 安装
  5. helm upgrade --install whizard . -n kubesphere-monitoring-system --create-namespace