Erfassen von Support-Paketen für einen Antrea-Kubernetes-Cluster

Sie können die Support-Paketfunktion in NSX verwenden, um Protokolldateien von Antrea-Kubernetes-Clusterknoten für detaillierte Fehlerbehebungs- und Diagnosezwecke zu erfassen.

NSX können die Support-Pakete auf einen NSX Manager-Knoten hochladen, von dem aus Sie die Anforderung für die Erfassung der Support-Pakete ausgelöst haben. Oder die Support-Pakete werden auf den Remote-Dateiserver hochgeladen, den Sie in der Anforderung angegeben haben. Wenn die Support-Pakete auf einen NSX Manager-Knoten hochgeladen wurden, können Sie sie auf Ihren lokalen Computer herunterladen.

Hinweis: In dieser Dokumentation bezeichnet der Begriff „Antrea-Kubernetes-Cluster“ Kubernetes-Cluster mit Antrea-CNI. Der Begriff „Kubernetes-Cluster“ ist ein allgemeiner Begriff, der für Tanzu Kubernetes Grid (TKG)-Cluster mit Antrea-CNI, OpenShift-Cluster mit Antrea-CNI oder benutzerdefinierte Kubernetes-Cluster mit Antrea-CNI steht.

Auf der Benutzeroberfläche wird der Begriff „Antrea-Container-Cluster“ für einige Felder oder Bezeichnungen verwendet. Im Abschnitt Verfahren wird in dieser Dokumentation der Begriff „Antrea-Container-Cluster“ für diese Felder oder Bezeichnungen der Benutzeroberfläche beibehalten. In allen allgemeinen Texten wird der Begriff „Antrea-Kubernetes-Cluster“ verwendet.

Ein Support-Paket für einen Antrea-Kubernetes-Cluster enthält Protokolldateien für die folgenden Komponenten:

• Antrea-Controller
• Antrea-Agent
• Management Plane-Adapter
• Zentraler Steuerungsebenen-Adapter
• Open vSwitch

Unterstützte und nicht unterstützte Funktionen

• Von einem NSX Manager-Knoten aus können Sie nur eine einzige Anforderung zur Erfassung von Support-Paketen starten. Sie können jedoch mit einer einzelnen Erfassungsanforderung Support-Pakete für mehrere Antrea-Kubernetes-Cluster erfassen.
• Wenn Sie einen NSX Manager-Cluster mit drei Verwaltungsknoten verwenden, können Sie eine separate Anforderung zur Erfassung von Support-Paketen gleichzeitig von jedem NSX Manager-Knoten aus starten. Die Antrea-Kubernetes-Cluster, die Sie in jeder Erfassungsanforderung auswählen, müssen jedoch unterschiedlich sein.

  Beispiel: Angenommen, Sie haben eine Anforderung zur Erfassung eines Support-Pakets vom NSX Manager-Knoten A aus gestartet. In dieser Erfassungsanforderung haben Sie die Clusterknoten 1 und 2 aus dem Antrea-Kubernetes-Cluster X ausgewählt. Wenn Sie gleichzeitig eine zweite Erfassungsanforderung vom NSX Manager-Knoten B für die Clusterknoten 3 und 4 im Antrea-Kubernetes-Cluster X starten, schlägt eine der beiden Anforderungen fehl. Sie müssen warten bis die erste Erfassungsanforderung abgeschlossen wurde, bevor Sie die zweite Anforderung für denselben Antrea-Kubernetes-Cluster auslösen.

• Die Erfassung von Support-Paketen von der zentralen NSX Manager-CLI aus wird derzeit für Antrea-Kubernetes-Cluster nicht unterstützt.

Voraussetzungen

Antrea-Kubernetes-Cluster sind in NSX registriert.

Prozedur

