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 de la surveillance synthétique à l'aide de la console Google Cloud, demandez à votre administrateur de vous accorder le 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 pour une surveillance synthétique

Pour comprendre l'historique des exécutions ayant réussi ou échoué, consultez la Page Détails de la surveillance synthétique pour la surveillance synthétique:

  1. Dans la console Google Cloud, accédez à 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 répertorie des informations récapitulatives, telles que le taux de réussite et la durée, et 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.

  • Accéder à la fonction Cloud

  • Pour le test Mocha, affichez les résultats. 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 comme une réussite ou un échec.

    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 pour votre fonction Cloud. Par exemple, si vous utilisez Mocha, puis 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, accédez au volet Journaux d'exécution : développer une entrée de journal.

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 automatiquement collectées lorsque votre fonction Cloud 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:

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 le Requête HTTP initiée par Cloud Monitoring. Les données de trace affichent transmis à l'enregistreur Winston et affiche le journal sortant Requête HTTP émise par l'appel get d'axios.

Dans le menu déroulant des traces, Si vous cliquez sur Afficher dans les traces, vous pouvez afficher vos données de trace à l'aide de la propriété 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 en affichant la 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, accédez à la barre d'outils de la page d'informations Pour une exécution, cliquez sur Afficher les détails des traces.

    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 les traces.

  • 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é avec 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 utilisez 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 vous fournissent des informations sur les actions que vos Cloud Functions est en cours d'exécution. Par exemple, les journaux contenant champ nommé userAgent avec une valeur de GoogleStackdriverMonitoring-UptimeChecks, indique que votre service 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ées 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 indiquant le nom de votre 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 les données de journal d'un graphique plus en détail, 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 que l'affinage de la requête, la création 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 de manière automatisée, consultez Écrire et afficher des journaux, et y répondre

Afficher les métriques d'une fonction

Pour la surveillance synthétique, les métriques sont collectées à la fois par Cloud Monitoring Cloud Functions:

  • Cloud Monitoring collecte des métriques sur chaque exécution la surveillance synthétique. Ces métriques incluent la latence d'exécution du code l’historique de la réussite. Pour savoir comment afficher ces métriques, consultez Affichez l'historique des exécutions pour une surveillance synthétique.

  • Cloud Functions collecte des métriques sur chaque fonction Cloud. 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, procédez comme suit:

  1. Dans le volet indiquant le nom de votre 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 avant 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 Autres options de graphique, 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 en savoir plus sur la lecture des fonctions Cloud de manière programmatique, consultez Afficher les métriques surveillées