Skip to main content

Uninstall

Removing the Kubernetes Agent​

Steps​

  1. Uninstall the Helm release:

    helm uninstall opsworker-agent -n opsworker-agent

  2. Remove the namespace:

    kubectl delete namespace opsworker-agent

  3. Remove the cluster from the portal:

    • Go to the cluster's settings page
    • Click Remove Cluster
    • Confirm removal

What Happens​

  • The agent pods are terminated (the agent plus the kubernetes-mcp-server and grafana-mcp pods)
  • The ServiceAccount and the ClusterRoleBinding(s) created by the chart are removed
  • The built-in view ClusterRole remains: the chart only bound to it with a ClusterRoleBinding, it did not create a custom ClusterRole, and view is a Kubernetes built-in role
  • No new investigations will run for this cluster
  • Historical investigations are preserved in the portal

Data Retention​

After removing a cluster:

  • Past investigations and their data remain accessible in the portal
  • Alert history (signals) is retained
  • Data is only fully removed if the organization is deleted

Reinstalling​

To reconnect a cluster after removal:

  1. Add the cluster again in the portal (generates a new token)
  2. Install the agent with the new token
  3. Previous investigation history remains available

Removing the Helm Repository​

If you no longer use OpsWorker:

helm repo remove opsworker

Next Steps​