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.
For information on installing this extension on the various supported platforms, see Installing the IBM HTTP Server monitoring extension.
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
- Open the httpd.conf file in a text editor.
- Uncomment the line:
- Windows:
LoadModule status_module modules/ApacheModuleStatus.dll
- UNIX:
LoadModule status_module libexec/mod_status.so
- Windows:
- 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)
- Uncomment the line
- 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>
- Save and close the file.
- Restart the HTTP Server.
- Repeat this process for each HTTP Server you are monitoring.
Note
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.
- Open a command prompt and change to the directory containing the distributed files.
- 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 Windowsqphttp --start
starts the monitoring extension; in UNIX./qphttp.sh --start
starts the monitoring extension.
Note
The kill -9 command. (UNIX only) If you use the kill -9 command to stop the IBM HTTP Server monitoring extension, remove the .lock files (qpea.lock and qpwas.lock).
If the TMTM Extensible Agent or monitoring extension did not shut down gracefully, remove the .lock files (qpea.lock, and qpwasmon.lock) before starting it again. The lock file prevents multiple processes from running at the same time.
BEFORE STARTING: Change to the agent installation directory and enter qpea --status
to check if the TMTM Extensible Agent is running. If it is not running, enter qpea --start
When starting the monitoring extension, if you have not installed the monitoring extension as a Windows service, enter qphttp --console
to start the monitoring extension in the foreground.
Comments