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 plus de détails sur l'affichage du rapport d'analyse quotidien, voir Affichez 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 console Google Cloud, accédez à la page Rapports d'analyse:
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Trace
Cliquez sur Nouveau rapport.
Saisissez ou sélectionnez les paramètres suivants dans le formulaire qui s'affiche :
Request filter: l'URI complet, le préfixe d'URI ou termes du filtre de trace.
Par exemple, si le délai racine d'un projet estRecv, 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é deRecv/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 inclut Uniquement les traces comportant un segment avec la clé d'attribut/http/status_codeet les valeurs d'attribut précédées de5.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) pour gérer cette 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.
(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 console Google Cloud, accédez à la page Rapports d'analyse :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est 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 console Google Cloud, accédez à la page Rapports d'analyse :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est 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 des requêtes d'échantillon représentatif. 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 trace, 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 la section Rechercher et explorer des traces.
L'image suivante montre un volet de latence pour un rapport d'analyse. Dans ce
il n'y a qu'un seul ensemble de données, qui est indiqué 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 "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, il n'y a qu'un seul ensemble de données, qui est indiqué 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.