---
name: containers-ts-addon-istio-debug
title: Debugging Istio
description: To further troubleshoot the managed Istio add-on, consider the following debugging tools.
last-updated: 2025-09-02
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/containers?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Debugging Istio
{: #istio_debug_tool}
{: support}

[Virtual Private Cloud]{: tag-vpc} [Classic infrastructure]{: tag-classic-inf}

To further troubleshoot the [managed Istio add-on](https://cloud.ibm.com/docs/containers?topic=containers-istio&format=markdown), consider the following debugging tools.
{: shortdesc}

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](https://cloud.ibm.com/docs/containers?topic=containers-istio-update&format=markdown#update_client_sidecar), including the `istioctl` client and the Istio sidecars for your app.

1. 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](https://istio.io/latest/docs/reference/commands/istioctl/#istioctl-analyze){: external}.