9.48. Configuration for the webapp check.

webapp does a HTTP-Request to the given host and asks for a given URL. The return text has to match your configuration.

With this check, you can check web servers like Apache or IIS, web application servers like tomcat or WebSphere, your CGI infrastructure (with database backend), ... .

WEBAPP

Explanation

WEBAPP is the enclosing tag for all APP2CHECK entries.

Parent

OSAGENT

allowed values

Count

0 or 1. If you don't define WEBAPP, no webapp check will run.

Example
<WEBAPP>
  <APP2CHECK>
    <APPNAME>ImportantNewsWeAreAddictedTo</APPNAME>
    <HOST>www.heise.de</HOST>
    <PORT>80</PORT>
    <HTTPRQST>GET / HTTP/1.0</HTTPRQST>
    <TEXT2CHECK>Datenschutzhinweis</TEXT2CHECK>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
  </APP2CHECK>
</WEBAPP>
        

APP2CHECK

Explanation

For every web application you want to check you define one APP2CHECK-pair

Parent

WEBAPP

allowed values

Count

As many as you like.

Example

Look at WEBAPP

APPNAME

Explanation

This entity describes the name you want to associate with your web application you are going to check. You can choose any string as you like. For example "ImportantNewsWeAreAddictedTo" or simply the URL "www.heise.de" would both be valid config values. Please note: Even if you specify an URL in this tag this has absolutely no influence on the URL webapp is going to connect to. It is just a name tag. Nothing more, nothing less.

Parent

APP2CHECK

allowed values

plain text strings

Count

1

Example

Look at WEBAPP

HTTPRQST

Explanation

The HTTP request we are going to send to our target host.

Level

Check

Importance

mandatory

allowed values

valid HTTP requests, eg:

  • GET http://opensmart.sourceforge.net/index.html HTTP/1.0
                

    If you define HOST as 'opensmart.sourceforge.net', that is the same hostname as defined in the URL, you can test a webserver for a simple webpage.

    If you define HOST as your proxy, you can test the proxy.

  • GET http://host/cgi-bin/script.cgi?variable=value HTTP/1.0
                

    to test a cgi script.

Count

1

Example

Look at WEBAPP

SSL

Explanation

This entity describes whether speak HTTPS (SSL) or not. Please note: IO::Socket::SSL must be installed using this option!

Parent

APP2CHECK

allowed values

YES

NO

Count

0 or 1

Example

Look at WEBAPP

TEXT2CHECK

Explanation

The text we are expecting in our received HTTP answer.

Parent

APP2CHECK

allowed values

plain text string or perl regex

Count

1

Example

Look at WEBAPP