Explorer les résultats de la surveillance synthétique

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

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher les résultats d'exécution des moniteurs 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 via des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher l'historique des exécutions d'un moniteur synthétique

Pour comprendre l'historique des exécutions réussies et non réussies, consultez la page Détails de la surveillance synthétique de 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. Pour ouvrir la page Détails de la surveillance synthétique, recherchez la surveillance synthétique que vous souhaitez afficher, puis cliquez sur son nom.

La page Détails de la surveillance synthétique contient des informations récapitulatives, telles que le taux de réussite et la durée, ainsi que l'état le plus récent. Cette page affiche également la durée enregistrée de l'exécution et contient un tableau qui affiche une ligne pour chaque exécution.

Chaque ligne du tableau indique l'état, la date et la durée, et comporte un lien vers une page qui affiche le code actuel et les journaux pertinents pour cette exécution.

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, sur la page Synthetic monitor details (Détails de la surveillance synthétique), cliquez sur le lien correspondant à l'exécution. Sur cette page, vous pouvez effectuer les opérations suivantes:

• Affichez les données de journal.
• Affichez les données de trace.

• Affichez le code actuel.

• Accédez à la fonction Cloud Run.

• Pour le test Mocha, affichez les résultats de chaque test. Par exemple, si votre moniteur 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 non.

  Si vous sélectionnez une entrée marquée comme ayant échoué, le code d'erreur 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é, sa durée 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 automatiquement lorsque votre fonction Cloud Run s'exécute. La capture d'écran suivante montre le type de données que la trace capture lorsque vous utilisez le modèle générique:

Dans la capture d'écran précédente, la première ligne du graphique Gantt affiche la requête HTTP lancée par Cloud Monitoring. Les données de trace affichent le texte transmis à l'enregistreur winston, ainsi que la requête HTTP sortante émise par l'appel get axios.

Dans le volet déroulant de la trace, si vous cliquez sur Afficher dans Trace, vous pouvez afficher vos données de trace à l'aide de l'explorateur Cloud Trace. Votre trace est déjà développée pour afficher les détails. Lorsqu'un cercle s'affiche sur votre trace ou votre intervalle, vous pouvez cliquer dessus pour afficher l'entrée de journal. Vous pouvez identifier la fonction Cloud Run en consultant le champ resource.labels.service_name.

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 contenant un champ nommé userAgent avec une valeur de GoogleStackdriverMonitoring-UptimeChecks indiquent que votre service a reçu une requête du service de vérification de la disponibilité.

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 la fonction

Pour les moniteurs 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 moniteur synthétique. Ces métriques incluent la latence de l'exécution du code et l'historique des succès. Pour savoir comment afficher ces métriques, consultez la section Afficher l'historique d'exécution d'une surveillance 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.