Use the SoS utility to collect the logs for various software components in the system.

Use these options when retrieving support logs from your environment's various components.

  • To collect all logs from all components, you can run the SoS utility without specifying any component-specific options.
  • To collect logs for a specific component, run the utility with the appropriate options.

    For example, the --domain-name option is important. If omitted, the SoS operation is performed only on the management domain. See SoS Utility Options.

Log files for the vRealize Log Insight agent in vCenter Server are collected when vCenter Server log files are collected.

After running the SoS utility, you can examine the resulting logs to troubleshoot issues, or provide to VMware Technical Support if requested. VMware Technical Support might request these logs to help resolve technical issues when you have submitted a support request. The diagnostic information collected using the SoS utility includes logs for the various VMware software components and software products deployed in your VMware Cloud Foundation environment.

Table 1. SoS Utility Log File Options
Option Description
--api-logs

Collects output from REST endpoints for SDDC Manager inventory and LCM.

--cassandra-logs

Collects logs from the Apache Cassandra database only. cassandra-bundle.tgz contains Cassandra nodetool and debug logs.

Apache Cassandra processes run in each of the infrastructure virtual machines.

--dump-only-sddc-java-threads

Collects only the Java thread information from the SDDC Manager.

--esx-logs

Collects logs from the ESXi hosts only.

Logs are collected from each ESXi host available in the deployment.

--li-logs

Collects logs from vRealize Log Insight VMs only.

--log-dir LOGDIR Specifies the directory to store the logs.
--log-folder LOGFOLDER Specifies the name of the log directory.
--no-clean-old-logs

Use this option to prevent the utility from removing any output from a previous collection run. By default, the SoS utility.

By default, before writing the output to the directory, the utility deletes the prior run's output files that might be present. If you want to retain the older output files, specify this option.

--no-health-check

Skips the health check executed as part of log collection.

--nsx-logs

Collects logs from the NSX Manager, NSX Controller, and NSX Edge instances only.

--psc-logs

Collects logs from the Platform Services Controller instances only.

--rvc-logs

Collects logs from the Ruby vSphere Console (RVC) only. RVC is an interface for ESXi and vCenter.

Note: If the Bash shell is not enabled in vCenter, RVC log collection will be skipped .
Note: RVC logs are not collected by default with ./sos log collection. You must enable RVC to collect RVC logs.
--sddc-manager-logs

Collects logs from the SDDC Manager only. sddc<timestamp>.tgz contains logs from the SDDC Manager file system's etc, tmp, usr, and var partitions.

--test

Collects test logs by verifying the files.

--vc-logs

Collects logs from the vCenter Server instances only.

Logs are collected from each vCenter server available in the deployment.

--vdi-logs

Collects logs for Horizon domain management components .
--vrealize-logs

Collects logs from vRealize components deployed in the system (vRealize Suite Lifecycle Manager, vRealize Log Insight, vRealize Operations, and vRealize Automation).

Procedure

  1. Using SSH, log in to the SDDC Manager appliance with the following credentials:
    Username: vcf

    Password: use the password specified in the deployment parameter sheet

  2. To collect the logs, run the SoS utility without specifying any component-specific options. 
    sudo /opt/vmware/sddc-support/sos
    Enter the vcf password when prompted.
    To collect logs for a specific component, run the utility with the appropriate options. 
    sudo /opt/vmware/sddc-support/sos --option-name
    Note: By default, before writing the output to the directory, the utility deletes the prior run's output files that might be present. If you want to retain the older output files, specify the --no-clean-old-logs option.
    If you do not specify the --log-dir option, the utility writes the output to the /var/log/vmware/vcf/sddc-support directory in the SDDC Manager appliance

Results

The utility collects the log files from the various software components in all of the racks and writes the output to the directory named in the --log-dir option. Inside that directory, the utility generates output in a specific directory structure.

Example

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, PSC, API-LOGS, ESX, LOGINSIGHT, VMS_SCREENSHOT, VCENTER-SERVER, VCF-SUMMARY]

What to do next

Change to the output directory to examine the collected log files.