Utilizzare l'utilità SoS per raccogliere i registri per i vari componenti software nel sistema.

Utilizzare queste opzioni quando si recuperano i registri di supporto dai vari componenti dell'ambiente in uso.

  • Se si esegue l'utilità SoS da SDDC Manager senza indicare opzioni specifiche dei componenti, lo strumento SoS raccoglie i registri di riepilogo di SDDC Manager, API e VMware Cloud Foundation. Per raccogliere tutti i registri, utilizzare le opzioni --collect-all-logs.
    Nota: È possibile che si verifichi il timeout della raccolta dei registri SoS dopo 60 minuti. Questo potrebbe essere un problema con i domini del carico di lavoro di grandi dimensioni. Se si verifica il timeout dell'utilità SoS, raccogliere i registri specifici dei componenti o limitare la raccolta dei registri a cluster specifici utilizzando le opzioni descritte di seguito.
  • Se si esegue l'utilità SoS da Cloud Builder senza specificare opzioni specifiche dei componenti, lo strumento SoS raccoglie i registri di SDDC Manager, API e Cloud Builder.
  • Per raccogliere i registri per un componente specifico eseguire l'utilità con le opzioni appropriate.

    Ad esempio, l'opzione --domain-name è importante. Se viene omessa, l'operazione di SoS viene eseguita solo nel dominio di gestione. Vedere Opzioni dell'utilità SoS.

Dopo aver eseguito l'utilità SoS, è possibile esaminare i registri risultanti per risolvere i problemi o fornirli al supporto tecnico di VMware, se necessario. Il supporto tecnico di VMware potrebbe richiedere questi registri per risolvere i problemi tecnici quando si invia una richiesta di supporto. Le informazioni diagnostiche raccolte utilizzando l'utilità SoS includono i registri dei vari prodotti e componenti software di VMware distribuiti nell'ambiente VMware Cloud Foundation.

Tabella 1. Opzioni del file di registro dell'utilità SoS
Opzione Descrizione
--esx-logs

Raccoglie solo i registri degli host ESXi.

I registri vengono raccolti da ogni host ESXi disponibile nella distribuzione.

--vc-logs

Raccoglie solo i registri delle istanze di vCenter Server.

I registri vengono raccolti da ogni server di vCenter disponibile nella distribuzione.

--sddc-manager-logs

Raccoglie solo i registri di SDDC Manager. sddc<timestamp>.tgz contiene i registri delle partizioni etc, tmp, usr e var del file system di SDDC Manager.

--vxrail-manager-logs Raccoglie solo i registri delle istanze di VxRail Manager.
--psc-logs Raccoglie solo i registri delle istanze di Platform Services Controller.
--nsx-logs

Raccoglie solo i registri delle istanze di NSX Manager e NSX Edge.

--wcp-logs

Raccoglie solo i registri dei cluster di Gestione carico di lavoro.

--vrealize-logs

Raccoglie i registri da VMware Aria Suite Lifecycle.
--no-clean-old-logs

Utilizzare questa opzione per impedire all'utilità di rimuovere output dall'esecuzione di una raccolta precedente.

Per impostazione predefinita, prima di scrivere l'output nella directory, l'utilità elimina i file di output dell'esecuzione precedente che potrebbero essere presenti. Se si desidera conservare i file di output precedenti, specificare questa opzione.

--test

Raccoglie i registri dei test verificando i file.

--no-health-check

Ignora il controllo dell'integrità eseguito come parte della raccolta dei registri.

--api-logs

Raccoglie l'output dagli endpoint REST per l'inventario di SDDC Manager e LCM.

--rvc-logs

Raccoglie solo i registri di Ruby vSphere Console (RVC). RVC è un'interfaccia per ESXi e vCenter.

Nota: Se la shell Bash non è abilitata in vCenter Server, la raccolta dei registri di RVC verrà ignorata.
Nota: I registri di RVC non vengono raccolti per impostazione predefinita con la raccolta dei registri ./sos. È necessario abilitare RVC per raccogliere i registri di RVC.
--vm-screenshots Raccoglie le schermate di tutte macchine virtuali.
--system-debug-logs Raccoglie i registri di sistema per semplificare il debug dei problemi non comuni.
--collect-all-logs Raccoglie i registri di tutti i componenti ad eccezione di Gestione carico di lavoro e dei registri di debug del sistema. Per impostazione predefinita, vengono raccolti i registri dei componenti del dominio di gestione.

Per raccogliere i registri di tutti i domini del carico di lavoro, specificare --domain-name ALL.

Per raccogliere i registri di un determinato dominio del carico di lavoro, specificare --domain-name domain_name.
--log-dir LOGDIR Specifica la directory in cui archiviare i registri.
--log-folder LOGFOLDER Specifica il nome della directory dei registri.
--domain-name DOMAINNAME

Specificare il nome del dominio del carico di lavoro in cui eseguire l'operazione di SoS.

Per eseguire l'operazione in tutti i domini, specificare --domain-name ALL.

Nota:

Se si omette il flag --domain-name e il nome di dominio, l'operazione di SoS viene eseguita solo nel dominio di gestione.

Procedura

  1. Utilizzando SSH accedere a Appliance SDDC Manager come utente vcf.
  2. Per raccogliere i registri, eseguire l'utilità SoS senza specificare alcuna opzione specifica per i componenti. 
    sudo /opt/vmware/sddc-support/sos
    Specificare la password vcf quando viene richiesta.
    Per raccogliere i registri per un componente specifico eseguire l'utilità con le opzioni appropriate. 
    sudo /opt/vmware/sddc-support/sos --option-name
    Nota: Per impostazione predefinita, prima di scrivere l'output nella directory, l'utilità elimina i file di output dell'esecuzione precedente che potrebbero essere presenti. Se si desidera conservare i file di output precedenti, specificare l'opzione --no-clean-old-logs.
    Se non si specifica l'opzione --log-dir, l'utilità scrive l'output nella directory /var/log/vmware/vcf/sddc-support della Appliance SDDC Manager

risultati

L'utilità raccoglie i file di registro dei vari componenti software in tutti i rack e scrive l'output nella directory indicata nell'opzione --log-dir. In tale directory l'utilità genera l'output in una struttura di directory specifica.

Esempio

vcf@sddc-manager [ ~ ]$ sudo /opt/vmware/sddc-support/sos --domain-name MGMT --skip-known-host-check --log-dir /tmp/new
[sudo] password for vcf
Welcome to Supportability and Serviceability(SoS) utility!
Performing SoS operation for MGMT domain components
Logs : /tmp/new/sos-2019-09-03-21-04-40-11793
Log file : /tmp/new/sos-2019-09-03-21-04-40-11793/sos.log
Log Collection completed successfully for : [HEALTH-CHECK, SDDC-MANAGER, NSX_MANAGER, API-LOGS, ESX, VMS_SCREENSHOT, VCENTER-SERVER, VCF-SUMMARY]

Operazioni successive

Passare alla directory di output per esaminare i file di registro raccolti.