Since vSphere Bitfusion 4.0, by using a monitoring application and configuring monitoring plug-ins, you can observe detailed information of the virtual machines (VMs) of your vSphere Bitfusion servers and related services. For example, you can periodically check the load averages and disk space usage of the server VMs.

Understanding the Monitoring Plug-Ins Package

Typically, by using a monitoring application on a VM, you can run multiple plug-ins to determine the status of hosts and services in your environment. Since vSphere Bitfusion 4.0, you can monitor the vSphere Bitfusion servers in your cluster by using the Monitoring Plug-ins Package, which is pre-installed on all vSphere Bitfusion servers. The package contains more than fifty standard plug-ins for monitoring applications, such as Icinga, Naemon, Nagios, Shinken, Sensu. Each plug-in is a standalone command-line tool which performs a specific type of check.

Some plug-ins allow you to perform local checks of your system metrics, such as load averages, processes, or disk space usage, while others use various network protocols, such as ICMP, SNMP, HTTP, to perform checks remotely. For more information, see the Monitoring Plugins Project documentation.

Configuring the Monitoring Plug-ins Package

To use the plug-ins in the Monitoring Plug-ins Package and run check commands in your monitoring application, first you must configure the check_by_ssh plug-in of your monitoring application to securely connect to the VMs of yourvSphere Bitfusion servers without using a password. Then you add the VMs to the list of monitored hosts and the specific monitoring checks.

  1. Connect to the VM of your vSphere Bitfusion server by using Secure Shell Protocol (SSH) and enable the password of the monitoring account, where IP_BF_VM is the IP of the VM of your vSphere Bitfusion server.
    export bfm_ip=IP_BF_VM
    ssh customer@$bfm_ip
    sudo passwd monitoring
  2. Copy the public key of your monitoring account to the authorized_keys folder.

    scp ~/.ssh/id_rsa.pub monitoring@$bfm_ip:~/.ssh/authorized_keys

  3. In your monitoring application, add the vSphere Bitfusion server VM to the list of monitored hosts.
  4. From the VM of your monitoring application, run the ssh monitoring@$bfm_ip command.

    You must be able to log into the vSphere Bitfusion server VM without using a password. If you are prompted for a password, the public key that is stored in the authorized_keys folder is not the same as the public key of the monitoring account.

  5. To verify that the check_by_ssh plug-in and check commands are working, from the VM of your monitoring application, run the $ /usr/lib/nagios/plugins/check_by_ssh -H $bfm_ip -l monitoring -C '/usr/libexec/check_disk --units GB --critical 15 -p /' command.

    The result must return that the disk space is sufficient because the disk has more than 15 GB of free space. For example, DISK OK - free space: / 36 GB (78% inode=98%);| /=10GB;;34;0;4.

  6. Add monitoring checks by using the check_by_ssh plug-in of your monitoring application.

    You can refer to the documentation of your monitoring application, such as Icinga, Naemon, Nagios, Shinken, Sensu, for instructions about how to add monitoring checks by using the check_by_ssh plug-in.