Explorer les résultats de la surveillance synthétique

Ce document explique comment explorer l'historique d'exécution de votre la surveillance synthétique, et comment afficher les métriques collectées journaux.

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 l'écran synthétique, recherchez l'icône 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 présente é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 renvoie vers un 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 Détails de la surveillance synthétique, cliquez sur le lien vers l'exécution. Sur cette page, vous pouvez effectuer les opérations suivantes :

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

• Affichez le code actuel.

  Remarque :Les fonctions Cloud Run stockent une copie de votre code. Lorsque vous affichez les résultats d'une exécution, le code affiché est le code actuel et il est possible qu'il ne soit pas pertinent pour l'exécution spécifique.

• Accédez à la fonction Cloud Run.

• Pour le test Mocha, affichez les résultats. 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'échec s'affiche. et mis en surbrillance.

Consulter les données des journaux

Les journaux sont automatiquement collectés par Cloud Monitoring. Ces journaux contiennent sur les détails du test et de l'échec. Les journaux disponibles dépendent votre fonction Cloud Run. Par exemple, si vous utilisez Mocha, alors le les journaux contiennent des informations indiquant si le test a réussi ou échoué, et, en cas d'échec, une trace complète de la pile. La la trace de la pile inclut la ligne de code qui a échoué, les types d'erreurs et 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 voir à l'aide de l'Explorateur de journaux, puis 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 capturées par la trace 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. Quand ? votre trace ou votre segment affiche un cercle, vous pouvez cliquer dessus pour afficher entrée de journal. Vous pouvez identifier la fonction Cloud Run en consultant le champ resource.labels.service_name.

Console

Pour afficher vos données de trace, effectuez l'une des opérations suivantes:

• Pour afficher les informations récapitulatives d'une trace, dans la barre d'outils de la page d'informations d'une exécution, cliquez sur Afficher les détails de la trace.

  Un menu déroulant s'ouvre et affiche un résumé des données de latence. Pour obtenir des informations complètes sur la trace et ses segments, affichez les données dans Cloud Trace. Pour ouvrir Cloud Trace, cliquez sur Afficher dans la trace.

• Afficher vos traces dans Cloud Trace :

  1. Dans la console Google Cloud, accédez à la page Explorateur Trace.

     Accéder à Explorateur Trace

     Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

  2. Dans le graphique à nuage de points ou dans le tableau, sélectionnez une trace.
  3. Pour chaque journal ou événement associé à un intervalle, celui-ci est annoté d'un cercle. Pour obtenir des détails sur l'événement ou le journal, sélectionnez le cercle.

Pour en savoir plus sur l'exploration de vos données de trace, consultez la section Rechercher et explorer des traces.

API

Nous vous recommandons d'utiliser la console Google Cloud pour afficher les données de trace. Toutefois, si vous souhaitez utiliser l'API Cloud Trace, utilisez la méthode traces.list pour lister les traces disponibles, puis la méthode traces.get pour obtenir les détails d'une 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 que vos la fonction Cloud Run est en cours d'exécution. 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ées par les fonctions Cloud Run.

Afficher les journaux de la fonction

Console

Pour afficher les journaux des fonctions Cloud Run, procédez comme suit :

1. Dans le volet indiquant le nom de votre surveillance synthétique, cliquez sur le nom de la fonction Cloud Run.
2. Sur la page Détails de la fonction, sélectionnez l'onglet Journaux.

Pour explorer plus en détail les données de journal dans un graphique, développez une entrée de journal, puis sélectionnez Ouvrir dans l'explorateur de journaux. À partir de l'explorateur de journaux, vous pouvez : effectuer des actions, par exemple affiner la requête, créer métrique basée sur les journaux ou créer une alerte basée sur les journaux.

API

Pour en savoir plus sur la lecture et l'écriture d'une fonction Cloud Run de manière automatisée, consultez Écrire et afficher des journaux, et y répondre

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.

• Les fonctions Cloud Run collectent des métriques sur chaque fonction Cloud Run. Ces les métriques enregistrent le temps d'exécution, l'utilisation de la mémoire, l'état et le nombre d'appels par section. Le reste de cette section explique comment afficher ces métriques.

Console

Pour afficher les métriques de la fonction Cloud Run, procédez comme suit:

1. Dans le volet indiquant le nom de votre surveillance synthétique, cliquez sur le nom de la fonction Cloud Run.
2. Sur la page Informations sur la fonction, sélectionnez l'onglet Métriques.

Pour faire un zoom sur une période spécifique, procédez comme suit :

1. Sur un graphique, placez le pointeur à une extrémité de la période, puis cliquez sur le bouton gauche de la souris.
2. Faites glisser le pointeur horizontalement vers l'autre extrémité de la période, puis relâchez le bouton du pointeur.

Pour explorer plus en détail les données affichées dans un graphique, Dans la barre d'outils du graphique, sélectionnez Plus d'options pour les graphiques, puis faire une sélection. Les options sont les suivantes:

• Télécharger le graphique au format PNG ou CSV
• Enregistrer le graphique dans un tableau de bord personnalisé
• Ouvrir l'explorateur de métriques
• Développer ou réduire la légende du graphique
• Réinitialiser le zoom

API

Pour savoir comment lire les métriques des fonctions Cloud Run de manière programmatique, consultez la section Afficher les métriques surveillées.