Manage Kubernetes Clusters

After you install the CloudZero Agent, you can monitor your connected clusters, check agent health, and manage your deployment from CloudZero and the command line.

View your clusters

To view your connected Kubernetes clusters, navigate to Settings > Kubernetes Integration.

The Kubernetes Integration page shows the following for each cluster:

Column	Description
Cluster name	The name you specified during installation.
Account ID	The cloud account ID associated with the cluster.
Request Activity	A graph of recent metric activity.
Last Ingest	When CloudZero last received data from this cluster.
Agent Version	The version of the CloudZero Agent running on the cluster.
Status	Connected, Disconnected, or Upgrade Required.

You can search by cluster name or account ID, and filter by status.

Select a cluster name to view detailed information about that cluster, including node count, agent component health, and a 30-day ingest activity graph. Select Open in Explorer to jump directly to that cluster's costs in Explorer.

Upgrade the agent

CloudZero periodically releases agent updates with new features, performance improvements, and bug fixes. The Kubernetes Integration page shows an Upgrade Required status when your cluster is running an outdated version.

helm repo update
helm upgrade cloudzero-agent cloudzero/cloudzero-agent \
    --namespace cloudzero \
    -f values.yaml

To upgrade to a specific version:

helm upgrade cloudzero-agent cloudzero/cloudzero-agent \
    --namespace cloudzero \
    -f values.yaml \
    --version <VERSION>

You can find the latest version and release notes on GitHub.

Uninstall the agent

To remove the CloudZero Agent from a cluster, run the following command:

helm uninstall cloudzero-agent --namespace cloudzero

Clean up the ValidatingWebhookConfiguration after uninstalling:

kubectl delete validatingwebhookconfiguration -l app.kubernetes.io/part-of=cloudzero-agent

ℹ️
Have questions or feedback? Reach out to your account manager.