Skip to content

PHP-FPM

A small shell script that reports the status of PHP-FPM (FastCGI Process Manager).

Install prereqs

apt-get install libfile-slurp-perl libjson-perl libstring-shellquote-perl libmime-base64-perl
pkg install p5-File-Slurp p5-JSON p5-String-ShellQuote p5-MIME-Base64
dnf install perl-JSON perl-File-Slurp perl-String-ShellQuote

Agent or SNMP Extend

  1. Copy the shell script, phpfpmsp, to the desired host

    wget https://github.com/librenms/librenms-agent/raw/master/snmp/php-fpm -O /etc/snmp/php-fpm
    
  2. Make the script executable

    chmod +x /etc/snmp/php-fpm
    
  3. Edit your snmpd.conf file (usually /etc/snmp/snmpd.conf) and add:

    extend phpfpmsp /etc/snmp/php-fpm
    

  4. Create the config file /usr/local/etc/php-fpm_extend.json. Alternate locations may be specified using the the -f switch. Akin to like below. For more information, see /etc/snmp/php-fpm --help.

    {
    "pools":{
            "thefrog": "https://thefrog/fpm-status",
            "foobar": "https://foo.bar/fpm-status"
        }
    }
    
  5. Restart snmpd on the host

    sudo systemctl restart snmpd
    

    The application should be auto-discovered as described at the top of the page. If it is not, please follow the steps set out under SNMP Extend heading top of page.

Install the agent on this device if it isn't already and copy the phpfpmsp script to /usr/lib/check_mk_agent/local/