Configuring Web Server Status Device Modules

Estimated Reading Time: 2 Minutes

Configuring the Web Server Host

Apache

Ubersmith's Web Server Status device module takes advantage of the mod_status Apache module. You will need to configure this module on your host before your Ubersmith appliance.

To enable status reports only for browsers from the mydomain.com domain add this code to your httpd.conf configuration file:

<Location /server-status>
SetHandler server-status

Order Deny,Allow
Deny from all
Allow from .mydomain.com
</Location>

In most cases, the value for 'Allow from' should at least include the IP of your Ubersmith appliance. Please use caution when enabling this feature in Apache, as if misconfigured it could allow sensitive data about your server to be made available to third parties.

nginx

Follow the instructions available here.

lighttpd

Follow the instructions available here.

Configuring the Ubersmith Device Module

Model

Select the appropriate HTTP daemon that you wish to monitor from the drop down menu.

Address

Specify the IP address at which your HTTP host can be reached.

Port

By default, most web servers will listen for connections on TCP port 80. If you have configured your web server to listen on an alternative port, change it to the appropriate value here.

Update Interval

Set the 'Update Interval' to 1 to enable polling, 0 to disable polling.

Post-Configuration

Once configured, your Ubersmith appliance will begin to poll your HTTP daemon for data. The module will show a 'Total Usage' with connection activity. Clicking on the link will show a graphical representation of the data over time.

Configuring Web Server Status Monitoring

Once you have confirmed that your appliance is collecting data successfully from your web server, you may wish to configure monitoring. Click the 'Monitors' tab for the device you are working with, and then click 'Add Monitor' on the orange bar. This will provide you with a popup to add a new monitor.

Protocol

Set this drop down to 'Module'.

Address

Leave this configured as 'No Address Selected'.

Module

Set this drop down to 'Webserver Status'.

The remaining items can be configured as described in the knowledge base article Adding and Configuring a Monitor . Once you have completed configuring the 'Details' tab, click the 'Config' tab.

Maximum Active Connections

Have Ubersmith send a notification if your web server exceeds this number of active connections.