Cette page s'applique à Apigee et à Apigee hybrid.
Consultez la documentation d'Apigee Edge.
La surveillance des API Apigee, Apigee API Analytics et les journaux d'accès Apigee sont trois outils puissants que vous pouvez utiliser pour collecter, observer et comprendre vos données d'utilisation des API. Chacun de ces outils fournit des insights différents et est recommandé pour des cas d'utilisation spécifiques. Dans ce document, nous présentons brièvement l'objectif de chaque outil et son utilisation recommandée, comme décrit dans les sections suivantes :
Surveillance des API
L'objectif de la surveillance des API est de fournir des insights en temps réel sur les performances des API, afin que vous puissiez diagnostiquer et résoudre rapidement les problèmes pour que vos API fonctionnent comme prévu.
La surveillance des API vous fournit des données agrégées provenant de vos proxys d'API à la minute près, ce qui vous permet de surveiller rigoureusement l'état et les performances de vos API. Vous pouvez utiliser la surveillance des API pour configurer des alertes en temps quasi réel sur des paramètres spécifiques, afin d'exploiter les données agrégées en cas de dépannage.
La surveillance des API vous permet d'effectuer les opérations suivantes :
- Maintenir la disponibilité de vos API
- Prendre des mesures en fonction des alertes avant que les services consommateurs ne soient affectés
- Utiliser les codes d'erreur Apigee pour accélérer le diagnostic des problèmes
- Isoler rapidement les zones présentant des perturbations pour diagnostiquer la source des problèmes de performances et de latence
Les clients Apigee peuvent également utiliser les outils de Cloud Monitoring pour prendre en charge la surveillance des API. Si vous souhaitez intégrer votre infrastructure à d'autres systèmes de surveillance, nous vous recommandons d'utiliser l'API Monitoring pour extraire des métriques.
Données de latence lors de l'utilisation de la surveillance des API
Comme la surveillance des API est intentionnellement conçue pour évoluer, elle n'enregistre pas toutes les mesures de latence individuelles dans chaque transaction. Au lieu de cela, des buckets de distribution sont utilisés pour mesurer les latences. Ils utilisent des plages prédéfinies pour regrouper les valeurs de latence observées.
Pour en savoir plus sur l'utilisation de la surveillance des API pour vos API, consultez la présentation de la surveillance des API.
Pour en savoir plus sur l'utilisation de Monitoring avec Apigee dans l'optique de configurer des alertes, consultez Configurer des alertes et des notifications.
Apigee API Analytics
Apigee API Analytics fournit une analyse des tendances historiques et des rapports détaillés sur les métadonnées des appels d'API. L'objectif d'Apigee Analytics est de vous aider à comprendre les tendances à long terme du trafic de vos API, afin de vérifier que celles-ci répondent aux exigences de votre entreprise, et les modifier si nécessaire.
Avec Apigee API Analytics, vous pouvez choisir parmi une cinquantaine de dimensions disponibles qui spécifient les données que vous souhaitez capturer pour chaque appel d'API géré par un proxy. Vous pouvez ensuite créer des rapports personnalisés pour déterminer l'évolution des métriques d'API dans le temps.
Les données analytiques collectées sont stockées dans BigQuery. Vous pouvez utiliser Apigee API Analytics pour créer des rapports personnalisés dans Looker Studio, configurer des jobs de rapports personnalisés asynchrones ou exporter des données analytiques vers votre propre dépôt de stockage Google Cloud , comme BigQuery. Si vous optez pour le paiement à l'usage en premier lieu, API Analytics est proposé comme module complémentaire facultatif.
Voici quelques-unes des tendances que vous pouvez identifier à l'aide d'Apigee API Analytics :
- Quelles tendances le trafic de votre API affiche-t-il sur la durée ?
- Quelles sont vos applications les plus utilisées ?
- Quels sont les développeurs les plus efficaces ?
- Quand le temps de réponse de l'API est-il le plus rapide ou le plus lent ?
- Quelles régions géographiques génèrent le plus de trafic d'API ?
Données de latence lorsque vous utilisez Apigee API Analytics
La latence observée dans Apigee API Analytics utilise une fonction d'agrégation quantile approximative sur les enregistrements individuels stockés dans BigQuery. Les données de latence obtenues sont ainsi plus précises que celles obtenues avec la logique de binning utilisée dans la surveillance des API. La latence dans la surveillance des API et Apigee API Analytics est mesurée à partir de l'environnement d'exécution Apigee et n'inclut pas les calculs de latence des sauts de réseau précédents, y compris Istio.
Pour en savoir plus sur Apigee API Analytics, consultez Présentation d'Apigee API Analytics.
Journaux d'accès Apigee
Les journaux d'accès Apigee peuvent être utilisés pour résoudre les problèmes liés aux appels d'API vers Apigee et identifier les API qui renvoient des codes de réponse HTTP spécifiques.
Les journaux d'accès Apigee enregistrent les journaux par transaction au niveau de la passerelle d'entrée vers Apigee. Cela vous permet de filtrer les journaux en fonction de codes HTTP spécifiques et de résoudre facilement les cas particuliers, comme un code d'état de réponse 0 sur Istio.
Pour en savoir plus sur l'utilisation des journaux d'accès Apigee pour résoudre les problèmes liés à vos API, consultez Journaux d'accès Apigee.
Différences entre les données affichées par les fonctions de surveillance des API et par Analytics
La surveillance des API et Apigee API Analytics utilisent des pipelines différents pour accéder aux données d'API. Par conséquent, vous pouvez constater des écarts entre les données affichées par les tableaux de bord Apigee API Analytics et celles disponibles dans la surveillance des API.
Rapidité et précision
En général, les données affichées par Apigee API Analytics sont plus précises, mais peuvent être légèrement moins récentes (moins d'une heure d'écart) que celles proposées par la surveillance des API.
Conservation des données
Apigee API Analytics conserve les données plus longtemps que la surveillance des API, ce qui le rend plus adapté à l'analyse des tendances à long terme.
Les durées de conservation des données pour Analytics et pour la surveillance des API sont les suivantes :
Analytics
- Standard : 60 jours
- Enterprise : 90 jours
- Enterprise + : 14 mois
Surveillance des API : 1 mois