collectd-python-php-fpm-status

PHP-FPM status monitor plugin for collectd, written in python

QUICK START

This plugin can be used in standalone, simply run it and pass a valid PHP-FPM status page url to it:

$ ./phpfpm.py http://localhost/status?json&full

INSTALLATION

1. First edit the fpm pool configuration to enable the status page, for example in Debian/Ubuntu: /etc/php/7.1/fpm/pool.d/my_pool.conf
2. Place phpfpm.py in your CollectD python plugins directory, for example /usr/local/lib/collectd/python/
3. Configure the plugin in CollectD (see below)
4. Restart CollectD

COLLECTD CONFIGURATION

Edit your /etc/collectd/collectd.conf file, it should look like this:

LoadPlugin python
<Plugin python>
    ModulePath "/usr/local/lib/collectd/python"
    Import "phpfpm"
    <Module phpfpm>
            Url "http://127.0.0.2/pool_1_status?json&full"
    </Module>
    <Module phpfpm>
            Url "http://127.0.0.2/pool_2_status?json&full"
    </Module>
    <Module phpfpm>
            Url "http://127.0.0.2/pool_N_status?json&full"
    </Module>
</Plugin>

You can add as many Module instances as you whish, each one pointing to a different server url. Don't forget to add the ?json&full query params, they are essential for this plugin to work.

DATA FORMAT

The data is collected using the format:

phpfpm.pool-gauge-metric for the master process, and phpfpm.pool-process-N.gauge-metric for each child process

Enjoy!