Running the IBM HTTP Server monitoring extension

The HTTP Server monitoring extension monitors and reports activity from IBM HTTP Server for WebSphere Application Server. The information is then passed to the TMTM Extensible Agent. Each monitoring extension monitors one HTTP Server.

The monitoring extension files are contained in an archive file that must be extracted into the TMTM Extensible Agent directory.

When the HTTP Server monitoring extension is running, TrueSight Middleware and Transaction Monitor displays HTTP Server performance data in the Monitor Console. The following are the types of information collected by the monitoring extension:

• busyServers - number of servers running.
• bytesPerRec - number of bytes to a request.
• bytesPerSec - number of bytes sent in a second.
• HostStatus - is the monitored HTTP Server running.
• idleServers - number of servers not running.
• requestsPerSec - number of requests received in a second.
• totalAccesses - total number of times the HTTP Server has been accessed.
• totalKBytes - total number of kilobytes transferred.
• uptime - length of time the HTTP Server has been running.

If you have not already distributed your TMTM Extensible Agent and monitoring extension files, then do so now. See Distributing the Agent and extensions via the launch page.

This section includes:

Configuring the IBM HTTP Server for monitoring

1. Open the httpd.conf file in a text editor.
2. Uncomment the line:
   • Windows: LoadModule status_module modules/ApacheModuleStatus.dll
   • UNIX: LoadModule status_module libexec/mod_status.so
3. Do one of the following:
   • Uncomment the line ExtendedStatus On
   • If the line ExtendedStatus On is not present, add it after the LoadModule section (or anywhere in the file)
4. Uncomment the Location elements change the settings as shown:
   
   <Location /server-status>
SetHandler server-status
Order allow, deny
Allow from hostname.host.com
Allow from hostname.host.com
</Location>
5. Save and close the file.
6. Restart the HTTP Server.
7. Repeat this process for each HTTP Server you are monitoring.

Controlling the IBM HTTP Server monitoring extension on Windows or UNIX 

The HTTP Server monitoring extension runs as a Java process. If you want to work directly with the process on UNIX, use the ps command to find the active Java processes. For Windows, use the Task Manager.

1. Open a command prompt and change to the directory containing the distributed files.
2. Enter the monitoring extension command qphttp (Windows) qphttp.sh (UNIX) followed by the required command parameter.
   
   To list all available command parameters, enter:
   
   For Windows: qphttp --help
   For UNIX: ./qphttp.sh --help
   For Linux: ./qphttpl.sh --help
   
   For example, in Windows qphttp --start starts the monitoring extension; in UNIX ./qphttp.sh --start starts the monitoring extension.