SevOne logo
You must be logged into the NMS to search.

Table of Contents (Start)

HTTP Plugin

The HTTP plugin is automatically enabled when you add a new device to SevOne NMS to enable you to monitor the following indicators for the websites you specify for the device to poll.

  • Availability - (Percentage) Whether the website could be reached or not.

  • Bytes Downloaded - The number of bytes downloaded for the page (including images, if specified).

  • Certificate Error - (Percentage) If the page had a certificate error.

  • Error Status - (Percentage) The error status of the page.

  • Integrity - (Percentage) The number of successful integrity tests of the number of tests run.

  • Retries - The number of retries to reach the page.

  • Time For Connection - The time until the connection was made.

  • Time For Downloading - The time until the download was complete.

  • Time For Name Lookup - The time until the name lookup was made.

  • Time Until Transfer - The time until the transfer began.

  • Server Availability - Whether the Web server responded or not.

  • HTTP Status Code - The HTTP code returned by the Web server (for example, 404 is "Page not found").

  • Redirections - The number of times that the application was redirected until the page was finally reached. The HTTP poller supports up to five redirections.

If your network uses an HTTP proxy server and you want to poll HTTP data through the proxy server, the Cluster Manager > Peer Settings tab enables you to define the HTTP proxy server settings to use to poll HTTP data via the proxy server.

Perform the following steps to enable the HTTP plugin for each device from which you want to poll HTTP metrics.

  1. From the navigation bar, click the Devices menu and select Device Manager.

  2. Either add a device with the HTTP plugin or edit a device to enable the HTTP plugin.

  3. images/download/attachments/163972806/triangledown-version-1-modificationdate-1693242694639-api-v2.png - Click the plugin drop-down (displays SNMP by default) and select HTTP.

  4. Select the Monitor HTTP Data check box.

  5. On the New Device page, click Save as New to display the Edit Device page to perform the next steps.

  6. On the Edit Device page, click Edit Monitoring Information to display the HTTP Objects for <device name> pop-up.

  7. On the HTTP Objects for <device name> pop-up, click images/download/attachments/163972806/actionold-version-1-modificationdate-1693242694624-api-v2.png and select Create New to display fields to enable you to specify the HTTP objects to poll on the device.

  8. In the Name field, enter the website name.

  9. In the Address (URL) field, enter the Web address to poll with the user name and password in the following format; username:password@webaddress.

    Example

    http: or https://jerry:changeme@www.test.com/membersarea

    Note: You need to upload a certificate on the Authentication Settings page to use https.

  10. In the Description field, enter the description to display.

  11. Select the Download Images check box to download images from the website.

  12. Select the Check Error Codes check box to define alert options for the object.

    1. Click the 300 Range drop-down and select the alert severity level to display when a code in the 300 range is received.

    2. Click the 400 Range drop-down and select the alert severity level to display when a code in the 400 range is received.

    3. Click the 500 Range drop-down and select the alert severity level to display when a code in the 500 range is received.

    4. Select the Acknowledge Outstanding Messages check box to acknowledge (clear) all alerts for the previous three range settings for this object when a code in the 200 range is received.

  13. Click the Integrity Severity drop-down and select the severity level to assign to the alerts that trigger when violations of the expression occur.

  14. Perform the following steps to define website integrity expressions for the object. An expression consists of a match test and a full regular expression.

    1. Click images/download/attachments/163972806/actionold-version-1-modificationdate-1693242694624-api-v2.png in the Integrity Expression list and select Create New to display a new row in the list.

    2. Select the Enabled check box to enable and save the expression. Clear the Enabled check box to delete the expression.

    3. In the Name field, enter the expression to display as the alert name.

    4. Click the Expression drop-down.

      • Select Must Match to trigger an alert when the expression is not found anywhere on the page.

        Example

        Enter Product in the expression field. If the word Product is not found, an alert triggers.

      • Select Must Not Match to trigger an alert when the expression is found anywhere on the page.

    5. In the Expression field, enter the Perl regular expressions to match/not match. For details, please refer to section Perl Regular Expressions in SevOne NMS System Administration Guide.

    6. Repeat the integrity expression steps to add additional integrity expressions to the object.

  15. Click Save This Object. When you create an expression, the expression appears in the list for the object.

  16. Repeat the steps to create additional objects.

  17. Click Return To Edit Page to return to the Edit Device page.

HTTP Poller Timeouts

The HTTP Poller uses two timeouts.

  • a 5 second connection timeout, which is the maximum length of time it will spend attempting to establish a connection to the URL, including name resolution.

  • a 30 second overall timeout to fetch the page, including the connection time.

Given the default Linux name resolver timeout of 5 seconds, this means that if the primary DNS is unreachable (as set in /etc/resolv.conf), the connection will time out. The users must ensure that the primary DNS is reachable in an adequate time for the connection process to complete under the 5 second timeout.