istio.io/content/about/bugs/index.md

title	description	weight	aliases	icon
Reporting Bugs	What to do if you find a bug.	34	/bugs.html /bugs/index.html /help/bugs/	bugs

Oh no! You found a bug?

Search our issue database to see if we already know about your problem and learn about when we think we can fix it. If you don't find your problem in the database, please open a new issue and let us know what's going on.

If you think a bug is in fact a security vulnerability, please visit Reporting Security Vulnerabilities to learn what to do.

If you're running on Kubernetes, consider including a cluster state archive in your bug report.

Generating a cluster state archive

For convenience, you can run a dump script to produce an archive containing all of the needed state from your Kubernetes cluster:

• Run via curl:

  {{< text bash >}} $ curl {{< github_file >}}/tools/dump_kubernetes.sh | sh -s -- -z {{< /text >}}

• Run locally, from the release directory's root:

  {{< text bash >}} $ @tools/dump_kubernetes.sh@ -z {{< /text >}}

Then attach the produced istio-dump.tar.gz with your reported problem.

If you are unable to use the dump script, please attach your own archive containing:

• Pods, services, deployments, and endpoints across all namespaces:

  {{< text bash >}} $ kubectl get pods,services,deployments,endpoints --all-namespaces -o yaml > k8s_resources.yaml {{< /text >}}

• Secret names in istio-system:

  {{< text bash >}} $ kubectl --namespace istio-system get secrets {{< /text >}}

• configmaps in the istio-system namespace:

  {{< text bash >}} $ kubectl --namespace istio-system get cm -o yaml {{< /text >}}

• Current and previous logs from all Istio components and sidecar

• Mixer logs:

  {{< text bash >}} $ kubectl logs -n istio-system -l istio=mixer -c mixer $ kubectl logs -n istio-system -l istio=policy -c mixer $ kubectl logs -n istio-system -l istio=telemetry -c mixer {{< /text >}}

• Pilot logs:

  {{< text bash >}} $ kubectl logs -n istio-system -l istio=pilot -c discovery $ kubectl logs -n istio-system -l istio=pilot -c istio-proxy {{< /text >}}

• All Istio configuration artifacts:

  {{< text bash >}} kubectl get(kubectl get crd --no-headers | awk '{printf "%s,",$1}END{printf "attributemanifests.config.istio.io\n"}') --all-namespaces {{< /text >}}