Collecter des bundles de support pour un cluster Kubernetes Antrea

Vous pouvez utiliser la fonctionnalité Bundle de support dans NSX pour collecter des fichiers journaux à partir de nœuds de cluster Kubernetes Antrea à des fins de dépannage et de diagnostic détaillés.

NSX peut télécharger les bundles de support vers un nœud NSX Manager à partir duquel vous avez déclenché la demande de collecte de bundle de support, ou il peut télécharger les bundles de support sur un serveur de fichiers distant que vous avez spécifié dans la demande. Si les bundles de support sont téléchargés sur un nœud NSX Manager, vous pouvez les télécharger sur votre ordinateur local.

Note : Cette documentation utilise le terme « Cluster Antrea Kubernetes » pour désigner les clusters Kubernetes avec Antrea CNI. Le terme « Cluster Kubernetes » est un terme générique, qui représente les clusters Tanzu Kubernetes Grid (TKG) avec Antrea CNI, les clusters OpenShift avec Antrea CNI ou les clusters Kubernetes en libre-service avec Antrea CNI.

L'interface utilisateur utilise le terme « Cluster de conteneurs Antrea » pour quelques champs ou étiquettes de l'interface utilisateur. Dans la section Procédure de cette documentation, le terme « Cluster de conteneurs Antrea » est conservé pour ces champs ou étiquettes de l'interface utilisateur. Pour tout le texte de forme libre, le terme « Cluster Kubernetes Antrea » est utilisé.

Un bundle de support pour un cluster Kubernetes Antrea contient des fichiers journaux pour les composants suivants :

• Contrôleur Antrea
• Agent Antrea
• Adaptateur du plan de gestion
• Adaptateur de plan de contrôle central
• Open vSwitch

Fonctionnalités prises en charge et non prises en charge

• À partir d'un nœud NSX Manager, vous ne pouvez démarrer qu'une seule demande de collecte de bundle de support. Cependant, vous pouvez collecter des bundles de support pour plusieurs clusters Kubernetes Antrea avec une seule demande de collecte.
• Si vous utilisez un cluster NSX Manager avec trois nœuds de gestion, vous pouvez démarrer simultanément une demande de collecte de bundle de support distincte à partir de chaque nœud NSX Manager. Cependant, le cluster Antrea Kubernetes que vous sélectionnez dans chaque demande de collecte doit être différent.

  Par exemple, supposons que vous ayez démarré une demande de collecte de bundle de support sur un nœud A de NSX Manager. Dans cette demande de collecte, vous avez sélectionné les nœuds de cluster 1 et 2 dans le cluster Antrea Kubernetes X. Simultanément, si vous démarrez une deuxième demande de collecte sur le nœud B de NSX Manager pour les nœuds de cluster 3 et 4 dans le cluster Antrea Kubernetes X, l'une de ces demandes de collecte échouera. Vous devez attendre la fin de la première demande de collecte avant de déclencher la deuxième demande pour le même cluster Antrea Kubernetes.

• La collecte de bundles de support à partir de NSX Manager Central CLI n'est actuellement pas prise en charge pour les clusters Kubernetes Antrea.

Conditions préalables

Des clusters Antrea Kubernetes sont enregistrés dans NSX.

Procédure

1. À partir de votre navigateur, connectez-vous à un dispositif NSX Manager sur https://nsx-manager-ip-address.
2. Accédez à Système > Bundle de support.
   La page Demander un bundle s'ouvre.

   Important : L'interface utilisateur de NSX Manager récupère les informations sur les clusters Antrea Kubernetes enregistrés lorsque vous démarrez l'application NSX Manager dans le navigateur. Si l'interface utilisateur de l'application est déjà ouverte, elle n'extrait pas automatiquement les informations d'enregistrement du cluster Antrea Kubernetes. Ce comportement est normal et conforme à la conception actuelle de l'interface utilisateur. Si vous avez enregistré le premier cluster Kubernetes Antrea après l'ouverture de l'application NSX Manager, assurez-vous d'actualiser le navigateur après avoir accédé à la page Demander un bundle. Une actualisation manuelle garantit que vous pouvez sélectionner des clusters Kubernetes Antrea comme nœuds cibles à l'étape suivante de cette procédure.

   Cette actualisation manuelle du navigateur n'est requise qu'une seule fois et pas à chaque fois qu'un nouveau cluster Antrea Kubernetes doit être enregistré dans NSX.

3. Sélectionnez les nœuds cibles à inclure dans la demande de bundle de support.
   Les types de nœuds disponibles sont les suivants :

   • Antrea clusters de conteneurs
   • Nœuds de gestion
   • Dispositifs Edge
   • Hôtes

   Une demande de bundle de support unique peut inclure un mélange de différents types de nœuds dans l'environnement NSX. Par exemple, vous pouvez sélectionner des nœuds dans des clusters Kubernetes Antrea, des nœuds NSX Manager et des nœuds NSX Edge dans la même demande de collecte. Toutefois, l'étendue de cette procédure consiste à expliquer le workflow de création d'une demande de collecte de bundle de support uniquement pour des clusters Kubernetes Antrea.

4. Dans le menu déroulant Type, sélectionnez Clusters de conteneurs Antrea.
5. Dans la liste Cluster de conteneurs, sélectionnez le nom d'un cluster.
   Si la liste contient plusieurs clusters à sélectionner, entrez les premiers caractères du nom du cluster. Le système filtre la liste et affiche uniquement les noms de cluster qui correspondent aux caractères que vous avez entrés.
   Tous les nœuds du cluster sélectionné s'affichent dans la liste Disponible.
