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 dont vous avez besoin pour afficher les résultats des surveillances synthétiques à l'aide de la console Google Cloud, demandez à votre administrateur de vous attribuer les rôles IAM suivants sur votre projet:

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

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'une surveillance synthétique

Pour comprendre l'historique des exécutions qui ont réussi ou échoué, 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 à la page Surveillance synthétique

    Si vous utilisez la barre de recherche pour accéder à 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, localisez la surveillance synthétique que vous souhaitez afficher, puis cliquez sur son nom.

La page Détails de la surveillance synthétique répertorie 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 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. Elle renvoie également à une page qui affiche le code et les journaux actuels concernant cette exécution.

Afficher les journaux et les traces pour 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.

  • Accédez à la fonction Cloud.

  • Pour le test de Mocha, affichez les résultats de chaque test. Par exemple, si votre surveillance 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 en tant que réussite ou échec.

    Si vous sélectionnez une entrée marquée comme ayant échoué, le code défaillant 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. Par exemple, si vous utilisez Mocha, les journaux incluent des informations sur la réussite ou l'échec du test, sa durée et, en cas d'échec, une trace de la pile complète. La trace de la pile inclut la ligne de code ayant é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 est affichée au format JSON. Si vous préférez afficher les journaux dans l'explorateur de journaux, cliquez sur Open in Logs Explorer (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 automatiquement collectées lors de l'exécution de votre fonction Cloud. La capture d'écran suivante montre le type de données que le trace capture lorsque vous utilisez le modèle générique:

Cloud Trace affichant les détails d'une trace pour une fonction Cloud

Dans la capture d'écran précédente, la première ligne du diagramme de Gantt affiche la requête HTTP initié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 menu déroulant des traces, si vous cliquez sur Afficher dans la 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. Lorsque votre trace ou votre segment affiche un cercle, vous pouvez cliquer sur ce cercle pour afficher l'entrée de journal. Vous pouvez identifier la fonction Cloud en affichant le champ resource.labels.service_name.

Console

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

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

    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 délais, consultez les données dans Cloud Trace. Pour ouvrir Cloud Trace, cliquez sur Afficher dans la trace.

  • Affichez 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 segment, celui-ci est annoté à l'aide 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 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 répertorier 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

Les journaux et les métriques fournissent des informations sur les actions effectuées par votre fonction Cloud. Par exemple, les journaux contenant un champ nommé userAgent avec la valeur GoogleStackdriverMonitoring-UptimeChecks indiquent que votre service a reçu une requête du service de test de disponibilité.

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

Afficher les journaux de la fonction

Console

Pour afficher les journaux de la fonction Cloud, procédez comme suit:

  1. Dans le volet portant le nom de la surveillance synthétique, cliquez sur le nom de la fonction Cloud.
  2. Sur la page Informations sur la fonction, sélectionnez l'onglet Journaux.

Pour explorer plus en détail les données de journal d'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 telles qu'affiner la requête, créer une 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 de journaux de fonctions Cloud de manière automatisée, consultez la page Écrire, afficher des journaux et y répondre.

Afficher les métriques de la fonction

Pour les surveillances synthétiques, les métriques sont collectées par Cloud Monitoring et Cloud Functions:

  • Cloud Monitoring collecte des métriques sur chaque exécution d'une surveillance synthétique. Ces métriques incluent la latence d'exécution du code et l'historique des réussites. Pour en savoir plus sur l'affichage de ces métriques, consultez la section Afficher l'historique d'exécution d'une surveillance synthétique.

  • Cloud Functions collecte des métriques sur chaque fonction Cloud. 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.

Console

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

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

Pour effectuer 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 effectuez un clic gauche.
  2. Faites glisser le pointeur horizontalement vers l'autre extrémité de la période, puis relâchez le bouton de pointeur.

Pour explorer plus en détail les données affichées dans un graphique, sélectionnez Autres options de graphique dans la barre d'outils du graphique, puis faites votre choix. Vous disposez des options 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 en savoir plus sur la lecture automatisée des métriques d'une fonction Cloud, consultez la page Afficher les métriques surveillées.