apache_processes - Munin plugin to monitor the number of apache-processes running on the machine.


Apache HTTP servers with /server-status enabled.


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:

     env.ports 80
     env.showfree 1

The %d in the url will be replaced with the port. The default port is 80 as shown. 'showfree' enables the disaplay of the "free slots" graph.

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:

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

This will provide for HTTP basic authentication.

It is possible to use HTTPS for accessing the server. You just need to make sure, that the server certificate is valid (i.e. it is signed by a locally known CA and it matches the hostname in the URL). If you really need to connect to an HTTPS URL without a valid certificate (as described above), then you should try to set one of the following environment settings in the munin-node plugin configuration:

  env.HTTPS_CA_FILE /etc/ssl/acme-ca.pem
  env.HTTPS_CA_DIR /etc/acme-ca-certs/

See for more details.


The plugin shows the number of Apache processes running on the machine, and in addition separate "busy" and "idle" servers count.

If there is a flat ceiling effect on the graph where the number of servers does not increase any more, in spite of no idle servers, then the server has probably reached its MaxClients setting. In this case it's very likely that some clients are getting connection refused or some other problem when connecting to your server. In this case increase the MaxClients setting. Unless there is also no more free memory.


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


Does not support digest authentication.