Skip to main content

Add and Remove Clusters

Adding a Cluster​

Steps​

  1. Go to Configurations -> Add Cluster
  2. Select the workspace the cluster belongs to (you do not name it here; the name is derived from the agent after it connects)
  3. Optionally enable the inline Grafana MCP toggle
  4. Copy the Helm install command, which has the cluster token and API key auto-filled
  5. Install the agent in your cluster using the Helm command
  6. Verify connection: the portal automatically polls the agent status, and the cluster moves from PENDING to a connected state

See Add a Cluster for the detailed walkthrough.

Removing a Cluster​

A cluster can only be deleted while its status is PENDING (the agent has not yet connected). Once a cluster has connected, it cannot be deleted from the portal.

Steps​

  1. Delete from portal (only available while status is PENDING):
    • Go to the cluster's settings page
    • Click Remove Cluster
    • Confirm the removal
  2. Uninstall the agent from your cluster: 
    helm uninstall opsworker-agent -n opsworker-agent
  3. Clean up the namespace (optional): 
    kubectl delete namespace opsworker-agent

What Happens When You Remove a Cluster​

  • The cluster is removed from the portal
  • No new investigations run for this cluster
  • Historical investigations are preserved: you can still view past investigations
  • The agent stops receiving commands (if still running, it idles)

Cluster Token​

The cluster token is the cluster's immutable identifier (its primary key). There is no token rotation or regeneration feature. The token and API key are auto-filled into the install command by the portal.

Next Steps​