Troubleshoot issues
Running into an issue while using Gloo Gateway? Try the following debug guides and troubleshooting topics to find why things might not behave as expected. If you are still stuck, try posting on the Solo.io Slack.
General steps before debugging
- Make sure that you run a supported version of Gloo, Istio, and Kubernetes and their related command line interface (CLI) tools. If not, upgrade your version and CLIs.
- Review your infrastructure provider for any errors, incidents, or outages that might impact your clusters, load balancers, and related infrastructure. Common configuration problems happen in the following resources:
- Firewalls
- Application load balancer (ALB) settings
- Expired or malformatted certificates, tokens, and secrets
- To help you debug issues in your environment, you can generate a
.tar.gz
file of your Gloo and Istio operational information. For more information, see the CLI reference.meshctl debug report
- To generate a file for multiple clusters:
meshctl debug report --kubecontext cluster1,cluster2,cluster3
- To include information from application namespaces in addition to the
gloo-mesh
and Istio namespaces:meshctl debug report --include-namespaces app1,app2
- To upload the debug information to a secure repo owned by Solo.io, you can set a folder structure that makes it easy to identify your upload.
meshctl debug report --upload true --upload-dir <your_name>/<issue_name>
- To generate a file for multiple clusters:
Troubleshooting topics
-
Gloo setup: Troubleshoot issues by reviewing the Gloo server and agent statuses, snapshots, logs, and more.
-
Gloo UI graph: Debug the Gloo UI, such as if services do not show up in the Graph.
-
Gloo Portal: Debug the Gloo Platform developer portal for securing sharing your API products.