Explorer les résultats de la surveillance synthétique

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

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

Avant de commencer

Effectuez les opérations suivantes dans le Google Cloud projet qui stocke votre surveillance synthétique :

Afficher l'historique d'exécution d'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 de la surveillance synthétique :

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

    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 Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
  3. 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 affiche 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, et renvoie à 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, cliquez sur le lien vers l'exécution sur la page Détails de la surveillance synthétique. Sur cette page, vous pouvez effectuer les opérations suivantes :

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

  • Afficher le code actuel.

  • Accéder à la fonction Cloud Run.

  • Pour le test 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 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.

Afficher les données de journal

Les journaux sont automatiquement collectés par Cloud Monitoring. Ils 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 la pile complète. La trace de pile inclut la ligne de code qui a échoué, les types d'erreurs 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 Google Cloud console ou l'API Cloud Trace pour afficher les données de trace.

Console

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

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

    Le panneau Détails s'ouvre et affiche un graphique de Gantt contenant des informations sur chaque segment, qui est un enregistrement d'une opération dans la trace. Pour obtenir des informations complètes sur la trace et ses segments, cliquez sur Afficher dans Cloud Trace, ce qui ouvre la page Explorateur Trace.

  • Affichez vos traces dans Cloud Trace :

    1. Dans la Google Cloud console, 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 la barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
    3. Dans le graphique de carte thermique ou dans le tableau, sélectionnez une trace.

Votre trace et vos segments peuvent inclure des cercles dans la chronologie qui représentent des entrées de journal ou des événements survenus lors de l'exécution. Cliquez sur le cercle pour afficher des informations sur l'entrée de journal ou l'événement. Pour identifier une fonction Cloud Run dans une entrée de journal, consultez le champ resource.labels.service_name.

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

REST

Nous vous recommandons d'utiliser la Google Cloud console pour afficher les données de trace. Toutefois, si vous souhaitez utiliser l'API Cloud Trace, utilisez la traces.list méthode pour lister les traces disponibles, puis utilisez la traces.get méthode 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 effectuées par votre fonction Cloud Run. 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 Run Functions.

Afficher les journaux de la fonction

Console

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

  1. Dans le volet portant 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. Dans l'explorateur de journaux, vous pouvez effectuer des actions telles que affiner la requête, créer une métrique basée sur les journaux ou créer une alerte basée sur les journaux.

REST

Pour savoir comment lire et écrire des journaux Cloud Run Functions de manière programmatique, consultez la page Écrire, afficher et répondre à des journaux.

Afficher les métriques de la fonction

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

  • Cloud Monitoring collecte des métriques sur chaque exécution d'une surveillance 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 la page 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.

Pour afficher les métriques Cloud Run Functions dans la Google Cloud console, procédez comme suit :

  1. Dans le volet portant 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 Métriques.

Pour effectuer un zoom sur une plage de temps spécifique, procédez comme suit :

  1. Dans un graphique, placez le pointeur à une extrémité de la plage de temps, puis cliquez sur le bouton gauche.
  2. Faites glisser le pointeur horizontalement jusqu'à l'autre extrémité de la plage de temps, puis relâchez le bouton.

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 effectuez une sélection. Les options incluent 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