Surveillance d'Argo CD

Grâce au capteur Argo CD d' Instana, vous pouvez obtenir une visibilité sur les déploiements gérés par Argo CD et établir des corrélations entre les modifications de code et les métriques d'exécution afin de détecter et de résoudre rapidement les problèmes de performances des applications. Une fois l'agent « Instana » installé, le capteur s'installe automatiquement. Vous pouvez consulter les détails de synchronisation des applications déployées dans les clusters gérés par Argo CD via l'interface utilisateur d' Instana, une fois que vous avez activé et configuré le capteur comme indiqué dans les sections suivantes.

Remarque : À l'heure actuelle, Instana prend en charge les installations d'Argo CD au sein d'un même cluster pouvant gérer un ou plusieurs clusters d' Kubernetes. Vous pouvez surveiller plusieurs clusters grâce à des identifiants d'accès configurables et à une liste définie de clusters cibles.

Informations de support

Pour vous assurer que le capteur Argo CD est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Versions d'Argo CD prises en charge

Le capteur Argo CD est compatible avec les versions d'Argo CD disponibles sur 2.x et 3.x.

Prérequis

Avant d'activer le capteur Argo CD, procédez comme suit :

  1. Déployez l'agent « Instana » dans un ou plusieurs clusters d' Kubernetes. Pour plus d'informations, consultez la section « Installation de l'agent d' Instana » sur Kubernetes.
  2. Configurez Argo CD pour qu'il gère les mêmes clusters d' Kubernetes s que ceux que l'agent Instana est configuré pour surveiller. Pour plus d'informations, consultez la section Installation
    Figure 1. S'ouvre dans un nouvel onglet ou une nouvelle fenêtre
    Icône de lien externe
    .
  3. Veillez à utiliser le nom exact du cluster géré par Argo CD lorsque vous ajoutez ce dernier à Instana. Par défaut, Argo CD identifie le cluster comme in-kubernetes. Modifiez ce nom pour qu'il corresponde au nom réel du cluster afin de garantir une corrélation et une visibilité correctes des données dans l' Instana.

exigences d'accès

Le capteur Argo CD nécessite des identifiants permettant d'accéder en lecture à l' API Argo CD.

Pour respecter le principe du privilège minimal, procédez comme suit pour configurer les accès :

  1. Créez un utilisateur Argo CD dédié disposant d'un accès en lecture seule.
  2. Limitez l'accès de l'utilisateur aux seules applications et clusters que vous souhaitez surveiller.

Pour savoir comment créer un tel utilisateur et configurer le contrôle d'accès, consultez la documentation officielle d'Argo CD suivante :

Configuration du capteur Argo CD

Pour activer et configurer le capteur, modifiez le fichier de configuration de l'agent comme indiqué dans l'exemple suivant :

# Argo CD Sensor
com.instana.plugin.argocd:
  enabled: true
  poll_rate: 5 # Integer value in seconds. Default value is 5 seconds.
  url: 'https://argocd-server.argocd'
  username: 'admin'
  password: 'your-password'
  clusters: # List of one or more k8s cluster names.
    - 'demo-cluster1'
 

Le capteur récupère les données de synchronisation de l'application via les API REST d'Argo CD.

Paramètres de configuration

Le tableau suivant répertorie les paramètres de configuration et leur description :

Paramètre Description
enabled Valeur booléenne permettant d'activer ou de désactiver le capteur Argo CD.
poll_rate Valeur entière représentant la fréquence (en secondes) à laquelle le capteur interroge l' API Argo CD. La valeur par défaut est 5.
Important : indiquez cette valeur sans guillemets.
url Le serveur CD Argo URL, par exemple. http://argocd.demo.xyz
username Nom d'utilisateur utilisé pour s'authentifier auprès de l' API Argo CD.
password Mot de passe associé au nom d'utilisateur fourni.
clusters Liste des clusters surveillés par Argo CD. Ces clusters doivent être surveillés à la fois par l'agent Instana et par Argo CD.

