Créer des rapports personnalisés

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

Les rapports personnalisés vous permettent d'explorer des métriques d'API spécifiques et d'afficher les données exactes que vous souhaitez voir. Dans les tableaux de bord API Monitoring, vous pouvez créer un rapport personnalisé avec le filtre et les métriques prédéfinis en fonction des conditions configurées au moment de la création. De plus, un ensemble de dimensions et de métriques par défaut est configuré dans le rapport pour vous.

Créez un rapport personnalisé basé sur votre contexte

Créez rapidement des rapports personnalisés en fonction de votre contexte, comme résumé dans le tableau suivant. Sur la page Rapports personnalisés, les rapports personnalisés créés à l'aide de l'API Monitoring sont nommés de manière unique (par défaut), comme indiqué dans le tableau. Vous pouvez modifier ce nom lorsque vous modifiez le rapport personnalisé.

Contexte du rapport personnalisé Convention d'attribution de noms par défaut pour les rapports personnalisés
Tableau de bord récent API Monitoring Recent Generated
Tableau de bord de la chronologie API Monitoring Timeline Generated
Examiner le tableau de bord API Monitoring Investigate Generated
Condition d'alerte API Monitoring Generated: alert-name

Dimension et métriques par défaut

Le rapport personnalisé inclura par défaut les dimensions et les métriques répertoriées dans le tableau suivant pour tous les rapports générés par API Monitoring.

Composant Valeurs par défaut
Dimensions URI de la requête
Métriques
  • Temps de réponse total
  • Temps de réponse cible
  • Erreurs de proxy
  • Erreurs de cible

Modifier le rapport personnalisé

Comme indiqué dans la section précédente, un ensemble prédéfini de dimensions et métriques par défaut d'API Monitoring est préconfiguré dans des rapports personnalisés. Une fois le rapport personnalisé créé, vous pouvez le modifier pour ajouter ou supprimer des métriques et des dimensions, si nécessaire. Par exemple, vous pouvez limiter votre enquête à un jeton d'accès, une application de développeur, un proxy d'API ou un ID de requête en particulier.

Dans le rapport personnalisé suivant, vous ajoutez la dimension Gateway Flow ID prédéfinie, où Gateway Flow ID contient l'UUID unique de chaque requête API envoyée à Edge. Notez que le rapport utilise déjà la dimension Request URI:

L'exemple suivant ajoute la dimension Client ID au rapport personnalisé. La dimension Client ID contient la clé client (clé API) du développeur effectuant l'appel d'API, qu'elle soit transmise dans la requête en tant que clé API ou incluse dans un jeton OAuth:

Le rapport personnalisé contient des informations sur toutes les valeurs Client ID. L'exemple suivant ajoute un filtre afin que vous puissiez créer un rapport personnalisé pour un Client ID spécifique:

Pour plus d'informations sur toutes les dimensions et métriques prédéfinies que vous pouvez ajouter à un rapport, consultez Référence des métriques, dimensions et filtres Analytics.

Dans l'exemple suivant, vous ajoutez un filtre à un rapport personnalisé qui capture les mesures et les dimensions par défaut pour le code d'erreur policies.ratelimit.QuotaViolation et les codes d'état 5xx:

Pour plus d'informations sur la modification d'un rapport personnalisé, voir Gérer les rapports personnalisés.

Exemple: Diagnostiquer des problèmes de déploiement à l'aide de rapports personnalisés

Associez la stratégie StatisticsCollector à vos proxys d'API pour collecter des données d'analyse personnalisées, telles que l'ID utilisateur ou produit, le prix, l'action REST, la version cible, l'URL cible et la longueur du message. Les données peuvent provenir de variables de flux prédéfinies par Apigee, d'en-têtes de requête, de paramètres de requête ou de variables personnalisées que vous définissez.

Par exemple, les requêtes adressées à votre proxy d'API incluent des en-têtes pour l'ID produit, l'ID utilisateur et la version du serveur cible. Cette demande peut se présenter sous le format suivant:

curl -H "prodid:123456" -H "userid:98765" -H "targetversion:beta" http://myapi.com/myapi

Vous pouvez ensuite utiliser les informations des en-têtes pour faciliter le diagnostic des problèmes d'exécution avec votre proxy d'API.

Pour créer un rapport personnalisé pour ces en-têtes:

  1. Ajoutez la stratégie StatisticsCollector à votre API pour capturer la valeur des en-têtes personnalisés:

    <StatisticsCollector name="publishPurchaseDetails">
      <Statistics>
        <Statistic name="prodid" ref="request.header.prodid" type="integer">0</Statistic>
        <Statistic name="userid" ref="request.header.userid" type="integer">0</Statistic>
        <Statistic name="targetversion" ref="request.header.targetversion" type="string">alpha</Statistic>
      </Statistics>
    </StatisticsCollector>
    
  2. Déployez votre proxy et attendez qu'il soit accessible.

  3. Cliquez sur Analyser > Surveillance des API > Récent dans l'interface utilisateur Edge pour afficher les problèmes liés à votre API. Notez que vous obtenez des erreurs 4xx et 5xx pour le proxy myapi:

  4. Sélectionnez la ligne du proxy myapi pour afficher plus de détails dans le volet de droite du tableau de bord récent.

  5. Dans le volet de droite du tableau de bord Récent, sélectionnez Menu Plus > Afficher dans Enquêter pour accéder au tableau de bord Enquêter:

  6. Filtrez le tableau de bord Investigate par le proxy myapi, puis affichez le Code d'état dans le graphique supérieur. Notez que vous obtenez des erreurs 403 et 501:

  7. Dans l'interface utilisateur Edge, sélectionnez Analytics > Rapports personnalisés > Rapports pour créer un rapport personnalisé qui inclut les valeurs de ces mesures personnalisées en tant que dimension.

  8. Sélectionnez + Rapport personnalisé pour créer un rapport personnalisé nommé myapi_errors.

  9. Sélectionnez Proxy Errors (Erreurs proxy) pour "Metric" (Métrique), puis définissez la valeur Aggregate Function (Fonction d'agrégation) sur Sum. Vous pouvez ajouter d'autres métriques si vous le souhaitez.

  10. Sélectionnez la dimension prédéfinie Code d'état de la réponse, puis ajoutez les trois statistiques personnalisées prodid, targetersion et userid dans "Dimensions" :

  11. Définissez le filtre pour n'inclure que les données du proxy d'API myapi (apiproxy eq 'myapi'):

  12. Enregistrez le rapport.

  13. Générez le rapport pour les dernières 24 heures. Lorsque le rapport s'ouvre pour la première fois, un graphique comportant les erreurs HTTP 403 et 501 s'affiche:

  14. Sous Récapitulatif, cliquez sur 403 ou 510 pour voir quel produit génère les erreurs. Par exemple, vous sélectionnez 403:

  15. Cliquez sur un ID produit sous Récapitulatif pour afficher les erreurs par version cible (alpha ou bêta):

  16. Cliquez sur une version cible sous Récapitulatif pour afficher les erreurs par utilisateur: