A Portworx diagnostics bundle (often referred to as just “diags”) is a support bundle that contains all the information our support team would need to diagnose an issue in your cluster. It mainly contains:
- Portworx journald logs
- Output from common Portworx CLI command that provide details about cluster, nodes and volumes
- Basic information about the OS of the cluster nods
- Stack and heap files of Portworx processes
- Alerts generated by the cluster
- Cores or traces from Portworx processes (if found)
Auto-uploading diags using Pure1 integration
With Portworx 2.8.0 or above, Portworx can now automatically upload its diags to Pure Storage’s call home service called Pure1. The primary benefits of this are:
- You don’t have to copy out diag bundles from your cluster nodes and upload them to support tickets
- When nodes run into issues, they automatically collect diags and call home them. This allows Portworx support to get ahead of the issues and reduces the time to resolution.
When working on a support case, provide your Cluster UUID to Portworx support. They will be able to retrieve your diags from Pure1.
Find your cluster’s UUID?
If you are using operator-based install, you can find this here (See
CLUSTER UUID column):
kubectl get storagecluster -n kube-system
NAME CLUSTER UUID STATUS VERSION AGE px-cluster-2ec933a4-29be-440c-b5b1-ec53d3ba5b39 199ccacd-4253-4e57-9a3d-b2249dff3501 Online 01d934d_d03a058 26h
Another place to find your cluster’s UUID is in the output of
pxctl status | grep 'Cluster UUID'
Cluster UUID: 199ccacd-4253-4e57-9a3d-b2249dff3501
- Portworx 2.8.0 or later
- For Operator based installations, Portworx Operator 1.5.0 or above using the spec generator
- Outbound access to the internet to allow connection to Pure1
Enable Pure1 integration
Enabling telemetry adds a new
telemetry sidecar container to Portworx pods. This container is responsible for uploading Portworx diagnostics to Pure1.
Telemetry and metrics collector are disabled by default for all new clusters in Portworx 2.8.0 or later. However, you can enable this function when you generate a StorageCluster spec.
If you are upgrading from Portworx version prior to 2.8.0, follow the Enable Pure1 integration for upgrades page for instructions.
Portworx diagnostics are collected in primarily 2 ways:
This is done via the pxctl CLI. The most common command used here is:
/opt/pwx/bin/pxctl service diags -a
This generates the diagnostics bundle on the node. If the Pure1 telemetry is enabled, it will be automatically uploaded to Pure1.
If a Portworx process runs into an issue on a node, it will automatically collect diagnostics. If the Pure1 telemetry is enabled, it will be automatically uploaded to Pure1.
Disable Pure1 integration
Operator based install
To disable the metrics collector and telemetry integration, add the following section in your StorageCluster spec:
spec: monitoring: telemetry: enabled: false
This removes the
telemetry container from the Portworx pod.
DaemonSet based install
To disable the metrics collector and telemetry integration for DaemonSet based install, remove the
telemetry container from the Portworx DaemonSet.
See Generate a complete diagnostics package for the entire CLI syntax.