This section details the options in the configuration schema for the "HTTP" service type.

The tables below define the options in the configuration schema for the "HTTP" service type. These are the resource attributes that are displayed, and may be edited, on the Configuration Properties page for an HTTP service, shown above.

The first table defines options specified explicitly in the HTTP configuration schema. The other tables document the options included from "building block" schemas. The far right column contains the name of the configuration schema that defines it.

For the HTTP service type, the netservices plugin descriptor sets value of:

  • port to 80

  • sslport to 443

Table 1. HTTP Configuration Options

Name

Description

Default

Optional

Type

Notes

Parent Schema

method

Request Method

HEAD

false

enum

Allowable values: HEAD, GET. Method for checking availability. HEAD results in less network traffic. Use GET to return the body of the request response if you wish to specify a pattern to match in the response.

http

hostheader

Host Header

none

true

N/A

Use this option to set a "Host" HTTP header in the request, useful if you use name-based virtual hosting. Specify the host name of the Vhost's host, for example,

blog.hyperic.com

http

follow

Follow Redirects

enabled

true

boolean

Enable if the HTTP request that Hyperic generates will be re-directed. This is important, because an HTTP server returns a different code for a redirect and Hyperic will assume that the HTTP service check is not available if it is a redirect, unless this redirect configuration is set.

http

pattern

Response Match (substring or regex)

none

true

N/A

Specify a pattern or substring that Hyperic will attempt to match against the content in the HTTP response. This allows you to check that in addition to being available, the service is serving the content you expect.

http

proxy

Proxy Connection

none

true

N/A

If connection to the HTTP service will go through a proxy server, supply the hostname and port for the proxy server. For example, proxy.myco.com:3128

http

path

Path

/

false

N/A

Enter a value to monitor a specific page or file on the site. for example: /Support.html

url

ssl

Use SSL

false

true

boolean

N/A

ssl

hostname

Hostname

localhost

false

N/A

Hostname of system that hosts the service to monitor. For example: mysite.com

sockaddr

port

Port

A default value for port is usually set for each type of network service by properties in the netservices plugin descriptor.

false

N/A

Port where service listens.

sockaddr

sotimeout

Socket Timeout (in seconds)

10

true

int

The maximum amount of time the agent will wait for a response to a request to the remote service.

sockaddr

realm

Realm

N/A

true

N/A

Supply security realm if target site is password-protected.

basicauth

user

Username

N/A

true

N/A

Supply if target site is password-protected.

credentials

pass

Password

N/A

true

secret

Supply if target site is password-protected.

credentials