Telemetry in KubeSphere

Telemetry collects aggregate information about the size of KubeSphere clusters installed, KubeSphere and Kubernetes versions, components enabled, cluster running time, error logs, etc. KubeSphere promises that the information is only used by the KubeSphere community to improve products and will not be shared with any third parties.

What Information Is Collected

  • External network IP
  • Download date
  • Kubernetes version
  • KubeSphere version
  • Kubernetes cluster size
  • The type of the operating system
  • Installer error logs
  • Components enabled
  • The running time of Kubernetes clusters
  • The running time of KubeSphere clusters
  • Cluster ID
  • Machine ID

Disable Telemetry

Telemetry is enabled by default when you install KubeSphere, while you also have the option to disable it either before or after the installation.

Disable Telemetry before installation

When you install KubeSphere on existing Kubernetes clusters, you need to download the file cluster-configuration.yaml for cluster setting. If you want to disable Telemetry, do not use kubectl apply -f directly for this file.

Note

If you install KubeSphere on Linux, see Disable Telemetry after Installation directly.

  1. Download the file cluster-configuration.yaml and edit it:

    1. vi cluster-configuration.yaml
  2. In this local cluster-configuration.yaml file, scroll down to the bottom of the file and add the value telemetry_enabled: false as follows:

    1. openpitrix:
    2. enabled: false
    3. servicemesh:
    4. enabled: false
    5. telemetry_enabled: false # Add this line here to disable Telemetry.
  3. Save the file after you finish and execute the following commands to start installation.

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

Disable Telemetry after installation

  1. Log in to the console as admin and click Platform in the top left corner.

  2. Select Cluster Management and navigate to CRDs.

    Note

    If you have enabled the multi-cluster feature, you need to select a cluster first.

  3. Input clusterconfiguration in the search bar and click the result to go to its detail page.

    edit-crd

  4. Click the three dots on the right of ks-installer and select Edit YAML.

    edit-ks-installer

  5. Scroll down to the bottom of the file and add the value telemetry_enabled: false. When you finish, click Update.

    enable-telemetry

Note

If you want to enable Telemetry again, you can update ks-installer by deleting the value telemetry_enabled: false or changing it to telemetry_enabled: true.