README
pm2-php-fpm
PHP-FPM module for Keymetrics
Description
This module monitors following PHP-FPM metrics:
- uptime;
- number of connections since start;
- average request:
- duration;
- CPU usage;
- memory consumption.
- active and idle proccesses count;
- connection queue size;
- child processes limit hits;
- slow processes count.
Requirements
This module reqires PHP-FPM and PM2 to be installed. Also it may require you to edit PHP-FPM configs to enable status page. Make sure your user has privileges to access PHP-FPM socket.
Installation
pm2 install pm2-php-fpm
Configuration
Default settings:
fcgi_path
is/var/run/php5-fpm.sock
;endpoint
is/status
;interval
is1000
milliseconds.
To modify the config values you can use Keymetrics dashboard or the following commands:
pm2 set pm2-php-fpm:fcgi_path /var/run/custom-php-socket.sock
pm2 set pm2-php-fpm:endpoint /health
pm2 set pm2-php-fpm:interval 5000
You may use TCP port instead of UNIX socket:
pm2 set pm2-php-fpm:fcgi_host 127.0.0.1
pm2 set pm2-php-fpm:fcgi_port 9000
Troubleshooting
error Cannot connect to PHP-FPM
Check module configuration. Make sure that path or host and port are the ones you have in PHP-FPM config. Also this error may appear when your PHP-FPM instance is overloaded or stopped unexpectedly.
error PHP-FPM status endpoint not found
You’ve entered wrong endpoint. Or changed its name in PHP-FPM configuration recently and didn’t update module settings.
error Access to PHP-FPM denied
User running PM2 daemon has no rights to access PHP-FPM socket. You need to add your user to group owning socket. Find out its name in PHP-FPM pool config or use stat -c %G /path/to/php5-fpm.sock
Add your user (e.g. myuser
) to target group (e.g. www-data
): sudo usermod -a -G www-data myuser
Reconnect to your server and restart PM2 daemon: pm2 update
Other
Look through Issues. You may find someone with the same problem. If your problem is unique, feel free to create a new issue.
Uninstallation
pm2 uninstall pm2-php-fpm
License
MIT