Collecte des données de débogage, d'analyse et d'état du déploiement

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 :

Schéma illustrant l'architecture du flux de données commençant par le processeur de messages, stocké par UDCP et traité par une API Apigee ou l'interface utilisateur hybride Apigee.

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 Google Cloud et accessibles via un outil tel que Cloud Operations 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 :

  1. 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.
  2. 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.

  3. Enregistrez vos modifications dans le fichier overrides.yaml.
  4. Appliquez les modifications à votre cluster en exécutant la commande apigeectl apply, comme illustré dans l'exemple suivant :
    apigeectl apply -f my-overrides.yaml --org --env env-name

    Pour plus d'informations sur la commande apply, consultez la section Appliquer la configuration du cluster.