How to collect vSAN support logs and upload to VMware.
search cancel

How to collect vSAN support logs and upload to VMware.

book

Article ID: 327035

calendar_today

Updated On:

Products

VMware vSAN

Issue/Introduction

This article provides information on how to collect VMware vSAN support logs and upload them to VMware.


Environment

VMware vSAN 6.1.x
VMware vSAN 6.0.x
VMware vSAN 8.0.x
VMware vSAN 6.6.x
VMware vSAN 7.0.x
VMware vSAN 5.5.x
VMware vSAN 6.2.x
VMware vSAN 6.5.x

Resolution

vSAN support logs are contained in a normal ESXi support bundle in the form of vSAN traces. The vSAN support logs are gathered automatically by gathering the ESXi support bundle for the hosts.
 
  • As vSAN is an object-network based storage system distributed across multiple ESXi hosts, when troubleshooting vSAN issues the entire cluster logs including vCenter are required for a complete analysis of the issue. For example:
    • If you have a 5-host cluster using a RAID1 policy the 3 components that make up that object are distributed across 3 hosts in the cluster per vSANs choosing. However, the error seen can be on a host that doesn't own any of those components or the object in question that needs to be troubleshot.
    • If you have a 10-host cluster using a RAID5 or RAID6 policy the components that make up the object will be laid out across 4 or 6 hosts depending on the RAID 5/6 policy in use.
  • So, as you can see based on the above examples if we don't have the entire cluster logs for analysis then we won't have all the pieces of the puzzle to provide an accurate/complete analysis.
  • The only exceptions when we wouldn't need the entire cluster logs is for a disk failure called out on a specific host or a PSOD where the backtrace doesn't mention vSAN, LSOM, and/or DOM. For these instances, just the affected host bundle will suffice.
  • When troubleshooting vSAN Performance issues additional vSAN Performance data is required for analysis. See KB Collecting vSAN Performance Service data for vSAN performance issues (51477) for collecting this additional Perf data.
Notes:
  • It's highly recommended that the cluster logs are collected before vCenter logs to ensure we get all the required logging from the hosts at the time of the event as host logs tend to wrap faster than vCenter logs.
  • When dealing with large clusters 20+ hosts and collecting logs via vCenter it's best to collect the host logs in small batches, no more than 5 at a time to ensure the logs don't get corrupt.
 
For more information on uploading the logs, see Uploading diagnostic information for VMware (1008525).

 


Additional Information

To simplify and expedite the log upload process, we recommend using the Log Assist feature of VMware Skyline, which (with your permission) automatically uploads log files. Skyline is available to all Production Support and Premier Services customers. To get started with Skyline, visit VMware Skyline Health Diagnostics for vSphere Documentation.

You can download Skyline via the below links.
VMware Skyline Collector
VMware Skyline Health Diagnostics

Uploading diagnostic information for VMware
Collecting diagnostic information for ESX/ESXi hosts and vCenter Server using the vSphere Web Client
vSAN サポート ログを収集して VMware にアップロードする方法
如何收集 vSAN 支持日志并上载到 VMware
Collecting diagnostic information for VMware ESX/ESXi