Purpose
For some performance Service Requests, VMware Support might want you to collect additional virtual machine statistics. This article provides information on how to configure a virtual machine to run with a stats build VMX/virtual machine monitor (VMM), which generates the necessary data.
Note: The triple-vmx feature is available only in ESXi 5.0 and not in earlier versions of ESX or ESXi.
Resolution
To generate additional virtual machine statistics:
- Shut down the virtual machine.
- Select the virtual machine in the Inventory.
- In the Summary tab for that virtual machine, click Edit Settings.
- In the Virtual Machine Properties dialog box, click the Options tab.
- Under Advanced, click General.
- Select the Record Statistics option.
- Click OK to save the change.
- Power on the virtual machine.
Note: The statistics are logged over the runtime of the virtual machine and the end result is a summary of all values from boot to shutdown. Use this method only if your workload is consistent and can run long enough to average out the boot time. For example, the statistics collected with a one minute boot time and a 30 second test run may not provide a good representation of the actual workload.
Alternatively, you can use the CLI tool /bin/vmx-buildtype to collect the virtual machine statistics. This tool enables you to change the type while the virtual machine is running, note that this uses a slow suspend and resume, which will stun the VM for a short amount of time. The stun time in this case is dependent on the memory size of the virtual machine and the storage performance. You can use the tool from the ESXi Shell directly on the host where the virtual machine is running. For more information on enabling shell access, see Using ESXi Shell in ESXi 5.0 (2004746).
You can also use vmx-buildtype from another system to connect to vCenter Server and any ESXi 5.0 host. For more information, run this help command:
/bin/vmx-builder –help
/bin/vmx-builder –help
To generate additional virtual machine statistics using the vmx-buildtype tool:
- Run this command and verify that the virtual machine is running on the host:
vim-cmd vmsvc/getallvms - Start the workload on the virtual machine from which the statistics must be gathered.
- Run this command:
/bin/vmx-buildtype --vmname=--server localhost --buildType stats --ssr - Run this command and verify that the virtual machine is now running with the stats VMX/VMM:
head –n1 /vmfs/volumes//vmware.log The option should be STATS. - After the test completes, run this command to stop the log collection:
/bin/vmx-buildtype --vmname=--server localhost --buildType release --ssr - Run this command and verify that the virtual machine is now running with the release VMX/VMM:
head –n1 /vmfs/volumes//vmware.log The option should now be set to Release.
For information on collecting the generated logs, see Collecting diagnostic information for VMware ESX/ESXi using the vSphere Client (653)
Based on VMware KB 2009512