Affichage des données

Une fois le capteur Argo CD activé, vous pouvez consulter les détails de synchronisation des applications déployées dans des clusters gérés par Argo CD directement depuis l'interface utilisateur d' Instana. Le capteur recueille et affiche des informations essentielles, telles que les listes d'applications, l'état de la synchronisation et les détails du référentiel d' Git.

Pour accéder à ces informations, procédez comme suit dans l'interface utilisateur d' Instana :

  1. Dans le menu de navigation, sélectionnez « Plateformes » > « Kubernetes ».

  2. Dans l'onglet Clusters, recherchez le cluster géré par Argo CD. Si le cluster est configuré pour la surveillance, un bouton indiquant l'état de synchronisation apparaît à côté du cluster géré par Argo CD, indiquant le nombre d'applications qui ne sont actuellement pas synchronisées. Le tableau de bord du cluster offre les mêmes fonctionnalités et comprend un historique des événements de synchronisation Argo CD, accompagné des indicateurs de performance correspondants.

    Figure 2. Kubernetes Tableau de bord - Nombre total d'applications déployées via Argo CD qui ne sont pas synchronisées
    Tableau de bord Kubernetes
    Figure 3 Tableau de bord des clusters Kubernetes
    Tableau de bord des clusters Kubernetes
  3. Cliquez sur le bouton « État de synchronisation du CD Argo » situé à côté d'un cluster surveillé. Une fenêtre Argo CD s'affiche, présentant la liste des applications gérées par Argo CD pour ce cluster.

    Figure 4 Kubernetes cluster - Fenêtre contextuelle affichant la liste des applications déployées via Argo CD
    Kubernetes cluster - Liste des applications

    Cette vue offre un aperçu rapide de l'état de déploiement de chaque application. Le tableau suivant répertorie les informations essentielles relatives à une application gérée par Argo CD :

    Zone Description
    Nom de l'application Argo CD Le nom de l'application tel qu'il est défini dans Argo CD.
    Statut de synchronisation Le statut indique si l'application est actuellement synchronisée avec son référentiel Git (par exemple, « Synchronisée », « Non synchronisée » ).
    Namespace L'espace de noms « Kubernetes » dans lequel l'application est déployée.
    Git dépôt et branche Le dépôt source Git et la branche associée à l'application.
    Dernière synchronisation Le temps écoulé depuis la dernière synchronisation réussie de l'application avec Argo CD.
  4. Pour résoudre les problèmes et examiner les détails du déploiement, utilisez les options suivantes dans la fenêtre Argo CD :

    • Pour découvrir plus en détail votre configuration Argo CD, cliquez sur « Lancer l'interface Argo CD ». Cela ouvre la page d'accueil de l'interface Web d'Argo CD dans un nouvel onglet du navigateur.
    • Pour consulter le référentiel « Git » des applications Argo CD, cliquez sur le nom de la branche dans la colonne « Référentiel et branche » du tableau des applications Argo CD. Vous pouvez rapidement consulter la configuration source et les modifications récentes associées à chaque application.

    Ces options simplifient le flux de travail en vous permettant d'accéder rapidement à la fois à l'outil de déploiement et à la configuration source de vos applications.

Affichage des données relatives aux déploiements d'Argo

Outre la surveillance de la synchronisation des applications Argo CD, Instana offre une surveillance complète des déploiements Argo Rollouts, vous permettant ainsi de suivre les stratégies de déploiement progressif, telles que les déploiements « canary » et « blue-green ».

Une fois le capteur Argo CD configuré, Instana collecte et affiche automatiquement les données Argo Rollouts dans l'interface utilisateur d' Instana.

Présentation générale du suivi des déploiements Argo

Argo Rollouts est un contrôleur « Kubernetes » qui propose des stratégies de déploiement avancées pour une mise en production progressive.

