Nutanix : Php, API, AHV Reporter !

Background

Because I had to share this with you a long time ago, I decided to do it now. There is a Nutanix employee (Magnus Andersson, VCDX56, from Sweden) who created a wonderful reporting script for AHV-based Nutanix clusters. This script is written in bash and I think, this is a good opportunity for me to share my Nutanix php Framework. So, I decided, with his consent, to port his script into php. This is a good way to introduce my php framework ;)

Let's do this

So, what is this AHV Reporter all about ? This is based on Magnus initiative who generate a csv file with all the details about your VMs, IP, disk usage, vCPU whatever. This could be useful to (re)size a cluster or plan migration. The original script can be found here and here.

Once the layout is done, you have something similar to this :

So first, you need to have a look at my GitHub repository about this Nutanix php Framework. Then, there is a credential file and the script itself.

<?php
$clusterConnect=array(
"username" => "user",
"password" => "password",
"ip" => "ip_address"
);

?>

Once you have moved the three files (nxFramework.php, nxAHVReporter.php, nxCredentials.php) in the same folder and adjusted the nxCredentials.php file to match your environment, you can run the script :

$ ./nxAHVReporter.php

Nutanix Prism Element ip_address will be used to collect information.

=================================================================
Creating reporting input for VM xxxx now (1/63) .....
=================================================================
VM Description : No VM Description Information Available
VM Uuid : fb965551-a9de-493a-9512-7186cd088bc0
Power State : off
vCPU : 2
vCore : 2
Memory : 2 GB
Host : VM Not Powered On
Network : 018b6662-deba-41f9-99f0-32dda634d86d
[...]

You can decide to have the script in debug mode and return a lot of outputs on the screen ... or not :

// Enable debug mode -> chatty screen output 
$debug=true;

Once the script is completed you will find a .CSV file generated in the current directory. This is your report. Of course, the report needs to be layout as you wish. Excel will help you to get it nice with text-to-column functions and all the relevant filtering capabilities. I let you decide how you want your report to be !

Do not hesitate to report any bug or unexpected behaviors that could help improving the tool.

Big thanks to my fellow Nutanix NTC Christian Pedersen who assisted me during the development phase.

Hope this help !