Explorer les résultats de la surveillance synthétique

Ce document explique comment explorer l'historique d'exécution de vos vérifications synthétiques, et comment afficher les métriques et les journaux collectés.

Cette fonctionnalité n'est disponible que pour les projets Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

Avant de commencer

Dans le projet Google Cloud qui stocke votre contrôleur synthétique, procédez comme suit :

• Pour obtenir les autorisations nécessaires pour afficher les résultats d'exécution des synthétiques à l'aide de la console Google Cloud , demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

  • Lecteur Monitoring (roles/monitoring.viewer)
  • Développeur Cloud Functions (roles/cloudfunctions.developer)
  • Lecteur de journaux (roles/logging.viewer)

  Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

  Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher l'historique des exécutions pour une surveillance synthétique

Pour comprendre l'historique des exécutions réussies et échouées, consultez la page Détails de la surveillance synthétique pour la surveillance synthétique :

1. Dans la console Google Cloud , accédez à la page  Surveillance synthétique :

   Accéder à Surveillance synthétique

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
3. Pour ouvrir la page Détails du test synthétique, recherchez le test synthétique que vous souhaitez afficher, puis cliquez sur son nom.

La page Détails du moniteur synthétique liste des informations récapitulatives, telles que le taux de réussite, la durée et l'état le plus récent. Cette page représente également la durée enregistrée de l'exécution sous forme de graphique et contient un tableau affichant une ligne pour chaque exécution.

Chaque ligne du tableau indique l'état, la date et la durée de l'exécution, et renvoie à une page qui affiche le code actuel et les journaux associés.

Afficher les journaux et les traces d'une exécution

Pour afficher les journaux, les traces et les informations récapitulatives d'une exécution, cliquez sur le lien vers l'exécution sur la page Détails du moniteur synthétique. Sur cette page, vous pouvez effectuer les actions suivantes :

• Afficher les données de journaux
• Affichez les données de trace.

• Affichez le code actuel.

• Accédez à la fonction Cloud Run.

• Pour les tests Mocha, consultez les résultats de chaque test. Par exemple, si votre monitor synthétique contient quatre tests Mocha, le volet Résultats des tests contient quatre entrées. Chaque entrée de la liste est annotée comme réussie ou échouée.

  Si vous sélectionnez une entrée marquée comme ayant échoué, le code en échec s'affiche et est mis en surbrillance.

Consulter les données des journaux

Les journaux sont automatiquement collectés par Cloud Monitoring. Ces journaux contiennent des informations sur le test et les détails de l'échec. Les journaux disponibles dépendent de votre fonction Cloud Run. Par exemple, si vous utilisez Mocha, les journaux incluent des informations indiquant si le test a réussi ou échoué, la durée du test et, en cas d'échec, une trace de pile complète. La trace de la pile inclut la ligne de code qui a échoué, les types d'erreur et les messages d'erreur.

Pour afficher les détails de vos journaux associés, développez une entrée de journal dans le volet Journaux d'exécution.

L'entrée de journal s'affiche au format JSON. Si vous préférez afficher les journaux avec l'explorateur de journaux, cliquez sur Ouvrir dans l'explorateur de journaux. L'explorateur de journaux s'ouvre et une requête est préconfigurée.

Afficher les données de trace

Les données de trace sont collectées lorsque votre fonction Cloud Run s'exécute. Pour afficher les données de trace, utilisez la console Google Cloud ou l'API Cloud Trace.

Afficher les journaux et les métriques d'une fonction Cloud Run

Les journaux et les métriques vous fournissent des informations sur les actions effectuées par votre fonction Cloud Run. Par exemple, les journaux qui contiennent un champ nommé userAgent avec la valeur GoogleStackdriverMonitoring-UptimeChecks indiquent que votre service a reçu une requête du service de vérification du temps d'activité.

Le reste de cette section explique comment afficher les journaux et les métriques collectés par les fonctions Cloud Run.

Afficher les journaux de la fonction

Afficher les métriques de fonction

Pour les surveillances synthétiques, les métriques sont collectées à la fois par Cloud Monitoring et par les fonctions Cloud Run :

• Cloud Monitoring collecte des métriques sur chaque exécution d'un contrôleur synthétique. Ces métriques incluent la latence de l'exécution du code et l'historique des réussites. Pour savoir comment afficher ces métriques, consultez Afficher l'historique d'exécution d'un moniteur synthétique.

• Cloud Run Functions collecte des métriques sur chaque fonction Cloud Run. Ces métriques enregistrent la durée d'exécution, l'utilisation de la mémoire, le nombre d'instances et le nombre d'appels par section. Le reste de cette section explique comment afficher ces métriques.