安装 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
  4. whizard:
  5. enabled: true
  6. whizardAgentProxy:
  7. enabled: true
  8. whizard-agent-proxy:
  9. config:
  10. gatewayUrl: "http://172.31.73.206:30990" ## set whizard gateway url,default is http://{host_cluster_node_ip}:30990
  11. kube-prometheus-stack:
  12. prometheus:
  13. # agentMode need to be set to true when enable whizard
  14. 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
  3. # 获取 Whizard 部署包并使用 helm 安装
  4. helm upgrade --install whizard . -n kubesphere-monitoring-system --create-namespace