Présentation du dépannage de Cloud Run

Cette page décrit les stratégies de dépannage courantes pour les erreurs Cloud Run. Personalized Service Health publie tous les incidents Cloud Run qui proviennent de l'infrastructure Google Cloud sous-jacente pour identifier les interruptions de service Google Cloud qui affectent vos projets. Vous devez également envisager de configurer des alertes pour les événements Personalized Service Health. Pour en savoir plus sur les incidents affectant tous les services Google Cloud , consultez le tableau de bord Google Cloud Service Health.

Pour résoudre les problèmes liés à votre ressource Cloud Run, consultez les sections suivantes du guide de dépannage Cloud Run :

Stratégies de dépannage de Cloud Run

Les sections suivantes expliquent comment appliquer des stratégies de dépannage générales pour résoudre votre erreur. Si vous continuez à rencontrer des erreurs même après avoir suivi les étapes du guide 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 ressource Cloud Run si vous disposez de bons journaux de débogage. Vous devez écrire les journaux de manière à corréler vos journaux de conteneur avec un journal de requêtes.

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 la cause première du problème. Pour en savoir plus sur l'écriture de journaux, consultez Écrire des journaux de conteneur.

Examiner les instances à l'aide de l'explorateur de journaux

Chaque journal de requête dans Cloud Run contient un champ instanceId qui identifie une instance qui traite votre requête. En fonction de la valeur de simultanéité que vous spécifiez, une seule instance peut gérer plusieurs requêtes en même temps.

Lorsque plusieurs instances émettent des journaux en même temps, vous devez filtrer vos instances pour identifier les requêtes séquentielles qui ont entraîné le plantage d'une instance.

Filtrer une instance vous permet de déboguer des problèmes de performances spécifiques liés aux démarrages à froid ou à l'augmentation de la latence. Ces problèmes peuvent également être liés à des variables déclarées dans un champ d'application global, lorsque la valeur est réutilisée dans des requêtes simultanées ultérieures. Par exemple, lorsque vous créez un objet global de pool de connexions unique pour l'instance, puis que vous l'utilisez dans plusieurs requêtes.

Pour filtrer une instance spécifique dans l'explorateur de journaux, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page "Explorateur de journaux" :

    Accéder à l'explorateur de journaux

  2. Sélectionnez un projet Google Cloud existant en haut de la page ou créez-en un.

  3. Sélectionnez la ressource Révision dans Cloud Run pour un service ou Job Cloud Run pour un job.

  4. Développez une entrée de journal pour filtrer par instance spécifique.

  5. Cliquez sur la valeur de l'ID d'instance, puis sélectionnez Afficher les entrées correspondantes.

Lorsque vous examinez des instances, vous pouvez utiliser les investigations Gemini Cloud Assist pour obtenir des informations supplémentaires sur vos journaux. Pour en savoir plus sur les différentes façons de lancer une investigation à l'aide de l'explorateur de journaux, consultez Résoudre les problèmes liés aux investigations Gemini Cloud Assist dans la documentation Gemini.

Résoudre les latences de requête inattendues

Si vous rencontrez des problèmes de latence, procédez comme suit :

  1. Vérifiez si la latence affecte toutes les requêtes envoyées à votre ressource Cloud Run ou seulement un petit pourcentage. Cloud Run est automatiquement intégré à Cloud Monitoring, sans aucune installation ni configuration requise.

    Pour afficher les métriques de latence des requêtes individuelles, procédez comme suit :

    1. Dans la console Google Cloud , accédez à la page Cloud Run :

      Accédez à Cloud Run

    2. Sélectionnez le service ou les tâches dans la liste.

    3. Cliquez sur l'onglet MÉTRIQUES pour afficher le tableau de bord Latences des requêtes.

    Pour afficher les métriques de latence dans Cloud Monitoring, sélectionnez Révision Cloud Run > Request_latencies > Latence des requêtes dans la liste Métriques.

    Pour obtenir la liste complète des métriques Cloud Run disponibles et des informations plus détaillées, consultez Google Cloud  Métriques dans Cloud Monitoring.

  2. Identifiez la requête à 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 identifier les requêtes à forte latence à 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 Intégrer à Cloud Logging.

    Parfois, des dépendances telles que des requêtes adressées à d'autres services peuvent entraîner des problèmes de latence. Pour identifier ces requêtes, vous devez disposer d'une journalisation explicite les ciblant. Si vous ne générez pas de tels journaux, cela peut apparaître comme un problème de latence provenant d'un service Cloud Run.

    De plus, vous devez tenir compte des pics de latence dans le contexte de la période choisie. L'importance d'un pic est relative. Un pic important dans une petite fenêtre peut être négligeable dans une fenêtre plus grande, et inversement. Par conséquent, la période a un impact significatif sur l'interprétation des données de latence.

  3. Essayez d'augmenter le nombre d'instances minimales pour réduire la latence des requêtes entrantes et éviter les démarrages à froid. Vous devez également envisager de modifier votre code source et d'ajuster les paramètres de scaling pour limiter le nombre de connexions à un service de backend.

    Pour en savoir plus, consultez Optimiser les performances.

