È possibile utilizzare la funzionalità Bundle di supporto in NSX per raccogliere file di registro da nodi di cluster Kubernetes 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.

Nota: In questa documentazione si utilizza il termine "cluster Kubernetes Antrea" per indicare i cluster Kubernetes con la CNI di Antrea. Il termine "cluster Kubernetes" è un termine generico che rappresenta cluster Tanzu Kubernetes Grid (TKG) con la CNI di Antrea, cluster OpenShift con la CNI di Antrea o cluster Kubernetes fai da te (DIY) con la CNI di Antrea.

L'interfaccia utente di utilizza il termine "cluster di container Antrea" per alcuni campi o etichette dell'interfaccia utente. Nella sezione Procedura della presente documentazione, il termine "cluster di container Antrea" viene mantenuto per tali campi o etichette dell'interfaccia utente. Per tutto il testo libero, viene utilizzato il termine "cluster Kubernetes Antrea".

Un bundle di supporto per un cluster Kubernetes 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 Kubernetes 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 Kubernetes Antrea 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 Kubernetes Antrea X. Contemporaneamente, se si avvia una seconda richiesta di raccolta sul nodo B di NSX Manager per i nodi 3 e 4 nel cluster Kubernetes Antrea 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 Kubernetes Antrea.

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

Prerequisiti

I cluster Kubernetes 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 Kubernetes 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 Kubernetes Antrea. Questo comportamento è previsto e in base alla progettazione dell'interfaccia utente corrente. Se sono stati registrati cluster Kubernetes Antrea dopo l'apertura dell'applicazione NSX Manager, assicurarsi di aggiornare il browser dopo aver navigato nella pagina Richiedi bundle. L'aggiornamento manuale garantisce la possibilità di selezionare un cluster Kubernetes 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 Kubernetes Antrea in NSX.

  3. Selezionare i nodi di destinazione da includere nella richiesta del bundle di supporto.
    I tipi di nodi disponibili sono:
    • Antrea cluster di container
    • Nodi di gestione
    • 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 Kubernetes 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 Kubernetes Antrea.

  4. Dal menu a discesa Tipo, selezionare Cluster di container Antrea.
  5. Nell'elenco Cluster di container, selezionare il nome di un cluster.
    Se nell'elenco sono presenti diversi cluster tra cui selezionare, immettere i primi caratteri del nome del cluster. Il sistema filtra l'elenco e visualizza solo i nomi dei cluster che corrispondono ai caratteri immessi.
    Tutti i nodi nel cluster selezionato vengono visualizzati nell'elenco Disponibile.
  6. Selezionare uno o più nodi nel cluster e fare clic sulla freccia a destra per spostarli nell'elenco Selezionato.
    Per selezionare i nodi da più cluster in una singola richiesta di raccolta, ripetere i passaggi 4 e 5 per ogni cluster.
  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 Kubernetes dà errore quando è in corso la richiesta del bundle di supporto, la raccolta dei registri per tale cluster Kubernetes 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 Kubernetes Antrea.
Scenario di operazione parzialmente riuscita
Tenere presente che sono stati selezionati 10 nodi da un singolo cluster Kubernetes 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 Kubernetes Antrea, 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 Kubernetes 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 Kubernetes Antrea 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 Kubernetes Antrea nella richiesta del bundle di supporto. Il file contiene informazioni sulle seguenti risorse Kubernetes raccolte dal server dell'API Kubernetes:
    • Pod
    • Nodi
    • Distribuzioni
    • ReplicaSet
    • DaemonSet
    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