Argo Rollouts est un contrôleur de type « Kubernetes » qui propose des stratégies de déploiement avancées, telles que les déploiements «blue-green» et «canary», pour une mise en production progressive. Instana offre un suivi complet des déploiements Argo, vous permettant de disposer d'une visibilité en temps réel sur l'état, l'avancement et les indicateurs de performance des déploiements, afin de garantir des déploiements plus sûrs.

Capacités de surveillance

La surveillance complète des déploiements Argo dans « Instana » offre une visibilité sur l'état des déploiements, les stratégies de déploiement et les indicateurs de performance.

Grâce à la surveillance complète des déploiements Argo dans l' Instana, vous pouvez :

  • Suivre l'état et l'avancement des déploiements : consultez l'état de tous les déploiements actifs, notamment s'ils sont en bon état, en cours, suspendus ou en situation de dégradation.
  • Suivi des stratégies de déploiement : déterminer si un déploiement utilise une stratégie de type « canary » ou « blue-green ».
  • Surveiller la répartition du trafic : dans le cadre des déploiements « canary », surveillez la répartition du trafic et l'avancement des étapes (par exemple, « Étape 3 sur 7 » indique que le déploiement en est à la troisième étape sur les sept étapes configurées au total dans la stratégie de déploiement « canary »).
  • Corrélation avec les indicateurs de performance des applications (APM) : lorsque l'agent APM d' Instana est installé sur vos pods, les données de déploiement sont automatiquement corrélées avec l'APM, notamment :
    • Taux d'erreur et latence des services déployés via Argo Rollouts
    • Comparaison côte à côte des indicateurs entre les variantes « canary » et « stable » lors des déploiements actifs de la variante « canary »
    • Accès aux journaux et traces corrélés pour les services gérés par Argo Rollouts
    • Analyser en détail les performances au niveau des services afin d'identifier les problèmes liés aux nouveaux déploiements
  • Analyser l'état des répliques : suivre le nombre de répliques disponibles par rapport au nombre souhaité pour chaque déploiement.
  • Identifier les problèmes de déploiement : repérer rapidement les déploiements qui ont échoué ou qui rencontrent des difficultés, grâce à des comparaisons des taux d'erreur par rapport aux indicateurs de référence afin de détecter toute dégradation des performances.

Accéder aux informations sur les déploiements Argo

Vous pouvez consulter les informations relatives au déploiement via la vue de la plateforme « Kubernetes » dans l'interface utilisateur d' Instana.

Pour consulter les informations relatives au déploiement :

  1. Dans le menu de navigation, sélectionnez « Plateformes » > « Kubernetes ».
  2. Go vers le tableau de bord d'un cluster géré par Argo CD.
  3. Cliquez sur l'onglet « Argo Rollouts » pour afficher tous les déploiements actifs de ce cluster.
    Figure 5. Onglet « Déploiements Argo » affichant tous les déploiements actifs
    Onglet « Déploiements Argo » affichant tous les déploiements actifs

    La vue « Déploiements Argo » comprend :

    • Barre récapitulative : affiche le nombre total de déploiements ainsi que leur répartition par état de santé (en bon état, en cours, suspendu ou dégradé).
    • Fiches de déploiement : Chaque fiche indique :
      • Nom du déploiement, espace de noms et stratégie de déploiement (canary ou blue-green)
      • Indicateur d'état de santé (En bonne santé, En progression, Suspendu, Dégradé)
      • Nombre de répliques disponibles par rapport au nombre souhaité
      • Pour les déploiements Canary : barre de progression du poids du trafic et progression par étapes
      • Pour les déploiements « blue-green » : indicateurs « Active » et « Preview »
      • Indicateurs de taux d'erreur et de latence (lorsque l'agent APM est installé; « N/A » s'ils ne sont pas disponibles)
      • Pendant les déploiements « canary » : comparaison côte à côte des taux d'erreur et de la latence entre les versions « canary » et stables
  4. Cliquez sur n'importe quelle fiche de déploiement pour afficher des informations détaillées sur ce déploiement spécifique.
Détails du déploiement de la version Canary