6. Sélectionnez un ou plusieurs nœuds dans le cluster et cliquez sur la flèche droite pour les déplacer vers la liste Sélectionné.
   Pour sélectionner des nœuds à partir de plusieurs clusters dans une demande de collecte unique, répétez les étapes 4 et 5 pour chaque cluster.
7. (Facultatif) Dans la zone de texte Âge du journal (jours), conservez la valeur par défaut ou entrez le nombre de jours de journaux que vous souhaitez inclure dans le bundle de support. Spécifiez l'âge du journal sous la forme d'un nombre de jours.
8. (Facultatif) Pour télécharger le bundle de support sur un serveur de fichiers distant, spécifiez les paramètres du serveur de fichiers.
   1. Entrez une adresse IP ou le nom de l'hôte du serveur de fichiers distant.
   2. Entrez le protocole de transfert de fichiers et le numéro de port. Le numéro de port par défaut est 22.
   3. Entrez le nom d'utilisateur et le mot de passe pour accéder au serveur de fichiers distant.
   4. Entrez le chemin d'accès au dossier de destination dans lequel le fichier du bundle de support doit être téléchargé.
   Lorsque les paramètres du serveur de fichiers distant ne sont pas spécifiés, le bundle de support est chargé vers le nœud NSX Manager à partir duquel vous avez déclenché la demande de collecte de bundles de support.
9. Cliquez sur Démarrer la collecte de bundles.
   Les détails d'exécution de la demande de collecte s'affichent sur la page État. Le processus de collecte prend quelques minutes. Le temps nécessaire pour créer le bundle de support dépend du nombre de fichiers journaux à collecter à partir de chaque nœud du clusters de conteneurs.
10. Une fois le processus de collecte terminé, cliquez sur Télécharger.
    Le fichier du bundle de support est enregistré sur votre ordinateur local. Si vous avez spécifié des paramètres de serveur de fichiers distants, le bouton Télécharger ne s'affiche pas dans l'interface utilisateur.

Résultats

Une demande de collecte de bundle de support génère un fichier d'archive à bande unique (TAR) avec la convention de dénomination de fichier suivante : nsx_support_archive_datestamp_timestamp.tar

La demande de collecte de bundles de support peut échouer dans les situations suivantes :

• Si l'Adaptateur NSX Antrea sur un cluster Kubernetes échoue lorsque la demande de bundle de support est en cours, la collecte de journaux échoue pour ce cluster Kubernetes.
• Si le dispositif NSX Manager échoue ou n'est pas accessible lorsque la demande de bundle de support est en cours, la collecte des journaux échoue. Tant que le problème de connectivité au NSX Manager n'est pas résolu, vous pouvez utiliser l'outil de ligne de commande natif de Antrea (antctl) pour collecter des fichiers journaux à partir des clusters Kubernetes Antrea.

Scénario de réussite partielle

Supposons que vous avez sélectionné 10 nœuds dans un seul cluster Kubernetes Antrea pour la collecte du bundle de support. Pendant le processus de collecte, les fichiers journaux ont été collectés à partir de cinq nœuds du cluster Antrea Kubernetes, mais pas pour les cinq nœuds restants. En d'autres termes, la demande de collecte a partiellement abouti. Dans ce cas, l'état de la demande de collecte est Successful et le fichier de bundle de support (TAR) contient des journaux pour les cinq nœuds réussis.

Que faire ensuite

1. Extrayez le fichier TAR. Les fichiers suivants s'affichent.

   Nom du fichier	Description
   manifest.json	Ce fichier contient un résumé des résultats de la demande de collecte et des propriétés de la demande de collecte. Par exemple, il contient des informations sur : Les nœuds pour lesquels la collecte a réussi. Les nœuds pour lesquels la collecte a échoué. ID de cluster et ID de nœud utilisés dans la demande de collecte.
   nsx_antrea_cluster-id.tgz	Un fichier d'archive .tgz unique est créé pour chaque cluster Kubernetes Antrea dans le bundle de support.

2. Extrayez le fichier nsx_antrea_cluster-id.tgz. Les fichiers suivants s'affichent.

   Nom du fichier	Description
   adapters.tar.gz	Ce fichier d'archive contient les fichiers journaux de l'Adaptateur du plan de gestion et de l'Adaptateur de plan de contrôle central.
   agent_node_name.tar.gz	Ce fichier d'archive contient les fichiers journaux de l'Agent Antrea et d'Open vSwitch. Un fichier d'archive est généré pour chaque nœud de cluster Antrea Kubernetes dans la demande de collecte. Lors de l'extraction de ce fichier d'archive, vous pouvez afficher les fichiers suivants : Fichier agentinfo Journaux de l'agent dans /logs/agent Ouvrez les journaux vSwitch dans /logs/ovs Vidage OpenFlow IPtables Vidage de route
   clusterinfo	Ce fichier est généré pour chaque cluster Antrea Kubernetes dans la demande de bundle de support. Le fichier contient des informations sur les ressources Kubernetes suivantes qui sont collectées à partir du serveur d'API Kubernetes : Espaces Nœuds Déploiements ReplicaSets DaemonSets
   controller.tar.gz	Ce fichier d'archive contient les fichiers journaux du Contrôleur Antrea. Lors de l'extraction de ce fichier d'archive, vous pouvez afficher les fichiers suivants : Fichier controllerinfo Journaux du contrôleur dans /logs/controller