VMware vSphere Health Check Report v5.1.0

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

sammyvm · ‎10-07-2010

Thanks again for the help and your stellar work with the script for the community, and yes you're absolutely correct! When I changed the role in our vCenter to give this service account the administrator roles it runs without a hitch. I had created a role previously which I had assigned very restrictive permisionns or rather permissions to only view and no modify/change. This was done in case the account was compromised.

That being said I wonder whats changed permission wise so may need to conduct some further testing and figure out what the basic rights are needed for this account

truo1van · ‎10-12-2010

HI William,

Apologies for being too keen to try out w/o reading the doc. I have tried turn on the 3 perform switches and they worked good.

I wonder if future release would have the "Powered-on VMs to Hosts ratio" per cluster?

Would be nice to have:

1) VM-to-Host ratio added to the current Clusters Summary

2) Top 10 (confgurable) VMs with most CPU/RAM usages - per cluster (would be good), with average values listed (stat samples taken over last 7 days (configurable)

3) Top 10 (confgurable) Hosts with most CPU/RAM usages - per cluster (would be good), with average values listed (stat samples taken over last 7 days (configurable)

Can (1) be easily done ie, short "hot-fix" addition lines? With (1) in place would make the report almost perfect for me, for now.

thanks again.

dgriffin1 · ‎10-14-2010

I have used the script many times in the past. It is great. However, I have an issue.

I am using vCenter 4.1 on Windows 2008 R2 Standard in a VM with four ESXi 4.1 hosts. When I run the script, I get the error below. Thanks for the help!

Can't locate object method "group" via package "ClusterConfigInfoEx" at C:\temp\vmwarevSphereHealthCheck\vmwarevSphereHealthCheck.pl line 3784.

MKguy · ‎10-15-2010

I have the same problem as sammyvm and would like to use a restricted readonly user for the vifp/vcenter stuff, but the script failed. With the administrator role it runs fine.

MKguy · ‎10-15-2010

Thanks! Assigning these permissions resolved my issue.

lamw · ‎10-15-2010

@Altix,

Thanks for the feedback, I'll go ahead and update the script so it checks for these permissions before proceeding, this way the user knows what the issue is.

Thanks

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP-DCA4

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

lamw · ‎10-15-2010

@dgriffin@thinksis.com

I believe I've located the problem, we'll update in the next release and you should see a fix come out pretty soon.

Thanks

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP-DCA4

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

benruset · ‎10-15-2010

I'm running the script (which is wonderful, by the way) but things like the mem reservation, cpu reservation, etc. are all showing up as N/A. Now, a lot of our VM's do not have memory/CPU reservations, but we want to find out which ones do.

Is there something special I need to do to see real numbers here?

Thanks!

lamw · ‎10-15-2010

@truo1van,

I'll look into #1 as a possibility, though #2 and #3 is something that's beyond the scope of the report, I don't want to start adding all these custom reports which can make the overall report bloated. If you're interested in those statistics, you're more than welcome to add those changes but it will not be something I'll be doing.

Thanks

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP-DCA4

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

lamw · ‎10-15-2010

@benruset,

If there are memory/cpu reservations configured for a VM, you should see the field being populated, unless you turned off the reporting option which I believe is controlled by VM_RESOURCE_ALLOCATION. By default this information is enabled for reporting

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP-DCA4

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

benruset · ‎10-15-2010

Well, I definitely have reporting enabled (tried using the config file as well as omitting it) and came up with the same result each time. Is there anything on the VMware side that might be causing a problem? I'm running the script with the same credentials that I use to manage VMware so it shouldn't be a permissions thing.

Markus_Jaekel · ‎10-18-2010

Hello,

changed line 3765 from

my $listOfVMs = Vim::get_views(mo_ref_array => $_->vm, properties => );

to

my $listOfVMs = Vim::get_views(mo_ref_array => $_->{'vm'}, properties => );

and now it works like a charm.

vancod · ‎10-21-2010

Interesting discovery with 4.1.4 and RDMs

This all relates to the "VM tab"

The RDM count is "off" for a pair of Microsoft Cluster members in the

"VM Storage"

section (that gets the pretty color codes) - one shows 10 disks (correct) the other only 2. NOTE that all RDMs DO
display correctly in the "VM RDMs" section

Is this possible because the RDMs are shared resources? (my guess) There are actually 12 RDMs between these two machines (which jives with the "total drive count" above), with 7 of them being fully shared resources

eqj · ‎10-25-2010

hostlist doesn't seem to work for me.

I am specifying --server and --hostlist hostlist.txt but it only queries the host under the --server parameter.

I could just run the script for each host, but would be nice to get it all under one report.

Any ideas?

lamw · ‎10-25-2010

The --hostlist is only valid when using in conjunction with vCenter server which is specified using --server parameter. If you to query individual ESX(i) host, you can run through a simple for loop on the vMA shell or wherever you're executing the script and just rename the output file to match the individual host

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP4-DCA

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

eqj · ‎10-26-2010

So when using --hostlist, it will create separate HTML files anyway? I just wanted a single report including all hosts. Is this possible? Thanks.

lamw · ‎10-26-2010

@eqj,

No, it's still a single HTML document but it'll only capture data based on the hostlist, this is used in case you only care about certain ESX(i) host and do not want all hosts in your vCenter server.

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP4-DCA

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

eqj · ‎10-27-2010

OK thanks for the info. I don't use vCenter so it there any way to gather data for several hosts in a single HTML file?

lamw · ‎10-27-2010

No, to aggregate the data for multiple hosts, you must be using vCenter. If you have individual hosts, you'll only be able to generate individual reports.

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP4-DCA

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

MKguy · ‎11-01-2010

I'm using 4.1.4 an had the same problem as Markus Jaekel with line 3791, but only since I defined Host-VM DRS affinity rules.

I tried to change the line from:

my $listOfVMs = Vim::get_views(mo_ref_array => $_->vm, properties => );

to

my $listOfVMs = Vim::get_views(mo_ref_array => $_->{'vm'}, properties => );

The script now completes but I got 4 of the following warnings and no email:

Use of uninitialized value in concatenation (.) or string at /home/vi-admin/scripts/healthcheck2/vmwarevSphereHealthCheck.pl line 3798.

Scratch that with no mail, it just hung in some queue on the way orz.

eqj · ‎11-03-2010

Is there any way to force a refresh of the data on VSphere? For example when I run the health check, it reports the free space on the datastores as seen in VSphere and does not refresh the data. Problem is that VSphere does not automatically refresh this data.

vancod · ‎11-03-2010

You could probably modify the script to run an esxcfg-rescan on all HBAs - but one issue I could foresee is the time it takes to complete. By way of example the last 8 node, dual-HBA, 8 path cluster I canned took about 2 minutes for all nodes to complete.

It's a great idea, but may be hard to put into practice given the above and the requirements to pass the interface name (but default names would likely cover 99.99% of us)

eqj · ‎11-09-2010

Doesn't rescan scan for new storage? Do you know which CLI command VSphere uses to refresh the storage space data?

Is it possible for this script to send a separate email if any alarms are raised? Such as low disk space, high CPU/Mem usage etc?

rhor · ‎11-23-2010

Hello all,

I had some problems running this script as I was constantly getting the following output:

-

D:\scripts>D:\scripts\vmwarevSphereHealthCheck.pl -server IP_address -username

user -password passphrase -type datacenter -datacenter "Datacenter_name" -report D:\scripts\vmware_health_check.html

Generating VMware vSphere Health Report 4.1.4 "D:\scripts\vmware_health_check.html" ...

This can take a few minutes depending on environment size.

Get a cup of coffee/tea and check out http://www.virtuallyghetto.com

Can't use an undefined value as an ARRAY reference at D:\scripts\vmwarevSphereHe

althCheck.pl line 468.

-

I have created new role for this script purpose giving the following permissions to it and a test account assign to this role:

Datastore.Browse

Global.Diagnostics

Global.Licenses

Sessions.ValidateSession

but I didn't help and i still got the same problem.

After changing credentials to admin account the script ran without any problem, generating report file. What's weird to me is that after i created a copy of admin role and assigned my test account to it, it still generates error on line 468. Have anyone encountered any similar issue ?

Also after generating report on my administrator account i did notice that tabs VMware/3rd Party Applications, Cluster, Host and Virtual Machines are blank is there any additional option needed to get content of that tabs?

VMware vCenter Server 4.0.0

vSphere 4 Enterprise esxEnterprise

ESXi 4 Single Server esxBasic

vCenter Server 4 Standard vc

script is run from machine with powerCLI and vSphere SDK for Pearl installed.

fbroussey · ‎11-23-2010

Hello,

Great script.

But I got the following error message the second time I execute the script :

$ ./vmwarevSphereHealthCheck.pl --server vcenter41.enneade.local --username xxxxxxxx --password xxxxxxxx --type vcenter --conf healthCheck.conf

Generating VMware vSphere Health Report 4.1.4 "vmware_health_report.html" ...

This can take a few minutes depending on environment size.

Get a cup of coffee/tea and check out http://www.virtuallyghetto.com

Wide character in print at ./vmwarevSphereHealthCheck.pl line 532.

Undefined subroutine &ClusterVmHostRuleInfo::vm called at ./vmwarevSphereHealthCheck.pl line 3791

$

From that moment it doesn't work anymore ...

Any idea ?

Thanks a lot

Regards

Markus_Jaekel · ‎11-23-2010

@fbroussey

I had the same problem please see my comment above how to resolve it with version 4.1.3.

I think it will work if you change the corresponding lines in version 4.1.4

fbroussey · ‎11-23-2010

yes Markus that works !

Thanks for you help

monderick · ‎12-02-2010

is there any indication available for why all VM affinity rules show as compliant : NO and colored red?

thanks

lamw · ‎12-03-2010

@fbroussey @Markus Jaekel

What change was made? I'll add this to the fixes for a future release.

Thanks

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP4-DCA

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

lamw · ‎12-03-2010

I'm not exactly sure what you mean by this? Can you provide a screenshot of the report with regards to affinity rules?

Thanks

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP4-DCA

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators

If you find this information useful, please award points for "correct" or "helpful".

monderick · ‎12-03-2010

All of our Affinity rules are marked as red and non-compliant.

The below example is configured to keep two VM's separated on a 3 host cluster, which they currently are.

!http://img687.imageshack.us/img687/9296/capturebb0.jpg|src=http://img687.imageshack.us/img687/9296/...

Uploaded with ImageShack.us

thanks

lamw · ‎12-03-2010

It looks like per the API documentation - http://www.vmware.com/support/developer/vc-sdk/visdk41pubs/ApiReference/vim.cluster.RuleInfo.html the property inCompliance which is being used to generate the value is not actually being used by the server. This may just be a default value of false since it's not being used by the system and that is how the color is being generated.

You can ignore this as being false positive, looks like VMware introduced the property but may not be actively useing it.

=========================================================================

William Lam

VMware vExpert 2009,2010

VMware VCP3,4

VMware VCAP4-DCA

VMware scripts and resources at:

VMware Code Central - Scripts/Sample code for Developers and Administrators