Les sections suivantes expliquent comment appliquer des stratégies de dépannage générales pour résoudre votre erreur. Si des erreurs persistent même après avoir suivi les étapes décrites dans les guides de dépannage, consultez la section Et maintenant ?.
Générer des journaux de qualité à l'aide de Cloud Logging
Le dépannage de votre application exécutée sur App Engine est plus facile si vous disposez de bons journaux d'application pour le débogage. Assurez-vous que votre application écrit des journaux de manière à corréler les journaux de requêtes avec les journaux de l'application.
Grâce aux journaux corrélés, vous pouvez identifier la requête qui nécessite une analyse plus approfondie, trouver la trace de la requête et analyser l'origine du problème. Pour en savoir plus sur l'écriture de journaux, consultez la section Écrire des journaux d'application.
Résoudre les problèmes de latence inattendus
Si vous rencontrez des problèmes de latence, procédez comme suit:
Vérifiez si la latence affecte toutes les requêtes envoyées à votre service ou seulement un petit pourcentage. Le tableau de bord de latence d'App Engine affiche la latence des 50e, 95e et 99e centiles.
Si la latence est élevée pour ces trois métriques, elle est élevée pour au moins 50% de vos requêtes. Si vous ne voyez qu'une latence élevée dans le graphique du 99e centile, cela signifie que la latence est élevée dans 1% de vos requêtes.
Identifiez la requête présentant une latence élevée pour comprendre la source de latence. Vous pouvez utiliser Cloud Trace ou Cloud Logging pour comprendre la durée d'une requête spécifique. Pour en savoir plus, consultez Comprendre la latence de l'application.
Pour identifier les requêtes présentant une latence élevée à l'aide de Cloud Logging, appliquez le filtre traceSampled=true afin de corréler les journaux dans Cloud Logging avec les traces dans Cloud Trace. Pour en savoir plus, consultez la section Intégrer à Cloud Logging.
Pour résoudre les problèmes de latence et améliorer les performances du service, procédez comme suit:
Par défaut, votre service App Engine est accessible sur l'Internet public. Toutefois, vous pouvez modifier le service pour appliquer davantage de restrictions à la connectivité réseau entrante et sortante.
Vous pouvez limiter les connexions entrantes à l'aide des paramètres d'entrée ou des règles de pare-feu App Engine. Si vous ne parvenez pas à vous connecter à votre service App Engine à partir de réseaux VPC ou de ressources Internet, vérifiez les points suivants:
Pour résoudre les problèmes de sortie de trafic vers un réseau VPC, vérifiez les règles de pare-feu du réseau VPC ou utilisez le pool de connexions dans votre client. Pour en savoir plus, consultez la section Règles de pare-feu.
Assurez-vous de ne pas surcharger votre connecteur VPC avec des services et des connexions dépassant son seuil. Pour améliorer le débit, tenez compte de la taille et du nombre d'instances de vos connecteurs VPC. Pour en savoir plus, consultez la page Accès au VPC sans serveur.
Obtenez de l'aide de la communauté en posant des questions sur StackOverflow ou en recherchant des problèmes similaires à l'aide de la balise google-app-engine.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis page provides guidance on troubleshooting errors encountered while using App Engine, with links to resources for deployment, serving, latency, and connectivity issues.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing Cloud Logging to ensure correlated request and application logs is essential for efficient debugging and identifying the root cause of issues.\u003c/p\u003e\n"],["\u003cp\u003eIf encountering latency issues, check the App Engine latency dashboard to determine the scope of the problem and use Cloud Trace or Logging to pinpoint the source of the latency, and modify your app in accordance with the suggestions provided.\u003c/p\u003e\n"],["\u003cp\u003eConnectivity issues can be resolved by reviewing ingress settings, App Engine firewall rules, running network connectivity tests, and checking VPC network configurations.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Cloud Service Health Dashboard and the history of all App Engine-related incidents are valuable resources for staying informed about service disruptions.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot App Engine errors\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\nThis page describes the troubleshooting process for errors you might encounter while\nusing App Engine. For information about incidents affecting Google Cloud\nservices, refer to the [Google Cloud Service Health Dashboard](https://status.cloud.google.com/summary) and [All incidents reported for App Engine](https://status.cloud.google.com/products/kchyUtnkMHJWaAva8aYc/history).\n\nSee the following pages for guidance on how to resolve issues related to your app:\n\n- [Troubleshoot deployment issues](/appengine/docs/standard/troubleshooter/deployment)\n- [Troubleshoot serving issues](/appengine/docs/standard/troubleshooter/serving)\n- [Troubleshoot elevated latency in your app](/appengine/docs/standard/troubleshooter/latency)\n- [App Engine connectivity strategies](/appengine/docs/standard/troubleshooter/connectivity)\n\nApp Engine troubleshooting strategies\n-------------------------------------\n\nThe following sections explain how you can apply general troubleshooting\nstrategies to resolve your error. If you continue to encounter errors\neven after following the steps in the troubleshooting guides, see [What's next](#whats-next).\n\n### Output good logs using Cloud Logging\n\nTroubleshooting your app running on App Engine is easier if you have good\napplication logs for debugging. Ensure your application writes logs in a way that\n[correlates request logs with the application logs](/appengine/docs/standard/writing-application-logs#correlate_logs).\n\nWith correlated logs you can identify the request that needs further analysis,\nfind the request trace, and analyze the root cause of the issue. For more\ninformation on writing logs, see [Write application logs](/appengine/docs/standard/writing-application-logs#writing_app_logs).\n\n### Resolve unexpected latency\n\nIf you encounter issues with latency, do the following:\n\n1. Check if the latency is affecting all requests to your service or only a\n small percentage. The [App Engine latency dashboard](/appengine/docs/standard/monitoring-and-alerting-latency#checking_the_latency_dashboard) shows 50th,\n 95th, and 99th percentile latency.\n\n If you have high latency on all three of these metrics, you have high latency\n for at least 50% of your requests. If you only see high latency in the\n 99th percentile graph, you have high latency in 1% of your requests.\n2. Identify the request with high latency to understand the source of\n latency. You can use Cloud Trace or Cloud Logging to understand how\n long a particular request has taken. For more information, see [Understanding app latency](/appengine/docs/standard/monitoring-and-alerting-latency#understanding_app_latency).\n\n To identify requests with high latency using Cloud Logging, apply the `traceSampled=true` filter to correlate logs in Cloud Logging with traces in Cloud Trace. For more information, see [Integrate with Cloud Logging](/trace/docs/trace-log-integration).\n3. Try the following steps to fix latency issues, and improve service performance:\n\n - Increase the [instance class](/appengine/docs/standard#instance_classes) settings.\n\n - Reduce cold start latency by [configuring warmup requests](/appengine/docs/standard/configuring-warmup-requests).\n\n - Adjust [scaling settings](/appengine/docs/standard/how-instances-are-managed#scaling_dynamic_instances).\n\n \u003c!-- --\u003e\n\n - Consider using [Profiler](/appengine/docs/standard/cloud-profiler).\n\n - Modify your source code.\n\nFor more information on how to troubleshoot elevated latency issues, see [Troubleshoot elevated latency in your app](/appengine/docs/standard/troubleshooter/latency).\n\n### Resolve issues with connectivity\n\nBy default, your App Engine service is accessible on the public internet, however,\nyou can modify the service to have more restrictions on ingress and egress\nnetwork connectivity.\n\nYou can restrict ingress connections with the ingress settings, or through App Engine firewall rules. If you have trouble connecting to your App Engine service from\nVPC networks or internet resources, check the following:\n\n- [Ingress settings](/appengine/docs/standard/ingress-settings)\n- [App Engine firewall](/appengine/docs/standard/understanding-firewalls)\n\nTo resolve other connectivity issues, do the following:\n\n- Run a [network connectivity test](/network-intelligence-center/docs/connectivity-tests/how-to/running-connectivity-tests#console_6).\n\n- To resolve problems with traffic egress to a VPC network, check the VPC network\n firewall rules or use connection pooling in your client. For more information,\n see [Firewall rules](/vpc/docs/serverless-vpc-access#connector-fw-rules-standalone-vpc-or-host-prj).\n\n- Ensure that you aren't [overloading your VPC connector](/appengine/docs/standard/connecting-vpc#network-cpu) with more services and\n connections beyond its threshold. To improve throughput, consider the VPC connector\n size and instance count for your connectors. For more information, see\n [Serverless VPC Access](/vpc/docs/serverless-vpc-access#scaling).\n\n- For problems accessing VPC resources, review the [VPC connector throughput charts](/vpc/docs/serverless-vpc-access#throughput_chart).\n\nFor more information on how to troubleshoot connectivity issues, see\n[App Engine connectivity strategies](/appengine/docs/standard/troubleshooter/connectivity).\n\n### What's next\n\nIf you can't find a solution to your problem in the App Engine\ndocumentation, follow these steps:\n\n- Open a support case by contacting [Cloud Customer Care](/support-hub).\n- Get support from the community by [asking questions on StackOverflow](https://stackoverflow.com/questions/tagged/google-app-engine), or search for similar issues using the `google-app-engine` tag.\n- Open bugs or feature requests by using the [public issue tracker](/support/docs/issue-trackers).\n\nFor more information, see [App Engine community](/appengine/docs/standard/community)."]]