1. Melden Sie sich über Ihren Browser bei einem NSX Manager unter https://nsx-manager-ip-address an.
2. Navigieren Sie zu System > Support-Paket.
   Die Seite Anforderungspaket wird geöffnet.

   Wichtig: Die NSX Manager-Benutzeroberfläche ruft die Informationen zu registrierten Antrea-Kubernetes-Clustern ab, wenn Sie die NSX Manager-Anwendung im Browser starten. Wenn die Benutzeroberfläche der Anwendung bereits geöffnet ist, werden die Registrierungsinformationen für den Antrea-Kubernetes-Cluster nicht automatisch abgerufen. Dieses Verhalten wird gemäß dem aktuellen UI-Design erwartet. Wenn Sie den ersten Antrea-Kubernetes-Cluster nach dem Öffnen der NSX Manager-Anwendung registriert haben, aktualisieren Sie den Browser, nachdem Sie zur Seite Anforderungspaket navigiert haben. Eine manuelle Aktualisierung stellt sicher, dass Sie im nächsten Schritt dieses Vorgangs Antrea-Kubernetes-Cluster als Zielknoten auswählen können.

   Diese manuelle Browseraktualisierung ist nur einmal und nicht jedes Mal erforderlich, nachdem ein neuer Antrea-Kubernetes-Cluster bei NSX registriert wurde.

3. Wählen Sie die Zielknoten aus, die in die Support-Paketanforderung aufgenommen werden sollen.
   Die verfügbaren Knotentypen sind:

   • Antrea Containercluster
   • Verwaltungsknoten
   • Edges
   • Hosts

   Eine einzelne Support-Paketanforderung kann eine Kombination aus verschiedenen Knotentypen in der NSX-Umgebung enthalten. Beispielsweise können Sie Knoten aus Antrea-Kubernetes-Clustern, NSX Manager-Knoten und NSX Edge-Knoten in derselben Erfassungsanforderung auswählen. In diesem Verfahren wird jedoch nur der Workflow des Erstellens einer Anforderung zum Erfassen eines Support-Pakets für Antrea-Kubernetes-Cluster erläutert.

4. Wählen Sie im Dropdown-Menü Typ die Option Antrea-Container-Cluster aus.
5. Wählen Sie in der Liste Container-Cluster den Namen eines Clusters aus.
   Wenn die Liste mehrere Cluster zur Auswahl enthält, geben Sie die ersten Zeichen des Clusternamens ein. Das System filtert die Liste und zeigt nur die Clusternamen an, die mit den eingegebenen Zeichen übereinstimmen.
   Alle Knoten im ausgewählten Cluster werden in der Liste Verfügbar angezeigt.
6. Wählen Sie einen oder mehrere Knoten aus dem Cluster aus und klicken Sie auf den Nach-rechts-Pfeil, um sie in die Liste Ausgewählt zu verschieben.
   Um Knoten aus mehreren Clustern in einer einzelnen Erfassungsanforderung auszuwählen, wiederholen Sie die Schritte 4 und 5 für jeden Cluster.
7. (Optional) Behalten Sie im Textfeld Protokollalter (Tage) den Standardwert bei oder geben Sie eine bestimmte Anzahl von Protokollen ein, die in das Support-Paket aufgenommen werden sollen. Geben Sie das Protokollalter in Anzahl an Tagen an.
8. (Optional) Um das Support-Paket auf einen Remote-Dateiserver hochzuladen, geben Sie die Einstellungen für den Dateiserver an.
   1. Geben Sie eine IP-Adresse oder den Hostnamen des Remote-Dateiservers ein.
   2. Geben Sie das Dateiübertragungsprotokoll und die Portnummer ein. Die Standard-Portnummer ist 22.
   3. Geben Sie den Benutzernamen und das Kennwort für den Zugriff auf den Remote-Dateiserver ein.
   4. Geben Sie den Pfad zum Zielordner ein, in den die Support-Paketdatei hochgeladen werden soll.
   Wenn keine Remote-Dateiservereinstellungen angegeben sind, wird das Support-Paket auf den NSX Manager-Knoten hochgeladen, von dem aus Sie die Anforderung zur Erfassung des Support-Pakets ausgelöst haben.
9. Klicken Sie auf Paketerfassung starten.
   Die Laufzeitdetails der Erfassungsanforderung werden auf der Seite Status angezeigt. Der Erfassungsvorgang dauert einige Minuten. Die für die Erstellung des Support-Pakets benötigte Zeit hängt von der Anzahl der Protokolldateien ab, die von jedem Knoten im Container-Cluster erfasst werden sollen.
