Apigee hybrid permet de mettre à votre disposition les données de débogage, d'analyse et d'état du déploiement. Ces données sont collectées par un pod de collecte des données qui les envoie au plan de gestion afin que vous puissiez les afficher et les analyser, et configurer la surveillance ainsi que les alertes.
À propos des données
Tous les services de processeur de messages (MP) dans un environnement hybride diffusent des données de débogage (lors du démarrage), d'analyses et d'état de déploiement via TCP vers un pod de collecte de données du cluster. Le pod de collecte de données stocke les données diffusées sur le système de fichiers du pod via un service fluentd.
L'agent UDCA (agent de collecte de données universel) extrait régulièrement les données stockées et les envoie au service UAP (Unified Analytics Platform) du plan de gestion. La plate-forme UAP traite les données entrantes d'analyse et d'état de déploiement et les met à votre disposition via l'interface utilisateur hybride ou les API Apigee.
Apigee hybrid met en œuvre le pod de collecte de données en tant qu'objet ReplicaSet avec au moins deux instances dupliquées.
L'image suivante montre le processus de collecte de données de débogage, d'analyse et d'état du déploiement :
Notez que les données de débogage, d'analyse et d'état du déploiement ne sont pas stockées au même emplacement et ne sont pas accessibles de la même manière que les données de journalisation et de métriques :
- Les données de journalisation et de métriques sont stockées sur votre projet GCP et accessibles via un outil tel que Stackdriver ou ce que vous choisissez d'utiliser.
- Les données de débogage, d'analyse et d'état du déploiement, en revanche, sont stockées dans le plan de gestion hybride et vous y accédez via des services Apigee tels que l'interface utilisateur hybride ou les API Apigee.
Le tableau suivant récapitule les données recueillies par le pod de collecte de données :
Type de données | Nom de l'ensemble de données | Description | Fréquence de mise à jour | API |
---|---|---|---|---|
Analyse | api |
Données d'utilisation de l'API, y compris les transactions par seconde, l'utilisation du cache, les erreurs, les latences, les tailles de requêtes/réponses et le comptage du trafic. Pour plus d'informations, consultez la page Présentation d'Apigee Analytics. |
Délai jusqu'à 30 secondes | API Analytics Admin |
État du déploiement | event |
État du déploiement actuel du proxy API. Pour plus d'informations sur l'affichage de ces informations, consultez la section Afficher l'état du déploiement. |
Immédiatement | API Deployments |
Debug | debug |
Débogage des données de session pour les proxys d'API. Ces données incluent les paramètres de requête/réponse, ainsi que les transformations qui leur sont appliquées au moment de l'exécution de la règle. En raison de leur taille, les données de débogage, contrairement aux données d'analyse et d'état de déploiement, ne sont pas collectées en permanence. En revanche, les données de débogage sont collectées lorsque vous lancez une session de débogage. Pour en savoir plus, consultez Présentation de l'outil Debug. |
Immédiatement | API Debug session API Debug session data |
Afficher les données dans l'interface utilisateur hybride
Cette section explique comment afficher les données de débogage, d'analyse et d'état du déploiement dans l'interface utilisateur hybride d'Apigee.
Debug
Les données de débogage pour les services hybrides sont accessibles de la même manière que les données de débogage Edge, avec certaines différences, telles qu'une meilleure compatibilité avec les filtres. Pour en savoir plus, consultez Présentation de l'outil Debug.
Analyse
Les données d'analyse pour les services hybrides sont accessibles de la même manière que les données d'analyse Edge. Pour plus d'informations, consultez la page Utiliser des tableaux de bord analytiques dans la documentation Edge.
État du déploiement du proxy
Pour en savoir plus sur l'affichage de l'état du déploiement, consultez la page Afficher l'état du déploiement.
Configurer la collecte de données
Pour définir comment et où les données de débogage, d'analyse et d'état du déploiement sont collectées sur le pod de collecte de données, configurez le service UDCA via ses propriétés de configuration. Les propriétés UDCA incluent des propriétés générales pour le service UDCA, ainsi que des propriétés spécifiques à chaque ensemble de données.
Pour configurer l'UDCA :
- Ouvrez le fichier
overrides.yaml
pour le modifier sur votre ordinateur d'administration Kubernetes, comme décrit dans la section Gérer les composants du plan d'exécution. - Définissez les valeurs des paramètres de configuration UDCA. Pour les propriétés UDCA, vous pouvez définir des valeurs personnalisées, telles que :
- Intervalle d'interrogation
- Nombre d'instances dupliquées (min et max)
- Pourcentage de processeurs cibles (qui déclenche des instances dupliquées supplémentaires)
Pour obtenir la liste complète des propriétés UDCA que vous pouvez personnaliser, consultez la page
udca
. - Enregistrez vos modifications dans le fichier overrides.yaml.
- Appliquez les modifications à votre cluster en exécutant la commande
apigeectl apply
, comme illustré dans l'exemple suivant :apigeectl apply -f my-overrides.yaml -c udca
Pour plus d'informations sur la commande
apply
, consultez la section Appliquer le modèle hybride à votre cluster.