La vue détaillée du déploiement « canary » fournit des informations complètes sur le déploiement progressif, avec des comparaisons de performances entre les versions « canary » et stables.

Lorsque vous cliquez sur une fiche de déploiement « Canary », la vue détaillée fournit des informations complètes sur le déploiement progressif :

  • Progression des étapes Canary : étape actuelle du processus de déploiement (par exemple, « Étape 3 sur 7 » indique que le déploiement en est à la troisième étape sur les sept étapes configurées au total) avec répartition du trafic
  • Comparaison des performances : comparaison côte à côte des taux d'erreur et de la latence entre les versions « canary » et « stable »
  • État des répliques : nombre de répliques « prêtes » par rapport au nombre souhaité, tant pour les versions « canary » que pour les versions « stables »
  • Calendrier de déploiement : aperçu historique de l'avancement du déploiement et des événements
  • Corrélation APM : une fois l'agent APM d' Instana installé, vous pouvez accéder aux données de performances des applications corrélées :
    • Cliquez sur le nom d'un service pour accéder à son tableau de bord et obtenir une analyse détaillée de ses performances
    • Afficher les indicateurs relatifs aux taux d'erreur, à la latence et au débit spécifiques aux versions « canary » et « stable »
    • Fichiers journaux d'accès des pods exécutant les versions « canary » et « stable »
    • Analyser les traces afin d'identifier les problèmes de performances introduits par la nouvelle version
Figure 6 Vue détaillée du déploiement Canary présentant la répartition du trafic et les indicateurs de performance
Vue détaillée du déploiement Canary présentant la répartition du trafic et les indicateurs de performance

Grâce à cette vue d'ensemble, vous pouvez rapidement déterminer si la version « canary » fonctionne comme prévu par rapport à la version stable, et intervenir si une baisse de performances est détectée.

Détails du déploiement « Blue-green »

La vue détaillée du déploiement en bleu-vert fournit des informations complètes sur le déploiement, avec une identification claire des versions actives et des versions en préversion.

Lorsque vous cliquez sur une fiche de déploiement bleu-vert, la vue détaillée fournit des informations complètes sur le déploiement :

  • Indicateurs « Actif » et « Aperçu » : identification claire de la version qui traite actuellement le trafic de production (active) et de celle qui est prête à être mise en production (aperçu)
  • État des répliques : nombre de répliques prêtes par rapport au nombre souhaité, tant pour les versions actives que pour les versions en préversion
  • Indicateurs de performance : taux d'erreur et latence pour chaque version lorsque l'agent APM est installé
  • État du déploiement : situation actuelle et avancement du déploiement bleu-vert
  • Corrélation APM : une fois l'agent APM d' Instana installé, vous pouvez accéder aux données de performances des applications corrélées :
    • Cliquez sur le nom d'un service pour accéder à son tableau de bord et obtenir une analyse détaillée de ses performances
    • Comparer les indicateurs de performance entre les versions actives et les versions en avant-première avant la mise en production
    • Journaux d'accès des pods s'exécutant à la fois dans l'environnement actif et dans l'environnement de prévisualisation
    • Analyser les traces pour vérifier que la version préliminaire est prête à accueillir le trafic de production
Figure 7. Vue détaillée du déploiement « bleu-vert » présentant les versions actives et de prévisualisation
Vue détaillée du déploiement « bleu-vert » présentant les versions actives et de prévisualisation
Figure 8. Déploiement bleu-vert présentant les services et les journaux associés pour une analyse approfondie des performances
Déploiement bleu-vert présentant les services et les journaux associés pour une analyse approfondie des performances

Grâce à cette vue d'ensemble, vous pouvez suivre en temps réel la mise en production progressive, valider les nouvelles versions avant de les déployer en production, identifier rapidement les problèmes et contribuer à garantir que vos déploiements se déroulent en toute sécurité et avec succès. L'intégration poussée avec l'APM d' Instana offre la capacité d'observabilité nécessaire pour prendre des décisions de déploiement en toute confiance.