Cette page décrit la procédure de dépannage des erreurs que vous pouvez rencontrer lors de l'utilisation d'App Engine. Pour en savoir plus sur les incidents affectant les services Google Cloud, consultez le tableau de bord Service HealthGoogle Cloud et Tous les incidents signalés pour App Engine.
Consultez les pages suivantes pour savoir comment résoudre les problèmes liés à votre application :
- Résoudre les problèmes de déploiement
- Résoudre les problèmes de diffusion
- Résoudre les problèmes de latence élevée dans votre application
- Stratégies de connectivité App Engine
Stratégies de dépannage App Engine
Les sections suivantes expliquent comment appliquer des stratégies générales de dépannage pour résoudre votre erreur. Si vous continuez à rencontrer des erreurs même après avoir suivi les étapes des guides de dépannage, consultez Étapes suivantes.
Générer des journaux de qualité à l'aide de Cloud Logging
Il est plus facile de résoudre les problèmes liés à votre application exécutée sur App Engine si vous disposez de bons journaux d'application pour le débogage. Assurez-vous que votre application écrit les journaux de manière à corréler les journaux de requête avec les journaux d'application.
Les journaux corrélés vous permettent d'identifier la requête qui nécessite une analyse plus approfondie, de trouver la trace de la requête et d'analyser la cause première du problème. Pour en savoir plus sur l'écriture de journaux, consultez Écrire des journaux d'application.
Résoudre les problèmes de latence inattendue
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 App Engine affiche la latence des 50e, 95e et 99e centiles.
Si la latence est élevée pour ces trois métriques, cela signifie qu'elle l'est pour au moins 50 % de vos requêtes. Si vous ne constatez une latence élevée que dans le graphique du 99e centile, cela signifie que 1 % de vos requêtes présentent une latence élevée.
Identifiez la requête présentant une latence élevée pour comprendre la source de la 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 des applications.
Pour identifier les requêtes à forte latence à l'aide de Cloud Logging, appliquez le filtre
traceSampled=trueafin de corréler les journaux dans Cloud Logging avec les traces dans Cloud Trace. Pour en savoir plus, consultez Intégrer à Cloud Logging.Pour résoudre les problèmes de latence et améliorer les performances du service, procédez comme suit :
Augmentez les paramètres de la classe d'instance.
Réduisez la latence de démarrage à froid en configurant des requêtes de préchauffage.
Ajustez les paramètres de scaling.
Envisagez d'utiliser Profiler.
Modifiez votre code source.
Pour savoir comment résoudre les problèmes de latence élevée, consultez Résoudre les problèmes de latence élevée dans votre application.
Résoudre les problèmes de connectivité
Par défaut, votre service App Engine est accessible sur l'Internet public. Toutefois, vous pouvez le modifier pour limiter davantage la connectivité réseau entrante et sortante.
Vous pouvez restreindre les connexions entrantes à l'aide des paramètres d'entrée ou des règles de pare-feu App Engine. Si vous rencontrez des difficultés pour vous connecter à votre service App Engine à partir de réseaux VPC ou de ressources Internet, vérifiez les points suivants :
Pour résoudre d'autres problèmes de connectivité :
Exécutez un test de connectivité réseau.
Pour résoudre les problèmes de trafic sortant vers un réseau VPC, vérifiez les règles de pare-feu du réseau VPC ou utilisez le regroupement de connexions dans votre client. Pour en savoir plus, consultez Règles de pare-feu.
Assurez-vous de ne pas surcharger votre connecteur VPC avec plus de services et de connexions que son seuil. Pour améliorer le débit, tenez compte de la taille du connecteur VPC et du nombre d'instances pour vos connecteurs. Pour en savoir plus, consultez Accès au VPC sans serveur.
En cas de problème d'accès aux ressources VPC, consultez les graphiques sur le débit du connecteur VPC.
Pour savoir comment résoudre les problèmes de connectivité, consultez Stratégies de connectivité App Engine.
Étapes suivantes
Si vous ne trouvez pas de solution à votre problème dans la documentation App Engine, procédez comme suit :
- Ouvrez une demande d'assistance en contactant Cloud Customer Care.
- Obtenez de l'aide de la communauté en posant des questions sur Stack Overflow ou en recherchant des problèmes similaires à l'aide du tag
google-app-engine. - Signaler des bugs ou demander des fonctionnalités à l'aide de l'outil public de suivi des problèmes.
Pour en savoir plus, consultez la communauté App Engine.