buoyant.io

Troubleshooting failure to install agent / add a cluster

As part of creating a new cluster in Buoyant Cloud, the Buoyant Cloud agent must be installed on each Kubernetes cluster that you want Buoyant Cloud to work with. Once the agent is installed successfully and is running, it will report back to Buoyant Cloud, and you will be taken to the dashboard.

It’s important to know that:

  1. You have to actually deploy the Buoyant Cloud agent to any Kubernetes cluster that you want Buoyant Cloud to observe, using Helm or kubectl.
  2. Until you have done this for at least 1 cluster, you won’t be able to do anything interesting in Buoyant Cloud.
  3. If you do not have Linkerd installed, go install Linkerd first.

If the Buoyant Cloud agent was not successfully installed, or for some reason is not able to communicate with Buoyant Cloud, you can take the following debugging steps.

  1. Make sure you ran the kubectl command displayed in the dialog on the cluster you’re trying to add. (If you closed the dialog, you can get the kubectl command by clicking Clusters, and then clicking the “Complete Installation” button for the cluster.)
  2. If you ran the kubectl command from the dialog, but there was an error, please email cloud@buoyant.io for assistance. Please include the command and the error message output.
  3. If you ran the kubectl command from the dialog and it appears to have run successfully, but you still don’t see data on your Buoyant Cloud dashboard, try running this command to see if the two agent deployments are running.
kubectl get deploy -n linkerd-buoyant

If you see two deployments called agent and metrics, then the agent is running.

If there are no deployments, the agent is not running. Try installing again. If you didn’t copy the kubectl command and need to get it:

  1. If you closed the dialog, click Clusters. You should see the cluster that you tried to add listed in a table called “Unconnected Clusters”. Click the “View install instructions” in the kebab menu. This should display the kubectl command you need to run. Copy it and run it in you terminal.
  2. Go back to Buoyant Cloud. Close the dialog if it’s open, and click the Dashboard. If you don’t see data, but instead see an “Almost there” message, then the agent is either not installed or not running or not communicating.

Please email cloud@buoyant.io if you still need help! Please include screen shots and/or appropriate terminal output.