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:
Troubleshoot the kubectl 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.
Troubleshoot GKE Standard node pools,
including issues with node pool creation, best-effort provisioning,
corrupted instance metadata, and migrating workloads to new node pools.
Troubleshoot issues that occur when adding nodes to your
GKE Standard cluster, such as node registration
failures and missing prerequisites for successful node registration.
If your cluster's root Certificate Authority (CA) is expiring soon, learn
how to perform a credential rotation
to prevent normal cluster operations from being interrupted.
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.
Troubleshoot Kubernetes Out of Memory (OOM) events. Identify causes,
distinguish event types, and apply effective solutions for both container-
and node-level OOM kills.
Troubleshoot and resolve GKE cluster and node
upgrade issues, including long or incomplete upgrades, unexpected
auto-upgrades, failures, and post-upgrade problems.
Troubleshoot some of the 400, 401, 403, and 404 errors that you might
encounter when using GKE. This page also includes
information on how to troubleshoot
missing edit permissions on account errors.
[[["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-26 UTC."],[],[],null,["# Troubleshoot GKE\n\n[Autopilot](/kubernetes-engine/docs/concepts/autopilot-overview) [Standard](/kubernetes-engine/docs/concepts/choose-cluster-mode)\n\n*** ** * ** ***\n\nThis page lists troubleshooting pages for common issues you might\nencounter when using Google Kubernetes Engine (GKE). This page is for\nAdmins and architects, Security specialists, Networking specialists, or\nStorage specialists who troubleshoot GKE configurations. To\nlearn more about GKE roles, see\n[Common GKE user roles and tasks](/kubernetes-engine/enterprise/docs/concepts/roles-tasks).\n\nIf you are new to troubleshooting in GKE or for a high-level\noverview of fundamental tools and techniques, start with\n[Introduction to troubleshooting](#introduction).\n\nTo diagnose and resolve issues you encounter across various stages of working\nwith your GKE infrastructure, see the following sections:\n\n- [Cluster setup](#cluster-setup)\n- [Storage](#storage)\n- [Cluster security](#cluster-security)\n- [Workloads](#workloads)\n- [Cluster management](#cluster-management)\n- [Monitoring](#monitoring)\n\nThis page also provides access to more general troubleshooting topics:\n\n- [4xx errors](#gke_service_account_deleted)\n- [Known issues](#known-issues)\n\nTo troubleshoot GKE networking, see\n[Troubleshoot GKE networking](/kubernetes-engine/docs/troubleshoot-networking)\nin the GKE networking documentation.\n\nIntroduction to troubleshooting\n-------------------------------\n\nCluster setup\n-------------\n\nStorage\n-------\n\nCluster security\n----------------\n\n### Cluster's root Certificate Authority expiring soon\n\nWorkloads\n---------\n\nCluster management\n------------------\n\nMonitoring\n----------\n\n4xx errors\n----------\n\nKnown issues\n------------\n\nWhat's next\n-----------\n\n- If you can't find a solution to your problem in the documentation, see\n [Get support](/kubernetes-engine/docs/getting-support) for further help,\n including advice on the following topics:\n\n - Opening a support case by contacting [Cloud Customer Care](/support-hub).\n - Getting support from the community by [asking questions on StackOverflow](http://stackoverflow.com/questions/tagged/google-kubernetes-engine) and using the `google-kubernetes-engine` tag to search for similar issues. You can also join the [`#kubernetes-engine` Slack channel](https://googlecloud-community.slack.com/messages/C0B9GKTKJ/) for more community support.\n - Opening bugs or feature requests by using the [public issue tracker](/support/docs/issue-trackers)."]]