Analysez les problèmes

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

Le tableau de bord Enquêter vous permet d'afficher des tableaux croisés dynamiques des métriques et des attributs pour l'ensemble du trafic des API, et de comparer l'activité relationnelle entre les métriques afin d'examiner et de diagnostiquer les problèmes plus rapidement. Vous pouvez accéder aux données des 30 derniers jours dans le tableau de bord.

Sélectionnez Analyser > Surveillance des API > Enquêter dans l'interface utilisateur Edge pour ouvrir le tableau de bord Investivate. Le tableau de bord comporte deux zones principales:

• Code d'état vous permet d'examiner les métriques de code d'état pour les proxys d'API et les services cibles.
• La latence vous permet d'examiner les problèmes de latence des proxys d'API et des services cibles.

Vous pouvez également examiner les problèmes causés par une alerte spécifique dans le tableau de bord Examen. Lorsqu'une alerte se produit, cliquez sur son nom dans la page Historique des alertes pour l'ouvrir dans le tableau de bord d'investigation.

Utiliser le tableau de bord "Examen" pour diagnostiquer un problème

Par exemple, vous recevez une alerte qui indique que le taux d'erreur 5xx dépasse le seuil spécifié. Pour examiner ce problème, vous pouvez effectuer les tâches suivantes sur le tableau de bord Investigate:

1. Affichez la matrice de code d'erreur par rapport au temps pour afficher l'activité du code d'erreur au cours de la dernière heure.
2. Basculez sur la matrice de codes d'erreur par rapport à l'état HTTP pour identifier des codes d'état HTTP spécifiques associés aux codes d'erreur dont les décomptes ont augmenté au cours de la dernière heure, comme indiqué à l'étape précédente.
3. Basculez vers la matrice code d'erreur par rapport au proxy pour identifier les proxys d'API qui déclenchent les codes d'erreur identifiés à l'étape précédente.
4. Cliquez sur une case de la matrice associée à un proxy d'API avec un grand nombre de codes d'erreur pour afficher plus de détails et de journaux d'accès.
5. Configurez une alerte et créez un rapport personnalisé pour vous aider à diagnostiquer le problème.

6. Poursuivez le troubleshoot du proxy d"API à l'aide du traçage et d'autres outils pour identifier une solution au problème.

Utiliser le tableau de bord "Code d'état"

Le tableau de bord Code d'état vous permet d'examiner les métriques de code d'état pour les proxys d'API et les services cibles de votre organisation. Vous pouvez afficher les métriques du code d'état pour une fenêtre d'une heure ou de quatre heures à tout moment au cours des 30 derniers jours.

Explorer le tableau de bord "Code d'état"

Pour afficher le tableau de bord Code d'état, sélectionnez Analyze > API Monitoring > Investigate (Analyser > Surveillance des API > Examiner) dans l'interface utilisateur Edge. Le tableau de bord du code d'état affiche par défaut:

Comme le montre l'image, le tableau de bord Examen vous permet de:

• Configurer chaque matrice en définissant ses axes x et y pour comparer l'activité relationnelle entre les métriques et obtenir davantage d'insights.
• Identifiez rapidement les métriques qui rencontrent les volumes relatifs les plus élevés en fonction de l'ombrage des couleurs d'un bloc. Plus le bloc est sombre, plus le volume relatif est élevé.
• Cliquez sur un bloc dans la matrice pour afficher les détails de métrique.
• Filtrez les données en fonction des éléments suivants :
  • Environment
  • Région
  • Proxy
  • Codes d'état (y compris tout le trafic, toutes les erreurs, 2xx, 4xx ou 5xx)
  • Date et heure dans les 30 derniers jours
  • Fenêtre de 1 heure ou 4 heures

Le tableau de bord vous permet d'effectuer rapidement les tâches suivantes:

