Troubleshooting vmktree 0.1.x and 0.2.x

Q: I get no graphs
A: Make sure vmkusage is installed and works as it should. This is done with the command vmkusagectl install

Q: I can’t get graphs for a longer period than 1 week even though data has been collected for a longer period than that.
A: The default databases that are created by vmkusage wrap at 1 week. In ESX Server 2.1.0 and newer it’s possible to setup the databases to hold data for 1 month instead of 1 week. Running vmkusage -regroove;vmkusage -monthly will recreate the databases and make them store data for a month. You do not need to edit the vmkusage cron job. Remember that this command deletes all the data that has been previously collected. I’m currently working on a script that will make it possible to do this without losing the existing data.

Q: How can I upgrade from a previous version?
A: Just run the install script as you would do on a new install.

Q: When there are several users using vmktree simultanously we sometimes do not get all the graphs.
A: Yep, that’s a known issue/feature.

Q: Are virtual SMP systems supported?
A: Yes, version 0.2.6 and newer support virtual SMP.

Q: I get strange graphs in ESX Server 2.1.0
A: There’s a bug in 2.1’s vmkusage that will collect wrong values for the system’s cpu load and vmktree will present these erroneous graphs. It is possible (but probably not supported by VMware) to install ESX Server 2.1.1’s (or 2.1.2’s) vmkusage on 2.1.0 where this bug has been fixed. If this is done, vmktree v0.2.9 or newer should be installed.

Q: What is the detail level of the graphs?
A: These graphs show average values and are more detailed on newer data than on older data. These database files do not grow over time.

Age Resoulution
7h 1m
36h 5m
8d 30m
32d 2h *
1 year 2h **

*If monthly stats are enabled on ESX server version
**Only on VMware Server version

Q: What does all the values mean?
A: VMware has an excellent paper on the topic: Comparing the MUI, VirtualCenter and vmkusage

Q: How can I upgrade my esx server without loosing the graphs?
A: If you’re upgrading between versions of esx server that support the same database formats (see table above where you can see what versions of esx server that fits the same version of vmktree) this is possible. However, normally when you upgrade the graphs will be erased. This because after an upgrade vmkusage will not be initialized and you will normally need to issue the command vmkusage ctl in order to get graphs up and running again. In case of an upgrade you really have most pieces in place so all you really need is to start the collector again. The solution is to backup the file /etc/cron.d/ and put it back after the upgrade.

Q: I have just upgraded my esx server and I didn’t follow the advice above. Now vmktree seems not to be working anymore. vmkusage seems to show graphs as normally, but a closer look has revealed that it’s not updating anymore.
A: Copy the file /usr/lib/vmware/ to /etc/cron.d. vmkusage will start updating again in ~5-10 minutes. vmktree after ~1-2 minutes.

Q: How can I know how detailed an exported report will be?
A: The exported report will be as accurate as the resolution of the oldest data in the given preiod of time. The “Age – Resolution” table above shows how the datas are stored in the database.

Q: I don’t have Excel. Can I export to CSV?
A: No.

Q: How can we use the text report?
A: The text report page gives all the average values of both the system an vm’s for the given period. The output is however not too fancy as this functions main usage is meant to be a page that can be downloaded by third party tools to interact with esx statistics (e.g. BMC). You can access this page from the vmktree menu or directly using the url:

The above link would give the statistics for the last 300 seconds (5 minutes). (end=0 means end=now)

You can also omit giving any parameters:

It will then give you the default statistics for the last 3 hours.

Q: In the virtual switch view I can only see the physical nics, not the virtual ones.
A: This is because the apache user doesn’t have access to read the .vmx config files of the VMs. In order to set this you might also need to set the rights of the related subdirectories. If you have set individual rights for seperate users on the local esx host (instead of using VC), you should be very careful modifying this.

Q: What are the requirements for running vmktree for VMware Server?

Leave a Reply