About

PyMunin Munin Multigraph Monitoring Plugin for APC PHP Accelaration Cache.

The PHP script apcinfo.php must be placed somewhere in the document root and have access permissions from localhost to permit retrieval of stats from APC. The script can be found int the external utilities folder ext folder of PyMunin distribution.

Multigraph Plugin: Yes
Multi-instance Plugin: Yes

Graphs

The plugin implements the following graphs:

  • php_apc_memory

  • php_apc_items

  • php_apc_reqs_filecache

  • php_apc_reqs_usercache

  • php_apc_expunge

  • php_apc_mem_util_frag

  • php_apc_mem_frag_count

  • php_apc_mem_frag_avgsize

Configuration

Configuration variables are passed to the Munin Plugins using environment variables. The environment variables for plugins are usually set in the plugin configuration files in the folder: /etc/munin/plugin-conf.d

The configuration variables implemented by the plugin are listed in the following table:

Variable Description
host Web Server Host.
(Default: 127.0.0.1)
port Web Server Port
(Default: 80, SSL: 443)
user User in case authentication is required for access to PHP APC Status page.
password Password in case authentication is required for access to PHP APC Status page.
statuspath PHP APC status script path relative to Document Root.
(Default: apcinfo.php)
ssl Use SSL if yes.
(Default: no)
include_graphs Comma separated list of enabled graphs.
(All graphs enabled by default.)
exclude_graphs Comma separated list of disabled graphs.

Additionally the following configuration variables are implemented by the plugin for Multi Instance support:

Variable Description
instance_name Name of instance.
instance_label Graph title label for instance. (Default is the same as instance name.)
instance_label_format Controls how the instance label will be added to the graph title:
  • suffix (Default)
  • prefix
  • none

Credits

APC PHP Cache Plugin ( phpapcstats ) has been developed by Ali Onur Uyar ([aouyar @ GitHub] (https://github.com/aouyar)).

License

APC PHP Cache Plugin ( phpapcstats ) is copyrighted free software made available under the terms of the GPL License Version 3 or later.

See the file COPYING that acompanies the code for full licensing information.