How to enable Telemetry in a Portworx cluster

Audience
Public
Product
Portworx
Content Type
Source Type
Knowledge Base

How to enable Telemetry in a Portworx cluster

KB0017575
Pure Product
Portworx
Question

How to enable telemetry in an existing Portworx cluster?

Answer

Prerequisites:

  • Portworx Operator 24.1.1 or later
  • A cluster running Portworx 3.0.x or later using an Operator-based installation
  • Outbound access to the following URLs:

https://pxessentials.portworx.com
https://register.cloud-support.purestorage.com
https://rest.cloud-support.purestorage.com

1. Edit StorageCluster spec and set spec.monitoring.telemetry.enabled to true.

Example:

kubectl edit storagecluster -n <namespace>

spec:
  monitoring:
    telemetry:
      enabled: true 

2. Save the changes and exit the editor. This will update the StorageCluster configuration.

3. Verify telemetry pods (phonehome and registration) are up and running and Telemetry is reported as healthy.

kubectl get po -n <namespace> | grep px-telemetry
pxctl status | grep telemetry

Example:

kubectl get po -n kube-system | grep px-telemetry


px-telemetry-phonehome-2h4h2                 2/2     Running            0                143m
px-telemetry-phonehome-l7j25                 2/2     Running            0                143m
px-telemetry-phonehome-prjkp                 2/2     Running            0                143m
px-telemetry-phonehome-rw24p                 2/2     Running            0                143m
px-telemetry-registration-5f5d7c7bff-9b9x9   2/2     Running            0                143m

####################################################
root@test-worker2:~# pxctl status | grep Telemetry
Telemetry: Healthy

Telemetry should now be enabled for your Portworx installation.