Stay organized with collections Save and categorize content based on your preferences.
This page lists troubleshooting pages for common issues you might encounter when using Google Kubernetes Engine (GKE). This page is for Admins and architects, Security specialists, Networking specialists, or Storage specialists who troubleshoot GKE configurations. To learn more about GKE roles, see Common GKE user roles and tasks.
If you are new to troubleshooting in GKE or for a high-level overview of fundamental tools and techniques, start with Introduction to troubleshooting.
To diagnose and resolve issues you encounter across various stages of working with your GKE infrastructure, see the following sections:
This page also provides access to more general troubleshooting topics:
To troubleshoot GKE networking, see Troubleshoot GKE networking in the GKE networking documentation.
Introduction to troubleshooting Cluster setup Topic Description Cluster creation Resolve issues with creating clusters. Autopilot clusters Diagnose and troubleshoot GKE Autopilot clusters, including cluster creation, namespace deletion, scaling, and workload issues. Kubectl command-line tool Troubleshoot thekubectl command-line tool in GKE, including issues with authentication, authorization. This page also includes advice on how to troubleshoot the Konnectivity proxy to check if it's causing the kubectl logs, attach, exec, or port-forward commands to stop responding. Standard node pools Troubleshoot GKE Standard node pools, including issues with node pool creation, best-effort provisioning, corrupted instance metadata, and migrating workloads to new node pools. Node registration Troubleshoot issues that occur when adding nodes to your GKE Standard cluster, such as node registration failures and missing prerequisites for successful node registration. Container runtime Troubleshoot container runtimes in GKE, including issues with containerd and dockershim, and private registries. Storage Topic Description Storage Troubleshoot storage, including issues with regional persistent disks, disk performance, and volume expansion. Cluster security Cluster's root Certificate Authority expiring soon Workloads Topic Description Deployed workloads Troubleshoot errors for workloads running in a GKE cluster, including PodUnschedulable. Read the PodUnschedulable section for advice on errors like MatchNodeSelector and Does not have minimum availability. Image pulls Troubleshoot image pulls. Learn what causes statuses like ImagePullBackOff and ErrImagePull and how to resolve these statuses by fixing common issues like authentication and network connectivity. CrashLoopBackOff events Troubleshoot CrashLoopBackOff events in GKE. Diagnose issues like resource exhaustion, app misconfigurations, and liveness probe failures. OOM events Troubleshoot Kubernetes Out of Memory (OOM) events. Identify causes, distinguish event types, and apply effective solutions for both container- and node-level OOM kills. Arm workloads Troubleshoot issues with Arm workloads, including Pods on Arm nodes crashing. TPUs Troubleshoot TPUs, including issues with quota, node auto-provisioning, workload configuration, and scheduling. GPUs Troubleshoot GPUs, including issues with GPU driver installation, device plugin errors, and container images. Cluster management Topic Description Cluster upgrades Troubleshoot and resolve GKE cluster and node upgrade issues, including long or incomplete upgrades, unexpected auto-upgrades, failures, and post-upgrade problems. Webhooks Understand how to troubleshoot and ensure the stability of your cluster control plane when using admission webhooks. Namespace stuck in the Terminating state Troubleshoot issues with namespaces stuck in the Terminating state by identifying and removing the unhealthy components that are blocking deletion. Concurrent operations Troubleshoot concurrent operations by learning how to identify these errors and resolve them by waiting for operations to complete. Monitoring Topic Description System metrics Troubleshoot system metrics not appearing in Cloud Monitoring. Monitoring dashboards Troubleshoot monitoring dashboards, including issues with enabling monitoring, missing Kubernetes resources, and permissions. Logging Troubleshoot logging, including issues with enabling logging, missing logs, and quotas. 4xx errors Known issues Topic Description Known issues Identify and resolve known issues that might affect your use of GKE. What's next
If you can't find a solution to your problem in the documentation, see Get support for further help, including advice on the following topics:
google-kubernetes-engine tag to search for similar issues. You can also join the #kubernetes-engine Slack channel for more community support.Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-12 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-12 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4