Collecter des bundles de support pour un cluster de conteneurs Antrea

Vous pouvez utiliser la fonctionnalité Bundle de support dans NSX pour collecter des fichiers journaux à partir de nœuds de cluster de conteneurs 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.

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

• Contrôleur Antrea
• Agent Antrea
• Adaptateur de 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 de conteneurs 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 de conteneurs 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 de conteneurs 1 et 2 dans le cluster de conteneurs 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 de conteneurs 3 et 4 dans le cluster de conteneurs 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 de conteneurs.

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

Conditions préalables

Des clusters de conteneurs Antrea 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 de conteneurs Antrea 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 de conteneurs Antrea. Ce comportement est normal et conforme à la conception actuelle de l'interface utilisateur. Si vous avez enregistré le premier cluster de conteneurs 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 de conteneurs 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 de conteneurs Antrea 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 :

   • Clusters de conteneurs Antrea
   • Nœuds NSX Manager
   • Dispositifs Edge
   • Hôtes
   • Passerelles de cloud public

   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 de conteneurs 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 de conteneurs 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 de conteneurs.
   Si la liste contient plusieurs clusters de conteneurs à sélectionner, entrez les premiers caractères du nom du cluster de conteneurs. Le système filtre la liste et affiche uniquement les noms de cluster de conteneurs qui correspondent aux caractères que vous avez entrés.
   Tous les nœuds du cluster de conteneurs sélectionné s'affichent dans la liste Disponible.
6. Sélectionnez un ou plusieurs nœuds dans le cluster de conteneurs 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 de conteneurs Antrea dans une demande de collecte unique, répétez les étapes 4 et 5 pour chaque cluster de conteneurs.
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 de conteneurs échoue lorsque la demande de bundle de support est en cours, la collecte de journaux échoue pour ce cluster de conteneurs.
• 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 de conteneurs Antrea.

Scénario de réussite partielle

Supposons que vous avez sélectionné 10 nœuds dans un seul cluster de conteneurs 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 de conteneurs, 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 de conteneurs 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 de 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 de conteneurs 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 de conteneurs dans la demande de bundle de support. Le fichier contient des informations sur les différentes ressources Kubernetes collectées à partir du serveur d'API Kubernetes, telles que les espaces, les nœuds, les déploiements, les ReplicaSets, les DaemonSets, etc.
   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