Apache (Windows) template

This template retrieves Apache server statistics from the built-in Apache server-status web page using PowerShell script.

Prerequisites:

libwww-perl is installed. You can use this command: yum install perl-libwww-perl.noarch

Perl can access the Apache server-status page

If using port 443 instead of default port 80, the script cannot bypass certificate errors. Click here for a workaround.

Access Configuration

To configure Apache to allow access to the server-status page:

  1. Log on to your Apache Windows server.
  2. Locate the Apache configuration file, typically in httpd.conf.
  3. Append the following lines to your httpd.conf. You should allow access to server-page for your domain. Replace APM_host with the IP address or hostname of the Orion server.
    <Location /server-status>
    SetHandler server-status
    Order Deny,Allow
    Deny from all
    Allow from APM_host
    </Location>
    ExtendedStatus On
  4. Ensure that the following line is uncommented and present in the httpd.conf file: LoadModule status_module modules/mod_status.so
  5. Restart the Apache server.

Credentials

Administrator on the Orion server (all monitors run locally).

Before using this template, set up the following argument in component monitors: 

server,server_port

where

  • server – This is the hostname or IP address of the target Apache server. Set this argument to ${IP} to automatically replace it with the target host IP address.
  • server_port - This is the Apache port under which the site is running. By default, it is set to port 80.

For example, set the Scripts Arguments field to ${IP},8080

If you receive a "Cannot connect to local host" error, refer to this article.

Component monitors

To learn more about default component monitors included in SAM, see SAM online help.

Server Uptime

This counter returns the time, in seconds, that the server has been up.

Idle Workers

This counter returns the number of free workers ready to handle client connections. This value should be as high as possible. If you have no idle workers, or very few, Apache may be using all of the processes it is allowed and new, incoming requests must wait for older requests to finish before they can be handled. If so, increasing the maximum number of allowed processes in your configuration file might help with performance.

Total Accesses

This counter returns the total number of accesses.

Total Traffic

This counter returns the total number of kilobytes this server has served.

Server Requests Per Second

This counter returns the average rate of all requests per second. The result is calculated as the total number of requests throughout the life of the server (count) and divided by the total uptime in seconds (up_time).

Server kB Per Second

This counter returns the average rate of kilobytes served per second..

Server kB Per Request

This counter returns the average number of kilobytes per request.

Busy Workers

This counter returns the number of busy workers serving requests. This counter should be as low as possible.