ZenPack:HTTP Monitor

From Zenoss Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search

Note: This is a Core ZenPack which can be found in the Core Zenoss RPM, and is fully documented in the Zenoss Extended Monitoring Guide. If you did not install this pack when you installed Zenoss Core, it can be found in $ZENHOME/packs.

Organization
Zenoss, Inc.
ZenPack name
ZenPacks.zenoss.HttpMonitor
Link to more docs
View Documentation




HTTP Monitor ZenPack

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

Warning

The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.

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

Prerequisite Restriction
Product Zenoss platform 4.2.x, 5.x
Required ZenPacks ZenPacks.zenoss.HttpMonitor
Nagios Plugins Requires 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
    Option Description
    Port The port to connect to HTTP server (default 80).
    Use SSL Use SSL for the connection
    Url Address of the web page.
    Basic Auth User If the website requires credentials, specify the username here.
    Basic Auth Password Password for the user.
    Redirect Behavior If 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
    Option Description
    Regular Expression A Python regular expression to match text in the web page.
    Case Sensitive Is the regular expression case-sensitive or not?
    Invert Expression If 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
    Option Description
    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

Type Name
Performance Collector zencommand

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

Discuss

Purplemarker.png New: Don't forget to add yourself to the Zenoss User Map!

blog comments powered by Disqus