This page explains how to debug node issues using a suite of preinstalled debugging tools.
Each GKE On-Prem cluster you create is composed of several
nodes. Each GKE On-Prem
node includes a distribution of
toolbox, a shell
script that unpacks and runs a debugging container,
debug-toolbox is a container image that includes several useful debugging
If you encounter issues with a specific node, you can attempt debugging by
connecting to the affected node, run the
toolbox script to unpack and run the
debug-toolbox container, and run the tools included in the container.
Tools included in
debug-toolbox container runs a Debian base image that includes the
Since these tools are included in the container, they don't require an internet
connection. If you want to install additional debugging tools, you use
apt-get, which does require an internet connection.
This command starts a
While inside the container, run one of the tools. For example,
When you're finished, exit the container and close the SSH connection to the node.