ZenPacks

HTTP Monitor ZenPack

This ZenPack provides status and response time monitoring of HTTP URLs.

Support

This ZenPack is part of Zenoss Core. Open Source users receive community support for this ZenPack via our online forums. Enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.

Background

The ZenPacks.zenoss.HttpMonitor ZenPack monitors the response times of HTTP server connection requests, and determines whether specific content exists on a Web page.

Prerequisites

PrerequisiteRestriction
ProductZenoss platform 4.2.x, 5.x
Required ZenPacksZenPacks.zenoss.HttpMonitor
Nagios PluginsRequires Nagios plugins (check_http)

Enable Monitoring

Follow these steps to enable monitoring:

  1. Select Infrastructure from the navigation bar.
  2. Click the device name in the device list. The device overview page appears.
  3. Expand Monitoring Templates, and then select Device from the left panel.
  4. Select Bind Templates from the Action menu. The Bind Templates dialog appears.
  5. Add the HttpMonitor template to the list of selected templates, and then click Submit. Note: Prior to Zenoss 2.4, this template was not available. If your version is prior to Zenoss 2.4 you must create the template, data source and graphs manually. For more information, refer to Zenoss Service Dynamics Resource Management Administration.


The HttpMonitor template is added to the list of monitoring templates. You can now begin collecting Web server metrics from the device.

Check for a Specific URL or Specify Security Settings

  1. Select Infrastructure from the navigation bar.
  2. Click the device name in the device list. The device overview page appears.
  3. Expand Monitoring Templates, and then select Device from the left panel.
  4. Create a local copy of the template.
  5. Select the newly created local template copy.
  6. Select the HttpMonitor data source, and then select View and Edit Details from the Action menu. The Edit Data Source dialog appears.
  7. Change data source options as needed, and then click Save.
    HTTPMonitor Content Checking Data Source Options
    OptionDescription
    PortThe port to connect to HTTP server (default 80).
    Use SSLUse SSL for the connection
    UrlAddress of the web page.
    Basic Auth UserIf the website requires credentials, specify the username here.
    Basic Auth PasswordPassword for the user.
    Redirect BehaviorIf the web site returns an HTTP redirect, should the probe follow the redirect or create an event? Possible event severities are OK, Warning, and Critical.

Check for Specific Content on the Web Page

This procedure allows Zenoss platform to create an event if content at the web page does not match the expected output.

  1. Select Infrastructure from the navigation bar.
  2. Click the device name in the device list. The device overview page appears.
  3. Expand Monitoring Templates, and then select Device from the left panel.
  4. Create a local copy of the template.
  5. Select the newly created local template copy.
  6. Select the HttpMonitor data source, and then select View and Edit Details from the Action menu. The Edit Data Source dialog appears.
  7. Change data source options as needed, and then click Save.
    HTTPMonitor Content Checking Data Source Options
    OptionDescription
    Regular ExpressionA Python regular expression to match text in the web page.
    Case SensitiveIs the regular expression case-sensitive or not?
    Invert ExpressionIf you would like to test to see if the web page does not contain content matched by a regular expression, check this box.

Tuning for Site Responsiveness

  1. Select Infrastructure from the navigation bar.
  2. Click the device name in the device list. The device overview page appears.
  3. Expand Monitoring Templates, and then select Device from the left panel.
  4. Create a local copy of the template.
  5. Select the newly created local template copy.
  6. Select the HttpMonitor data source, and then select View and Edit Details from the Action menu. The Edit Data Source dialog appears.
  7. Change data source options as needed, and then click Save.
    HTTPMonitor Tunables Data Source Options
    OptionDescription
    Timeout (seconds)Seconds before connection times out (default: 60)
    Cycle Time (seconds)Number of seconds between collection cycles (default: 300 or five minutes)

Monitoring multiple sites

If you want to monitor multiple sites (instead of a single site per host, there is a guide here

Daemons

TypeName
Performance Collectorzencommand

Installation

Normal Installation (packaged egg)

  1. Download the appropriate egg file for the version of Zenoss you are running.
  2. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  3. Install the ZenPack:
    $ zenpack --install ZenPacks.zenoss.HttpMonitor-*.egg
  4. Restart these services:
    $ zenoss restart

Developer Mode Installation

In order to do a development mode installation you will want to clone the existing git repository, and then use the --link flag with the zenpack command:

  1. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  2. Start by cloning the upstream repository:
    $ git clone git://github.com/path/to/repo
  3. Next, perform the installation:
    $ zenpack --link --install ZenPacks.zenoss.HttpMonitor
  4. Finally, restart these serivices:
    $ zenoss restart

Open Source

This ZenPack is developed and supported by Zenoss Inc. Contact Zenoss to request more information regarding this or any other ZenPacks. Click here to view all available Zenoss Open Source ZenPacks.