NAME

apache_accesses - Munin plugin to monitor the number of accesses to Apache servers. It handles a list of ports passed in from a plugin configuration file.

APPLICABLE SYSTEMS

Apache HTTP servers with /server-status enabled.

CONFIGURATION

The plugin needs access to http://localhost/server-status?auto (or modify the URL for another host). See your Apache documentation on how to set up this URL in your httpd.conf. Apache needs ExtendedStatus enabled for this plugin to work.

Tip: To see if it's already set up correctly, just run this plugin with the parameter "autoconf". If you get a "yes", everything should work like a charm already.

This configuration section shows the defaults of the plugin:

  [apache_*]
     env.url   http://127.0.0.1:%d/server-status?auto
     env.ports 80

The %d in the url will be replaced with the port. The default port is 80 as shown.

The port list is a space separated list of ports. NOTE that one single Apache can have several open ports, and the plugin needs only to contact one to get the servers global status. The list of ports is only needed if you have several different Apaches configured on your host.

If you need authenticated access to the URL you can specify the username and password in the URL. For example:

  [apache_volume]
     env.url http://munin:spamalot@localhost/server-status?auto

This will provide for HTTP basic authentication.

INTERPRETATION

The plugin shows the number of accesses (pages and other items served) globally on the Apache server.

MAGIC MARKERS

  #%# family=auto
  #%# capabilities=autoconf

VERSION

  $Id$

BUGS

Does not support digest authentication.

AUTHOR

Unknown

LICENSE

GPLv2