Résoudre les problèmes avec l'aide de Gemini

Vous pouvez utiliser le chat Gemini Cloud Assist pour analyser les journaux et résoudre les erreurs. Grâce à l'assistance Gemini, vous pouvez identifier et résoudre rapidement les erreurs en tirant parti des capacités d'analyse des journaux de l'outil, ce qui vous permet de gagner du temps et de l'énergie.

Pour utiliser Gemini Cloud Assist depuis la console Google Cloud  :

  1. Assurez-vous que Gemini Cloud Assist est configuré pour votre compte utilisateur et votre projet Google Cloud .

  2. Configurez votre environnement de développement Cloud Run dans votre projet Google Cloud et assurez-vous de disposer des autorisations de déploiement appropriées.

  3. Accédez à la page Cloud Run de la console Google Cloud .

    Accédez à Cloud Run

  4. Dans la barre d'outils de la console, sélectionnez un projet Google Cloud . Utilisez un projet associé à un ID de projet que vous avez envoyé après avoir obtenu l'accès à Gemini Cloud Assist.

  5. Cliquez sur spark Ouvrir ou fermer le chat Gemini AI.

    Le panneau Gemini s'ouvre.

  6. Si nécessaire, cliquez sur Accepter si vous acceptez les conditions.

  7. Si vous avez une question sur une application spécifique, fournissez du contexte en accédant à la page qui affiche votre ressource avant de poser votre question. Lorsqu'il génère une réponse, Gemini inclut des informations sur la page et le projet de la console en cours.

  8. Saisissez une requête dans le panneau Gemini.

    Le tableau suivant fournit quelques exemples de requêtes pour utiliser Gemini Cloud Assist avec Cloud Run.

    Requête Type de réponse
    "Peux-tu m'expliquer ce message d'erreur qui s'affiche dans les journaux de mon conteneur Cloud Run ?" Sans message d'erreur spécifique dans la requête, la sortie fournit des conseils de dépannage pour les messages d'erreur courants des journaux de conteneurs Cloud Run.
    "Peux-tu m'expliquer ce message d'erreur qui s'affiche dans les journaux de mon service Cloud Run ?

    HTTP 429 The request was aborted because there was no available instance. The Cloud Run service might have reached its maximum container instance limit or the service was otherwise not able to scale to incoming requests. This might be caused by a sudden increase in traffic, a long container startup time or a long request processing time."    		 Explication du message d'erreur Cloud Run et de la manière de le résoudre.
    "Comment corriger le message d'erreur suivant lors du déploiement de mon service Cloud Run ?

    HTTP 404: Not found     		Causes courantes de l'erreur et conseils de dépannage
    "Mon service Cloud Run plante sans cesse. Quelle peut être la cause de ce problème ?" Approche pour identifier la cause et résoudre le problème.
    "Comment savoir si une erreur 5XX qui s'est produite dans les journaux est due à une panne du service d'infrastructure Google ?" Étapes pour déterminer la cause de l'erreur 5XX.
    "Comment identifier la cause de l'erreur com.google.apps.framework.request.BadRequestException Project PROJECT has serving status SYSTEM_DISABLED and cannot be modified ?" Indique que le projet Google Cloud a été désactivé administrativement au niveau du système. Fournit des étapes pour approfondir l'enquête sur la cause.
    "Pourquoi puis-je accéder à mon service Cloud Run depuis un navigateur si j'ai défini ingress=internal ?" Explication du comportement attendu lorsque le paramètre ingress est défini sur internal. Inclut d'autres scénarios dans lesquels l'accès peut sembler fonctionner depuis votre navigateur.

Pour en savoir plus, consultez les ressources suivantes :

Utiliser les investigations Gemini Cloud Assist

En plus du chat interactif, Gemini Cloud Assist peut effectuer des analyses plus approfondies et automatisées grâce aux investigations Gemini Cloud Assist. Cette fonctionnalité est intégrée directement aux workflows tels que l'explorateur de journaux. Il s'agit d'un outil puissant d'analyse des causes premières.

Lorsque vous lancez une investigation à partir d'une erreur ou d'une ressource spécifique, Gemini Cloud Assist analyse les journaux, les configurations et les métriques. Il utilise ces données pour générer des observations et des hypothèses classées sur les causes racines probables, puis vous fournit les prochaines étapes recommandées. Vous pouvez également transférer ces résultats vers une demande d'assistance Google Cloud pour fournir un contexte utile qui peut vous aider à résoudre votre problème plus rapidement.

Pour en savoir plus sur les différentes façons de lancer une investigation, consultez Résoudre les problèmes liés aux investigations Gemini Cloud Assist dans la documentation Gemini.

Étapes suivantes

Si vous ne trouvez pas de solution à votre problème dans la documentation Cloud Run, procédez comme suit :