How to Use ESXTOP
Configuring monitoring using esxtop
To monitor storage performance per HBA:
- Start esxtop by typing esxtop at the command line.
- Press d to switch to disk view (HBA mode).
- Press f to modify the fields that are displayed.
- To view the entire Device name, press SHIFT + L and enter 36 in Change the name field size.
- Press b, c, d, e, h, and j to toggle the fields and press Enter.
- Press s, then 2 to alter the update time to every 2 seconds and press Enter.
- See Analyzing esxtop columns for a description of relevant columns.
Note: The following options are only available in VMware ESX 3.5 and later.
To monitor storage performance on a per-LUN basis:
- Start esxtop by typing esxtop from the command line.
- Press u to switch to disk view (LUN mode).
- Press f to modify the fields that are displayed.
- Press b, c, f, and h to toggle the fields and press Enter.
- Press s, then 2 to alter the update time to every 2 seconds and press Enter.
- See Analyzing esxtop columns for a description of relevant columns.
To increase the width of the device field in esxtop to show the complete naa id:
- Start esxtop by typing esxtop at the command line.
- Press u to switch to the disk device display.
- Press L to change the name field size.Note: Ensure to use uppercase L.
- Enter the value 36 to display the complete naa identifier.
To monitor storage performance on a per-virtual machine basis:
- Start esxtop by typing esxtop at the command line.
- Type v to switch to disk view (virtual machine mode).
- Press f to modify the fields that are displayed.
- Press b, d, e, h, and j to toggle the fields and press Enter.
- Press s, then 2 to alter the update time to every 2 seconds and press Enter.
- See Analyzing esxtop columns for a description of relevant columns.
Analyzing esxtop columns
This table lists the relevant columns and a brief description of these values:
Column | Description |
CMDS/s | This is the total amount of commands per second and includes IOPS (Input/Output Operations Per Second) and other SCSI commands such as SCSI reservations, locks, vendor string requests, unit attention commands etc. being sent to or coming from the device or virtual machine being monitored. In most cases CMDS/s = IOPS unless there are a lot of metadata operations (such as SCSI reservations) |
DAVG/cmd | This is the average response time in milliseconds per command being sent to the device |
KAVG/cmd | This is the amount of time the command spends in the VMkernel |
GAVG/cmd | This is the response time as it is perceived by the guest operating system. This number is calculated with the formula: DAVG + KAVG = GAVG |
If you experience high latency times, investigate current performance metrics and running configuration for the switches and the SAN targets. Check for errors or logging that may suggest a delay in operations being sent to, received, and acknowledged. This includes the array’s ability to process I/O from a spindle count aspect, or the array’s ability to handle the load presented to it.
If the response time increases to over 5000 ms (or 5 seconds), VMware ESX will time out the command and abort the operation. These events are logged; abort messages and other SCSI errors can be reviewed in the following logs:
- ESX 3.5 and 4.x – /var/log/vmkernel
- ESXi 3.5 and 4.x – /var/log/messages
- ESXi 5.x – /var/log/vmkernel.log
Leave a comment