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 Health de Google Cloud et Tous les incidents signalés pour App Engine.
Pour obtenir des conseils sur la résolution des problèmes liés à votre application, consultez les pages suivantes:
- 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 de dépannage générales pour résoudre votre erreur. Si le problème persiste même après avoir suivi les étapes des guides de dépannage, contactez l'assistance.
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 d'application.
Avec les 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:
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 mise à l'échelle.
Envisagez d'utiliser Profiler.
Modifiez votre code source.
Pour en savoir plus sur la résolution des 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 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 d'autres problèmes de connectivité, procédez comme suit:
Exécutez un test de connectivité réseau.
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.
En cas de problème d'accès aux ressources du VPC, consultez les graphiques sur le débit des connecteurs VPC.
Pour en savoir plus sur la résolution des problèmes de connectivité, consultez la section Stratégies de connectivité App Engine.