Raccolta di bundle di supporto per un cluster di container Antrea

È possibile utilizzare la funzionalità Bundle di supporto in NSX per raccogliere file di registro da nodi di cluster di container Antrea per una risoluzione dei problemi dettagliata e per scopi diagnostici.

NSX può caricare i bundle di supporto in un nodo NSX Manager da cui è stata attivata la richiesta di raccolta dei bundle di supporto oppure può caricare i bundle di supporto in un file server remoto specificato nella richiesta. Se i bundle di supporto vengono caricati in un nodo NSX Manager, è possibile scaricarli nel computer locale.

Un bundle di supporto per un cluster di container Antrea contiene file di registro per i seguenti componenti:

• Controller Antrea
• Agente Antrea
• Adattatore piano di gestione
• Adattatore piano di controllo centrale
• Open vSwitch

Funzionalità supportate e non supportate

• Da un nodo NSX Manager, è possibile avviare solo una singola richiesta di raccolta dei bundle di supporto. È tuttavia possibile raccogliere i bundle di supporto per più cluster di container Antrea con una singola richiesta di raccolta.
• Se si utilizza un cluster NSX Manager con tre nodi di gestione, è possibile avviare contemporaneamente una richiesta di raccolta di bundle di supporto separata da ogni nodo NSX Manager. Tuttavia, il cluster di container selezionato in ogni richiesta di raccolta deve essere diverso.

  Si supponga ad esempio di aver avviato una richiesta di raccolta di bundle di supporto sul nodo A di NSX Manager. In questa richiesta di raccolta, sono stati selezionati i nodi 1 e 2 dal cluster di container X. Contemporaneamente, se si avvia una seconda richiesta di raccolta sul nodo B di NSX Manager per i nodi 3 e 4 nel cluster di container X, una di queste due richieste di raccolta avrà esito negativo. È necessario attendere il completamento della prima richiesta di raccolta prima di attivare la seconda richiesta per lo stesso cluster di container.

• La raccolta di bundle di supporto dalla CLI centrale di NSX Manager non è al momento supportata per i cluster di container Antrea.

Prerequisiti

I cluster di container Antrea sono registrati in NSX.

Procedura

1. Dal browser, accedere a NSX Manager all'indirizzo https://nsx-manager-ip-address.
2. Passare a Sistema > Bundle di supporto.
   Viene aperta la pagina Richiedi bundle.

   Importante: L'interfaccia utente di NSX Manager recupera le informazioni relative ai cluster di container di Antrea registrati quando si avvia l'applicazione NSX Manager nel browser. Se l'interfaccia utente dell'applicazione è già aperta, non recupera automaticamente le informazioni di registrazione del cluster di container Antrea. Questo comportamento è previsto e in base alla progettazione dell'interfaccia utente corrente. Se il primo cluster di container Antrea è stato registrato dopo l'apertura dell'applicazione NSX Manager, assicurarsi di aggiornare il browser dopo aver aperto la pagina Richiedi bundle. L'aggiornamento manuale garantisce la possibilità di selezionare un cluster di container Antrea come nodi di destinazione nel passaggio successivo di questa procedura.

   L'aggiornamento manuale del browser è necessario solo una volta e non ogni volta dopo la registrazione di un nuovo cluster di container Antrea in NSX.

3. Selezionare i nodi di destinazione da includere nella richiesta del bundle di supporto.
   I tipi di nodi disponibili sono:

   • Cluster di container Antrea
   • Nodi NSX Manager
   • Edge
   • Host
   • Gateway del cloud pubblico

   Una singola richiesta di bundle di supporto può includere una combinazione di diversi tipi di nodi nell'ambiente di NSX. Ad esempio, è possibile selezionare nodi da cluster di container Antrea, nodi NSX Manager e nodi NSX Edge nella stessa richiesta di raccolta. Tuttavia, l'ambito di questa procedura è quello di spiegare il workflow di creazione di una richiesta di raccolta di bundle di supporto solo per i cluster di container Antrea.

4. Dal menu a discesa Tipo, selezionare Cluster di container Antrea.
5. Nell'elenco Cluster di container, selezionare il nome di un cluster di container.
   Se nell'elenco sono presenti diversi cluster di container da selezionare, immettere i primi caratteri del nome del cluster di container. Il sistema filtra l'elenco e visualizza solo i nomi dei cluster di container che corrispondono ai caratteri immessi.
   Tutti i nodi nel cluster di container selezionato vengono visualizzati nell'elenco Disponibile.
6. Selezionare uno o più nodi nel cluster di container e fare clic sulla freccia a destra per spostarli nell'elenco Selezionato.
   Per selezionare i nodi da più cluster di container Antrea in una singola richiesta di raccolta, ripetere i passaggi 4 e 5 per ogni cluster di container.
