Troubleshooting

Describes how to identify and resolve common problems in Istio.

Using the istioctl command-line tool

Istio includes a supplemental tool that provides debugging and diagnosis for Istio service mesh deployments.

Network Problems

Tools and techniques to address common Istio traffic management and network problems.

Security Problems

Tools and techniques to address common Istio authentication, authorization, and general security-related problems.

Sidecar Injection Problems

Resolve common problems with Istio's use of Kubernetes webhooks for automatic sidecar injection.

Repairing Citadel

What to do if Citadel is not behaving properly.

Debugging Envoy and Pilot

Describes tools and techniques to diagnose Envoy configuration issues related to traffic management.

Galley Configuration Problems

Describes how to resolve Galley configuration problems.

Missing Metrics

Diagnose problems where metrics are not being collected.

Missing Grafana Output

Dealing with Grafana issues.

Missing Zipkin Traces

Fix missing traces in Zipkin.

Understand your Mesh with istioctl describe

Shows you how to use istioctl describe to verify the configurations of a pod in your mesh.

Component Logging

Describes how to use component-level logging to get insights into a running component's behavior.

Component Introspection

Describes how to use ControlZ to get insight into individual running components.

Tcpdump Limitations

Limitations for using Tcpdump in pods.