Gathering debugging information

If you need to inspect your OpenShift 4 cluster to debug an issue, you can make use of the must-gather tool. It is part of the oc command-line interface (CLI) tool that OpenShift includes, so you are not required to install anything else to use it. Basic usage is:

$ oc adm must-gather

This creates a directory containing OpenShift cluster information. Run oc adm must-gather -h to see all available options.

The default must gather image does not collect Service Mesh data. To collect this as well, you need to run oc adm must-gather a second time, supplying an additional command line flag. If you are only interested in Service Mesh data, you can run the following command instead:

$ oc adm must-gather --image=docker.io/maistra/istio-must-gather:1.1.0

The Maistra image collects all of the Service Mesh data (deployments, configMaps, virtual services, gateways, etc) dumped so that you can investigate any issue in your cluster.

For more information about the output directory structure, or how must-gather works and what are its command line options, you can visit their docs.