• Accédez aux journaux dans le panneau de détails de métrique.
• Affichez le contexte actuel dans le tableau de bord Recent ou Timeline en cliquant sur > View in Recent ou View in Timeline, respectivement.
• Créez un rapport personnalisé et ajoutez des dimensions supplémentaires en cliquant sur .
• Créez une alerte et ajoutez des conditions d'alerte supplémentaires, configurez des notifications et générez un rapport personnalisé en fonction de l'alerte.

Configurer la matrice de "Code d'état"

Lorsque vous sélectionnez le tableau de bord Code de statut, les matrices suivantes apparaissent par défaut:

• Code d'erreur par rapport au temps
• Code d'erreur par rapport au statut HTTP
• Source d'erreur par rapport au proxy d'API

Configurez chaque matrice pour comparer deux des mesures suivantes en sélectionnant une valeur pour les listes déroulantes x- et x- :

• Code d'erreur
• Règle d'erreur
• Source d'erreur
• État HTTP
• Proxy
• Heure
• Région
• Target (service cible ou règle ServiceCallout). Si la cible est une règle ServiceCallout, la valeur affichée est précédée de sc://. Exemple : sc://my.endpoint.net.)

Afficher les détails des métriques de "Code d'état"

Affichez les détails d'une métrique spécifique en cliquant sur son bloc dans la matrice.

Les détails relatifs à la cause suspectée s'affichent dans le volet de droite, tels que :

• Environnement
• Organisation
• Région
• Source d'erreur (infrastructure proxy, cible ou Apigee)

Ces informations peuvent également inclure les éléments suivants:

• Règle d'erreur - Informations sur la règle qui a déclenché l'erreur d'exécution, y compris le type de règle (nom interne) et le nom de la règle définie par l'utilisateur. Vous définissez le nom lorsque vous associez la règle au flux de proxy d'API.
• Nom du proxy
• Code d'état HTTP
• Code d'erreur

Si la cardinalité est supérieure à 1 pour une métrique spécifique, le panneau de détails peut inclure des détails de distribution d'erreurs, tels que "Distribution par application de développeur", "Distribution par règle d'erreur", "Distribution par code d'erreur", "Distribution par état HTTP", etc. Exemple :

Si la source d'erreur est la cible, le panneau de détails inclura le taux d'erreur par cible. Exemple :

Utiliser le tableau de bord "Latence"

Le tableau de bord de latence affiche des informations de latence pour les proxys d'API et les services cibles de votre organisation. Vous pouvez examiner les métriques de latence pour une période d'une heure à tout moment au cours des 30 derniers jours.

Explorer le tableau de bord "Latence"

Pour afficher le tableau de bord Latence, sélectionnez Analyze > API Monitoring > Investigate (Analyser > Surveillance des API > Examiner) dans l'interface utilisateur Edge. Le tableau de bord du code d'état s'affiche par défaut. Sélectionnez Latence dans la zone de filtre pour afficher le tableau de bord Latence :

Lorsque vous sélectionnez le tableau de bord Latence, les matrices suivantes apparaissent par défaut:

• Proxy vs Time (latence maximale en millisecondes)
• Proxy vs latence totale (latence maximale en millisecondes)
• Proxy vs latence de toutes les cibles (latence maximale en millisecondes)

Utilisez la liste déroulante Proxy pour sélectionner Cible et afficher les latences cibles.

Par défaut, le tableau de bord Latence affiche des informations sur les 10 proxys ayant la latence totale P99 la plus élevée de l'heure précédente. Vous pouvez également utiliser la boîte déroulante Top 10 pour sélectionner un proxy ou une collection spécifique.

Le tableau de bord Latence présente toutes les fonctionnalités du tableau de bord Code d'état, à l'exception des différences suivantes:

• Vous configurez uniquement le centile de latence de réponse totale (p50, p90, p95, p99).
• Vous ne pouvez sélectionner qu'une période d'une heure pour les métriques de latence.
• Vous ne pouvez pas sélectionner N'importe quelle pour Région dans les filtres. Vous devez sélectionner une région spécifique à afficher.

Afficher les détails des métriques de Latence

Affichez les détails d'une métrique spécifique en cliquant sur son bloc dans la matrice.

