How to capture an esxtop output
There are a couple of very important things to keep in mind when capturing an 'esxtop':
- The 'esxtop' should be captured from the ESXi host where you suspect possible performance issues are originating from. It is host specific and does not capture for a cluster.
- If there are particular VMs you suspect as the cause of performance anomalies, the 'esxtop' needs to be captured on the ESXi host where the VM resides at the time the 'esxtop' is run.
- When specifying the location of the 'esxtop.csv' file, please be sure you send it to a datastore that has at least 5GB of space available. If you try to send the file to the tmp folder, you risk filling it up and causing the ESXi Host management services to stall. This would require a host reboot and possible outage, so please be mindful of this.
- 'SSH' must be enabled on the ESXi host since 'esxtop' can only be ran / captured from the ESXi host CLI.
- The output file should always be a '.csv' format for easy review of the data.
|What syntax should I use when capturing an 'esxtop'?|
esxtop -b -a -d 2 -n 300 > /vmfs/volumes/pure_datastore/esxtop-[hostname]-[date].csv
[root@ac-esxi-6:~] mkdir /vmfs/volumes/sn1-x70-b05-vmfs-scale-ds/esxtop-captures/ [root@ac-esxi-6:~] [root@ac-esxi-6:~] esxtop -b -a -d 2 -n 300 > /vmfs/volumes/sn1-x70-b05-vmfs-scale-ds/esxtop-captures/esxtop-ac-esxi-6-June-2019.csv [root@ac-esxi-6:~] [root@ac-esxi-6:~] ls -lh /vmfs/volumes/sn1-x70-b05-vmfs-scale-ds/esxtop-captures/ total 87040 -rw-r--r-- 1 root root 84.1M Jun 12 15:15 esxtop-ac-esxi-6-June-2019.csv
The above runs the 'esxtop' capture in 'batch mode' (-b), captures all available counters (-a), at 2 second intervals (-d), for 300 iterations (-n). Which means that this will capture 10 minutes of performance data with 2 second intervals (shortest interval VMware supports) and output it to the 'esxtop.csv' file for review.
There are few instances where a capture longer than 10 minutes of data is needed to understand and get a clear picture of the problem. Should a longer capture be needed only modify the number of iterations (-n) so that everything else remains the same.
You will know the 'esxtop' capture is completed once the CLI prompt returns and you are able to type again. After the 'esxtop' has completed running, you can navigate to the path the file was saved and SCP it off the ESXi host and upload to FTPS for Pure Storage review.
Related Links and References
Here are some useful links for unlocking the power of the esxtop output that was captured.
- How to upload files to Pure Storage FTPS Service
- Exporting esxtop performance data as a CSV file
- Using esxtop to identify storage performance issues
- Using visualesxtop to troubleshoot performance issues
- Using visualesxtop on a Mac