10. Klicken Sie nach Abschluss des Erfassungsvorgangs auf Herunterladen.
    Die Support-Paketdatei wird auf Ihrem lokalen Computer gespeichert. Wenn Sie Remote-Dateiservereinstellungen festgelegt haben, wird die Schaltfläche Download nicht auf der Benutzeroberfläche angezeigt.

Ergebnisse

Eine Anforderung zur Erfassung von Support-Paketen generiert eine einzelne Bandarchivdatei (TAR) mit der folgenden Dateibenennungskonvention: nsx_support_archive_datestamp_timestamp.tar

Eine Anforderung zur Erfassung von Support-Paketen kann in den folgenden Situationen fehlschlagen:

• Wenn der Antrea-NSX-Adapter in einem Kubernetes-Cluster während der Anforderung des Support-Pakets ausfällt, schlägt die Erfassung von Protokollen für diesen Kubernetes-Cluster fehl.
• Wenn die NSX Manager-Appliance ausfällt oder nicht erreichbar ist, während die Anforderung von Support-Paketen ausgeführt wird, schlägt die Erfassung von Protokollen fehl. Bis das Konnektivitätsproblem mit NSX Manager behoben ist, können Sie das native Befehlszeilentool von Antrea (antctl) verwenden, um Protokolldateien in den Antrea-Kubernetes-Clustern zu erfassen.

Szenario für Teilerfolg

Angenommen, Sie haben 10 Knoten von einem einzelnen Antrea-Kubernetes-Cluster für die Erfassung von Support-Paketen ausgewählt. Während des Erfassungsvorgangs wurden Protokolldateien von fünf Knoten im Antrea-Kubernetes-Cluster erfolgreich erfasst, für die fünf übrigen Knoten wurden sie jedoch nicht erfasst. Mit anderen Worten: Die Erfassungsanforderung war teilweise erfolgreich. In dieser Situation lautet der Status der Erfassungsanforderung Erfolgreich und die Support-Paketdatei (TAR) enthält Protokolle für die fünf erfolgreichen Knoten.

Nächste Maßnahme

1. Extrahieren Sie die TAR-Datei. Die folgenden Dateien werden angezeigt.

   Dateiname	Beschreibung
   manifest.json	Diese Datei enthält eine Übersicht der Ergebnisse der Erfassungsanforderung und der Eigenschaften der Erfassungsanforderung. Sie enthält beispielsweise Informationen zu: den Knoten, für die die Erfassung erfolgreich war. den Knoten, für die die Erfassung fehlgeschlagen ist. die Cluster-IDs und Knoten-IDs, die in der Erfassungsanforderung verwendet wurden.
   nsx_antrea_cluster-id.tgz	Eine einzelne .tgz -Archivdatei wird für jeden Antrea-Kubernetes-Cluster im Support-Paket erstellt.

2. Extrahieren Sie die Datei nsx_antrea_cluster-id.tgz. Die folgenden Dateien werden angezeigt.

   Dateiname	Beschreibung
   adapters.tar.gz	Diese Archivdatei enthält die Management Plane-Adapter- und Zentraler Steuerungsebenen-Adapter-Protokolldateien.
   agent_node_name.tar.gz	Diese Archivdatei enthält die Antrea-Agent- und Open vSwitch-Protokolldateien. Eine Archivdatei wird für jeden Antrea-Kubernetes-Clusterknoten in der Erfassungsanforderung generiert. Beim Extrahieren dieser Archivdatei können Sie die folgenden Dateien anzeigen: Datei agentinfo Agent-Protokolle unter /logs/agent Open vSwitch-Protokolle unter /logs/ovs OpenFlow-Speicherabbild IPtables Route-Speicherabbild
   clusterinfo	Diese Datei wird für jeden Antrea-Kubernetes-Cluster in der Support-Paketanforderung generiert. Die Datei enthält Informationen zu den folgenden Kubernetes-Ressourcen, die vom Kubernetes-API-Server erfasst werden: Pods Knoten Bereitstellungen ReplicaSets DaemonSets
   controller.tar.gz	Diese Archivdatei enthält die Antrea-Controller-Protokolldateien. Beim Extrahieren dieser Archivdatei können Sie die folgenden Dateien anzeigen: Datei controllerinfo Controller-Protokolle unter /logs/controller