Table of Contents


AppFirst has the framework to support devices that run in customer environments. This can be any type of device we can collect metrics from where our standard supported collectors can’t run directly. Types of devices include switches, routers, and unsupported or legacy operating systems.

Currently the Device feature supports: ESXi

How to set up a Device

Install script on monitoring server for ESXi

Scripts are assigned to a real server so they can be executed. On a server, with a collector installed and streaming, install the device script.

VMware ESXi device script:
sudo tar -xvzPf vmware-esxi.tgz

This script uses python suds module. If it is not installed, please run the appropriate command found below.

If you are on a Debian/Ubuntu server, use this command:
apt-get install python-suds

If you are on a Redhat/CentOS server, use this command:
yum install python-suds

Setup Device

Navigate to the Devices tab on the Admin – Setup page. On the Devices tab, click the “Add a new Device” button in the upper right hand side of the page to setup the Device.


A dialog box will open asking for details about the device profile you are creating. Device Nickname, IP Address, Monitoring Server and a Device Profile are all required.

Create Device Profile

If you don’t have an appropriate device profile setup yet, click the Create new profile button which can be found to the right of the Device Profile dropdown.


The dialogue box will expand to include a Device Settings Profile. Device Settings Name and Device Type are required fields.


Viewing Devices


You can set up a Metric Widget to see your devices displayed on your Dashboard. Devices are also supported by Server Sets, so you can display Device details in System Widgets as well.


Devices show up in the server list by their Device Nickname. You will also be able to see your device under the Polled Data tab in the Servers page.

*Note: if a device seems to be taking a long time to show up or update, check your Nagios Frequency on your Monitoring Server (Collectors – Edit – Nagios Frequency).

Troubleshooting Tip: if your device reports the OS as Linux 32 (by default), you’ve added a device to a monitoring server without the script installed. Simply install the script on the appropriate monitoring server or change what server is the monitoring server for that device.


Basic system details can be seen by finding your device under Server/Device. If you’d like to see more categories and more detail on what your device is doing, you can find that under Polled Data.

Alerting on Devices

You have the ability to alert on Devices added in AppFirst. Simply navigate to Admin – Setup – Alerts and click the Add a new Alert button on the far right side. Default alert settings for Devices are the same as default alerts settings for servers, except that Collector Down alert is triggered after 15 minutes, and sets a trigger minimum of 10 minutes.