Les détails relatifs à la latence d'un proxy (ligne bleue) et d'une cible (ligne violette) s'affichent dans le volet de droite, tels que :

• Latence totale (latence du proxy plus la latence cible)
• Latence par cible (temps de réponse cible)
• Distribution par état HTTP

Pointez sur le graphique pour afficher des informations détaillées:

Le graphique Latence par cible affiche les 16 cibles principales en fonction de la latence maximale, avec un graphique par cible. Passez la souris sur un graphique ou sélectionnez la liste déroulante pour déterminer le graphique correspondant à chaque cible.

Afficher les journaux à partir des détails des métriques

Lorsque vous affichez les détails de la métrique pour les codes d'état ou la latence, cliquez sur Afficher les journaux pour afficher tous les journaux de la métrique sélectionnée:

La boîte de dialogue "Journaux de trafic" s'ouvre et affiche un maximum de 1 000 entrées de journal. Cliquez sur une entrée de journal pour développer ses détails dans la liste:

Vous pouvez filtrer davantage les journaux selon les critères suivants:

• Source de trafic
• Type d'erreur
• Temps de réponse minimal

Vous ne pouvez pas télécharger les données des journaux à partir de la boîte de dialogue "Journaux de trafic". Cependant, vous pouvez créer un rapport personnalisé ou télécharger les données d'analyse dans votre propre dépôt de données, tel que Google Cloud Storage ou BigQuery, pour effectuer votre propre analyse de données.

Créer un rapport personnalisé à partir du tableau de bord "Examen"

Créez un rapport personnalisé basé sur l'ensemble de conditions sélectionné. Vous pouvez modifier le rapport personnalisé après sa création pour ajouter ou supprimer des métriques et des dimensions, selon vos besoins. Par exemple, vous pouvez limiter votre recherche à un jeton d'accès, une application de développeur ou un proxy d'API particulier. Pour plus d'informations, voir Métriques, dimensions et filtres Analytics.

Pour plus d'informations, voir Créer des rapports personnalisés.

Pour créer un rapport personnalisé, procédez comme suit :

1. Cliquez sur un bloc de la matrice pour afficher plus de détails.

   

2. Dans le volet de droite, cliquez sur .

   

   La page du rapport personnalisé s'affiche dans un nouvel onglet avec les champs pertinents pré-remplis.

   Remarque: Consultez Créer des rapports personnalisés pour plus d'informations sur les paramètres de rapport personnalisé par défaut.

   

3. Modifiez le rapport personnalisé, si nécessaire. Voir Gérer des rapports personnalisés.

4. Cliquez sur Enregistrer pour enregistrer le rapport personnalisé.

Par défaut, le rapport est exécuté à l'aide des données collectées au cours de la dernière heure et les données sont affichées dans le tableau de bord du rapport personnalisé. Consultez la section Explorer le tableau de bord des rapports personnalisés.

Sur la page Rapports, les rapports personnalisés générés à l'aide de la surveillance des API sont nommés selon le format suivant: API Monitoring Investigate Generated.

Examiner une alerte spécifique

Pour étudier une alerte spécifique, sélectionnez le nom de l'alerte sur la page Historique des alertes. Le tableau de bord d'investigation s'affiche. Notez qu'il contient un graphique en haut du tableau de bord et n'inclut que des informations spécifiques à l'alerte:

• Affichez les détails du trafic de l'API au moment du déclenchement de l'alerte.
• Affichez des informations contextuelles sur l'alerte, y compris l'heure à laquelle elle a été déclenchée, au centre du graphique.
• Cliquez sur Détails de la condition pour afficher les détails de la condition d'alerte dans une fenêtre pop-up.

• Cliquez sur Playbook (le cas échéant) pour afficher le guide de l'alerte:

  

• Cliquez sur Gérer l'alerte pour modifier l'alerte.

• Cliquez sur Afficher le rapport (si disponible) pour consulter un rapport personnalisé.

• Activez ou désactivez l'actualisation automatique de la page, si nécessaire.