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.
Pour savoir comment afficher le rapport d'analyse quotidien, consultez 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 :
-
Dans la barre de recherche de la console Google Cloud, saisissez Rapports d'analyse. Dans les résultats de recherche, accédez à la section Produits et pages, puis sélectionnez la page Rapports d'analyse pour Trace:
Cliquez sur Nouveau rapport.
Saisissez ou sélectionnez les paramètres suivants dans le formulaire qui s'affiche :
Request filter: URI complet, préfixe de l'URI ou termes du filtre de trace.
Par exemple, lorsqu'un délai racine du projet estRecv, saisissez le nom du délai racine (Recv) ou un préfixe de celui-ci pour inclure toutes les requêtes. Pour limiter le rapport aux traces avec un URI précédé deRecv/cart, saisissez ce préfixe dans le filtre.
Vous pouvez également filtrer les traces par attributs de segment. Par exemple, lorsque vous ajoutez/http/status_code:5, le rapport n'inclut que les traces qui ont un segment avec la clé d'attribut/http/status_codeet les valeurs d'attribut précédées de5.HTTP method: méthode HTTP de 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 Toutes.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) qui a traité la requête. La valeur par défaut est Toutes.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.
(Facultatif) Pour comparer deux ensembles de données de latence, sélectionnez Comparer à la référence et saisissez la période de comparaison.
Cliquez sur Envoyer.
Dupliquer un rapport
Dans Trace, vous pouvez dupliquer les paramètres de filtre d'un rapport existant :
-
Dans la barre de recherche de la console Google Cloud, saisissez Rapports d'analyse. Dans les résultats de recherche, accédez à la section Produits et pages, puis sélectionnez la page Rapports d'analyse pour Trace:
Cliquez sur le nom du rapport dont vous souhaitez dupliquer la structure.
Cliquez sur Créer un rapport similaire.
Sur la page Nouvelle demande de rapport, modifiez un ou plusieurs paramètres de rapport, y compris le nom du rapport.
Cliquez sur Envoyer.
Afficher un rapport
Pour afficher un rapport d'analyse, procédez comme suit :
-
Dans la barre de recherche de la console Google Cloud, saisissez Rapports d'analyse. Dans les résultats de recherche, accédez à la section Produits et pages, puis sélectionnez la page Rapports d'analyse pour Trace:
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 :
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 :
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 :
Comprendre le volet "Latence"
Le volet Latence affiche les centiles de latence et inclut des liens vers les traces pour les exemples de requêtes représentatifs. Pour afficher les détails d'une trace spécifique, sélectionnez l'un des quatre exemples de traces. Lorsque vous sélectionnez l'un des exemples de traces, la page Explorateur de traces s'ouvre et affiche des informations détaillées sur le délai racine de cette trace. Pour en savoir plus, consultez Rechercher et explorer des traces.
L'image suivante montre un volet de latence pour un rapport d'analyse. Dans ce cas, il n'existe qu'un seul ensemble de données, désigné par la lettre A:
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.
Comprendre le volet des 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 le volet Goulots d'étranglement pour un rapport d'analyse.
Dans ce cas, il n'existe qu'un seul ensemble de données, désigné par la lettre A:
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.