Skip to main content

Add and Remove Clusters

Adding a Cluster​

Steps​

  1. Go to Configurations → Add Cluster
  2. Name the cluster (e.g., production-us-east)
  3. Select workspace the cluster belongs to
  4. Choose integrations to enable (Alert Manager, Grafana Alerting, Grafana MCP)
  5. Copy the Helm install command with your unique cluster token
  6. Install the agent in your cluster using the Helm command
  7. Verify connection — cluster status should show Connected in the portal

See Add a Cluster for the detailed walkthrough.

Removing a Cluster​

Steps​

  1. Remove from portal:
    • 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
  3. Clean up the namespace (optional): 
    kubectl delete namespace opsworker

What Happens When You Remove a Cluster​

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

Cluster Token Rotation​

If you need to regenerate a cluster token (e.g., token may have been exposed):

  1. Go to the cluster settings in the portal
  2. Click Regenerate Token
  3. Update the agent with the new token: 
    helm upgrade opsworker-agent opsworker/opsworker-agent \
      -n opsworker \
      --set clusterToken=NEW_TOKEN

Next Steps​