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 différents cas d'utilisation. Ce document fournit un bref aperçu de l'objectif de chaque outil et de son utilisation recommandée, comme décrit dans les sections suivantes:
Surveillance des API
L'objectif des fonctionnalités de 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 de vos proxys d'API toutes les minutes, ce qui vous permet de surveiller de près l'état et les performances de vos API. Vous pouvez utiliser la surveillance des API pour configurer des alertes quasi en temps réel sur des paramètres spécifiés et exploiter les données agrégées pour résoudre les problèmes.
API Monitoring vous permet d'effectuer les opérations suivantes:
- Maintenir la disponibilité de vos API.
- Répondre aux alertes avant que les consommateurs ne soient affectés.
- Utiliser les codes d'erreur Apigee pour accélérer le diagnostic des problèmes.
- Isoler rapidement les zones à problèmes 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 lorsque vous utilisez la surveillance des API
Comme la surveillance des API est conçue pour être évolutive, elle n'enregistre pas chaque mesure de latence individuelle dans chaque transaction. À la place, les buckets de distribution sont utilisés pour mesurer les latences. Les buckets de latence utilisent des plages prédéfinies pour regrouper les valeurs de latence observées.
Pour en savoir plus sur l'utilisation d'API Monitoring pour vos API, consultez la section Présentation d'API Monitoring.
Pour en savoir plus sur l'utilisation de la surveillance avec Apigee pour configurer des alertes, consultez la section 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 vos API répondent aux exigences de votre entreprise, et les modifier si nécessaire.
Avec Apigee API Analytics, vous pouvez choisir parmi environ 50 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 au fil du temps.
Les données analytiques collectées sont stockées dans BigQuery. Vous pouvez utiliser l'API Analytics d'Apigee pour créer des rapports personnalisés dans Looker Studio, configurer des tâches de création de rapports personnalisés asynchrones ou exporter des données d'analyse vers votre propre Google Cloud dépôt de stockage, comme BigQuery.Si vous commencez avec un tarif à l'utilisation, l'API Analytics est un module complémentaire facultatif.
Voici quelques-unes des tendances que vous pouvez identifier à l'aide d'Apigee 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 votre API est-il le plus rapide ou le plus lent ?
- Quelles régions géographiques enregistrent le plus de trafic d'API ?
Données de latence lors de l'utilisation d'Apigee API Analytics
La latence observée dans l'API Analytics d'Apigee utilise une fonction d'agrégation quantile approximative sur les enregistrements individuels stockés dans BigQuery. Les données obtenues concernant la latence sont ainsi plus précises que la logique de bucketing utilisée dans l'API Monitoring. La latence dans la surveillance des API et dans l'analyse des API Apigee est mesurée à partir de l'environnement d'exécution Apigee et n'inclut pas les calculs de latence des sauts réseau précédents, y compris Istio.
Pour en savoir plus sur Apigee API Analytics, consultez la page 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 à la passerelle d'entrée d'Apigee. Vous pouvez ainsi filtrer les journaux en fonction de codes HTTP spécifiques et résoudre facilement les cas particuliers, tels qu'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 la section 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 de l'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 affichées par les fonctions de surveillance des API.
Conservation des données
Apigee API Analytics conserve les données pendant une période plus longue que les fonctions de 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 les fonctions de surveillance des API sont les suivantes :
Analytics
- Standard : 60 jours
- Enterprise : 90 jours
- Enterprise + : 14 mois
Surveillance des API: 1 mois