Créer et afficher des rapports d'analyses

Les rapports d'analyse de Cloud Trace vous offrent une vue d'ensemble de la latence de toutes les requêtes ou d'un sous-ensemble de requêtes vers votre application.

Rapports quotidiens

Trace crée automatiquement un rapport quotidien qui compare les performances du jour précédent avec celles du même jour de la semaine précédente pour les trois principaux points de terminaison. Le rapport quotidien s'affiche dans la fenêtre Vue d'ensemble de Trace et est répertorié dans la fenêtre Rapport d'analyse.

Pour en savoir plus sur l'affichage du rapport d'analyse quotidien, consultez la section Afficher un rapport.

Rapports d'analyse personnalisés

Le rapport d'analyse quotidien est créé automatiquement et ne vous permet pas de choisir le contenu du rapport. Toutefois, vous pouvez créer un rapport d'analyse personnalisé et sélectionner les traces à inclure dans le rapport.

Les rapports personnalisés incluent les éléments suivants :

  • Un histogramme de données de latence.
  • Un tableau qui répertorie la latence par centile ainsi que des liens vers des exemples de traces.
  • (Facultatif) Des données de latence d'une période différente que vous utilisez pour la comparaison.
  • Un volet de goulot d'étranglement qui répertorie les appels RPC contribuant de manière significative à la latence.

Vous pouvez créer un rapport en saisissant manuellement les paramètres du rapport, ou dupliquer un rapport existant et modifier ses paramètres. Ces deux approches sont décrites dans les sections suivantes.

Créer un rapport

Pour créer un rapport d'analyse, procédez comme suit :

  1. Dans Google Cloud Console, accédez à Trace :

    Accéder à Stackdriver Trace

  2. Sous l'onglet Rapports d'analyse, cliquez sur Nouveau rapport.

  3. Saisissez ou sélectionnez les paramètres suivants dans le formulaire qui s'affiche :

    • Request filter : L'URI complet, le préfixe de l'URI ou les termes du filtre de trace.

      Par exemple, si le délai racine d'un projet est Recv, pour inclure toutes les requêtes, saisissez le nom du délai racine, Recv, ou un préfixe du nom du délai racine. Pour limiter le rapport aux traces dont l'URI est précédé de Recv/cart, saisissez ce préfixe dans le filtre.

      Vous pouvez également filtrer les traces par attributs de délai. Par exemple, lorsque vous ajoutez /http/status_code:5, le rapport n'inclut que les traces comportant un délai avec la clé d'attribut /http/status_code et les valeurs d'attribut précédées de 5.
    • HTTP method : Méthode HTTP utilisée pour la requête. La valeur par défaut est Toutes.
    • HTTP Status : État HTTP renvoyé par la requête. La valeur par défaut est Tous.
    • Report Name : Nom lisible du rapport. Si aucun nom n'est spécifié pour ce champ facultatif, Trace crée un nom basé sur le filtre de requête spécifié et l'heure de création du rapport.
    • Module : module App Engine (Java, Python, Go ou PHP) ayant géré la requête. La valeur par défaut est Tous.
    • Version : Version de l'application App Engine qui a traité la requête. La valeur par défaut est Toutes.
    • Time Range : Période au cours de laquelle les requêtes ont eu lieu. Vous pouvez sélectionner la Dernière heure, les Dernières 24 heures, La semaine dernière ou une Période personnalisée. Lorsque vous sélectionnez Personnalisée, vous devez spécifier les heures de début et de fin de la plage. La valeur par défaut est Personnalisée.
  4. (Facultatif) Pour comparer deux ensembles de données de latence, sélectionnez Comparer à la référence et saisissez la période de comparaison.

  5. Cliquez sur Envoyer.

Dupliquer un rapport

Dans Trace, vous pouvez dupliquer les paramètres de filtre d'un rapport existant :

  1. Dans Google Cloud Console, accédez à Trace :

    Accéder à Stackdriver Trace

  2. Dans l'onglet Rapports d'analyse, cliquez sur le nom du rapport dont vous souhaitez dupliquer la structure.

  3. Cliquez sur Créer un rapport similaire.

  4. Dans la fenêtre Nouvelle demande de rapport, modifiez un ou plusieurs paramètres, y compris le nom du rapport.

  5. Cliquez sur Envoyer.

Afficher un rapport

Pour afficher un rapport d'analyse, procédez comme suit :

  1. Dans Google Cloud Console, accédez à Trace :

    Accéder à Stackdriver Trace

  2. Pour afficher la liste des rapports quotidiens générés par le système et des rapports personnalisés disponibles, cliquez sur l'onglet Rapports d'analyse.

  3. Pour afficher un rapport, cliquez sur son nom.

Afficher par distribution de densité

Par défaut, le bouton Distribution de densité est activé. Avec ce paramètre, l'axe des abscisses correspond à la latence des traces sur une échelle logarithmique, tandis que l'axe des ordonnées correspond au pourcentage du nombre total de requêtes avec cette latence :

Rapport Cloud Trace avec latence affichée sous forme d'histogramme.

Lorsque vous créez un rapport de comparaison, Trace superpose les données des deux ensembles de données afin que vous puissiez les comparer et analyser les modifications :

Rapport de comparaison Cloud Trace avec latence affichée sous forme d'histogramme

Dans le rapport de comparaison, la légende du rapport identifie la période pour les graphiques orange et bleus. Ceux-ci ont été omis sur la capture d'écran.

Afficher par distribution cumulative

Pour afficher le nombre total de requêtes dont la latence est inférieure ou égale à la valeur de latence sur l'axe des abscisses, cliquez sur Distribution cumulée :

Rapport Cloud Trace avec latence affichée sous forme de distribution cumulée.

Volet Latence

Le volet Latence figurant sous la vue graphique affiche les centiles de latence et inclut des liens vers les traces pour des requêtes d'échantillon représentatif. Lorsque vous cliquez sur un numéro de trace, une fenêtre Détails de la trace s'ouvre et affiche des informations détaillées sur le délai racine. Pour en savoir plus, consultez la vue des détails des traces.

L'image suivante montre un volet de latence pour un rapport d'analyse. Dans ce cas, un seul ensemble de données est indiqué par la lettre A :

Volet de latence Cloud Trace.

Lorsque vous créez un rapport de comparaison, le volet de données de latence contient des informations pour les deux ensembles de données. La légende du volet identifie les entrées appartenant à chacun des ensembles de données.

Volet Goulots d'étranglement

Un Goulot d'étranglement indique que la valeur de latence d'un délai dans une trace spécifique se situe en dehors de la plage de valeurs de latence attendue. Cloud Trace détermine la plage de valeurs de latence attendue à l'aide de techniques statistiques basées sur le calcul et la comparaison de répartitions de latence empiriques pour des sous-ensembles de traces.

Le volet Goulots d'étranglement, lorsqu'il est présent, répertorie les appels RPC qui contribuent de manière significative à la latence dans les requêtes. Ce volet affiche les appels RPC par centile avec des requêtes d'échantillon représentatif. Vous pouvez cliquer sur un nombre sous Exemples de traces pour afficher les détails d'une trace spécifique.

L'image suivante montre un volet Goulots d'étranglement pour un rapport d'analyse. Dans ce cas, un seul ensemble de données est indiqué par la lettre A :

Volet des goulots d'étranglement des requêtes Cloud Trace.

Dans un rapport de comparaison, les goulots d'étranglement mettent en évidence les appels RPC ayant provoqué des changements de distribution de la latence entre les deux ensembles. La légende de ce volet identifie les entrées appartenant à chacun des ensembles de données.

Étape suivante