Debugging Istio

Virtual Private Cloud Classic infrastructure

To further troubleshoot the managed Istio add-on, consider the following debugging tools.

1. Ensure that your Istio components all run the same version of managed Istio. Whenever the Istio add-on is updated to a new patch or minor version, the Istio control plane is automatically updated, but you must manually update your data plane components, including the istioctl client and the Istio sidecars for your app.

2. Check your Istio configurations by using the istioctl analyze CLI command. For more information about the command, including available command options and examples, see the Istio open-source documentation.

3. In your cluster dashboard, click the name of the cluster where you want to install the debug tool add-on.

4. On the Diagnostics and Debug Tool card, click Install.

5. In the dialog box, click Install. Note that it can take a few minutes for the add-on to be installed.

6. On the Diagnostics and Debug Tool card, click Dashboard.

7. In the debug tool dashboard, select the istio_control_plane or istio_resources group of tests. Some tests check for potential warnings, errors, or issues, and some tests only gather information that you can reference while you troubleshoot. For more information about the function of each test, click the information icon next to the test's name.

8. Click Run.

9. Check the results of each test. If any test fails, click the information icon next to the test's name for information about how to resolve the issue.