7. (Facoltativo) Nella casella di testo Età registro (giorni), mantenere il valore predefinito oppure immettere il numero di giorni specifico dei registri che si desidera includere nel bundle di supporto. Specificare l'età del registro come numero di giorni.
8. (Facoltativo) Per caricare il bundle di supporto in un file server remoto, specificare le impostazioni del file server.
   1. Immettere un indirizzo IP o il nome host del file server remoto.
   2. Immettere il protocollo di trasferimento file e il numero di porta. Il numero di porta predefinito è 22.
   3. Immettere il nome utente e la password per accedere al file server remoto.
   4. Immettere il percorso della cartella di destinazione dove il file del bundle di supporto sarà caricato.
   Quando non vengono specificate le impostazioni del file server remoto, il bundle di supporto viene caricato nel nodo NSX Manager da cui è stata attivata la richiesta di raccolta del bundle di supporto.
9. Fare clic su Avvia raccolta bundle.
   I dettagli di runtime della richiesta di raccolta vengono visualizzati nella pagina Stato. Il processo di raccolta richiede alcuni minuti. Il tempo necessario per creare il bundle di supporto dipende dal numero di file di registro da raccogliere da ciascun nodo del cluster di container.
10. Una volta completato il processo di raccolta, fare clic su Scarica.
    Il file del bundle di supporto viene salvato nel computer locale. Se sono state specificate le impostazioni del file server remoto, il pulsante Scarica non viene visualizzato nell'interfaccia utente.

risultati

Una richiesta di raccolta di bundle di supporto genera un singolo file di archivio su nastro (TAR) con la seguente convenzione di denominazione del file: nsx_support_archive_datestamp_timestamp.tar

La richiesta di raccolta di bundle di supporto può avere esito negativo nelle seguenti situazioni:

• Se Adattatore NSX Antrea in un cluster di container dà errore quando è in corso la richiesta del bundle di supporto, la raccolta dei registri per tale cluster di container ha esito negativo.
• Se l'appliance NSX Manager dà errore o non è raggiungibile quando è in corso la richiesta del bundle di supporto, la raccolta dei registri ha esito negativo. Fino a quando non viene risolto il problema di connettività a NSX Manager, è possibile utilizzare lo strumento della riga di comando nativo di Antrea (antctl) per raccogliere i file di registro dai cluster di container Antrea.

Scenario di operazione parzialmente riuscita

Tenere presente che sono stati selezionati 10 nodi da un singolo cluster di container Antrea per la raccolta di bundle di supporto. Durante il processo di raccolta, i file di registro sono stati raccolti correttamente da cinque nodi nel cluster di container, ma non sono stati raccolti per i cinque nodi rimanenti. In altre parole, la richiesta di raccolta è riuscita parzialmente. In questa situazione, lo stato della richiesta di raccolta è Operazione eseguita e il file del bundle di supporto (TAR) contiene i registri per i cinque nodi senza errori.

Operazioni successive

1. Estrarre il file TAR. Vengono visualizzati i file seguenti.

   Nome file	Descrizione
   manifest.json	Questo file contiene un riepilogo dei risultati della richiesta di raccolta e delle proprietà della richiesta di raccolta. Ad esempio, contiene informazioni su: Nodi per i quali la raccolta è stata completata correttamente. Nodi per i quali la raccolta non è riuscita. Gli ID cluster e gli ID dei nodi utilizzati nella richiesta di raccolta.
   nsx_antrea_cluster-id.tgz	Viene creato un singolo file di archivio .tgz per ogni cluster di container Antrea nel bundle di supporto.

2. Estrarre il file nsx_antrea_cluster-id.tgz. Vengono visualizzati i file seguenti.

   Nome file	Descrizione
   adapters.tar.gz	Questo file di archivio contiene i file di registro di Adattatore piano di gestione e Adattatore piano di controllo centrale.
   agent_node_name.tar.gz	Questo file di archivio contiene i file di registro di Agente Antrea e Open vSwitch. Viene generato un file di archivio per ogni nodo del cluster di container nella richiesta di raccolta. Quando si estrae questo file di archivio, è possibile visualizzare i seguenti file: File agentinfo Registri dell'agente in /logs/agent Registri Open vSwitch in /logs/ovs Dump OpenFlow IPtables Dump route
   clusterinfo	Questo file viene generato per ogni cluster di container nella richiesta del bundle di supporto. Il file contiene informazioni sulle varie risorse Kubernetes raccolte dal server dell'API Kubernetes, ad esempio pod, nodi, distribuzioni, set di repliche, set di daemon e così via.
   controller.tar.gz	Questo file di archivio contiene i file di registro di Controller Antrea. Quando si estrae questo file di archivio, è possibile visualizzare i seguenti file: File controllerinfo Registri del controller in /logs/controller