FPM: Difference between revisions
From DWIKI
m (→FAQ) |
|||
| (14 intermediate revisions by the same user not shown) | |||
| Line 7: | Line 7: | ||
*[https://www.digitalocean.com/community/tutorials/how-to-configure-apache-http-with-mpm-event-and-php-fpm-on-ubuntu-18-04 Switching to FPM on Ubuntu/Debian] | *[https://www.digitalocean.com/community/tutorials/how-to-configure-apache-http-with-mpm-event-and-php-fpm-on-ubuntu-18-04 Switching to FPM on Ubuntu/Debian] | ||
=Tuning php-fpm = | |||
==Links== | |||
*[https://spot13.com/pmcalculator/ php-fpm settings calculator] | |||
*[https://tideways.com/profiler/blog/an-introduction-to-php-fpm-tuning An Introduction to PHP-FPM Tuning] | |||
==Settings== | |||
===pm.max_children=== | |||
=Monitoring PHP-FPM= | =Monitoring PHP-FPM= | ||
*https://www.php.net/manual/en/fpm.status.php | *https://www.php.net/manual/en/fpm.status.php | ||
*[https://www.zabbix.com/integrations/phpfpm Zabbix monitoring php-fpm] | *[https://www.zabbix.com/integrations/phpfpm Zabbix monitoring php-fpm] | ||
*[https://github.com/jizhang/zabbix-templates/tree/master/php-fpm zabbix php fpm] | |||
*[https://www.icdsoft.com/en/kb/view/2053_php_fpm_status fpm status] | |||
==Metrics== | |||
===listen queue=== | |||
===max listen queue=== | |||
===listen queue len=== | |||
===idle processes=== | |||
===active processes=== | |||
===total processes=== | |||
===max active processes=== | |||
===max children reached=== | |||
===slow requests=== | |||
==fpm configuration== | |||
pm.status_listen = 127.0.0.1:9001 | |||
pm.status = /fpm-status | |||
pm.ping = /fpm-ping | |||
==Apache== | |||
# I suppose you don't really have to use separate port for this, but might avoid problems | |||
Listen 127.0.0.1:89 | |||
<Virtualhost 127.0.0.1:89> | |||
<Location /fpm-status> | |||
Require host localhost | |||
ProxyPass unix:/run/php/php-fpm.sock|fcgi://localhost:9001 | |||
</Location> | |||
<Location /fpm-ping> | |||
Require host localhost | |||
ProxyPass unix:/run/php/php-fpm.sock|fcgi://localhost:9001 | |||
</Location> | |||
</VirtualHost> | |||
=HOWTO= | =HOWTO= | ||
==Configuring number of servers== | ==Configuring number of servers== | ||
*[https://tideways.com/profiler/blog/an-introduction-to-php-fpm-tuning An Introduction to PHP-FPM Tuning] | |||
dynamic - the number of child processes are set dynamically based on the | dynamic - the number of child processes are set dynamically based on the | ||
following directives: | following directives: | ||
pm.max_children - the maximum number of children that can | pm.max_children - the maximum number of children that can | ||
be alive at the same time. | be alive at the same time. Has to be at least as high as pm.max_spare_servers | ||
pm.start_servers - the number of children created on startup. | pm.start_servers - the number of children created on startup. | ||
| Line 31: | Line 74: | ||
of 'idle' processes is greater than this | of 'idle' processes is greater than this | ||
number then some children will be killed. | number then some children will be killed. | ||
=FAQ= | =FAQ= | ||
==error messages== | |||
===pm.min_spare_servers(3) and pm.max_spare_servers(7) cannot be greater than pm.max_children(5)=== | |||
Obviously, pm.max_children has to be at least as high as pm.max_spare_servers | |||
==proxy_fcgi AH01071: Got error 'Primary script unknown'== | ==proxy_fcgi AH01071: Got error 'Primary script unknown'== | ||
The fcgi 404 | The fcgi 404, so you're requesting a nonexisting link | ||
==AH01079: failed to make connection to backend: httpd-UDS== | ==AH01079: failed to make connection to backend: httpd-UDS== | ||
USB = Unix Domain Socket, look for logging/config about the socket involved | USB = Unix Domain Socket, look for logging/config about the socket involved | ||
==WARNING: [pool www] ACL set, listen.owner = 'apache' is ignored== | |||
Redhat feature, check commenting out acl_users in www.conf | |||
==AH01144: No protocol handler was valid for the URL /fpm-ping (scheme 'fcgi'). == | |||
If you are using a DSO version of mod_proxy, make sure the proxy submodules are included in the configuration using LoadModule. | |||
a2enmod proxy_fcgi | |||
==Show php-fpm config== | ==Show php-fpm config== | ||
php-fpm8.0 -tt | php-fpm8.0 -tt | ||
==server reached pm.max_children setting== | |||
Latest revision as of 16:15, 9 October 2024
FastCGI Process Manager
Links
Tuning php-fpm
Links
Settings
pm.max_children
Monitoring PHP-FPM
Metrics
listen queue
max listen queue
listen queue len
idle processes
active processes
total processes
max active processes
max children reached
slow requests
fpm configuration
pm.status_listen = 127.0.0.1:9001 pm.status = /fpm-status pm.ping = /fpm-ping
Apache
- I suppose you don't really have to use separate port for this, but might avoid problems
Listen 127.0.0.1:89 <Virtualhost 127.0.0.1:89> <Location /fpm-status> Require host localhost ProxyPass unix:/run/php/php-fpm.sock|fcgi://localhost:9001 </Location> <Location /fpm-ping> Require host localhost ProxyPass unix:/run/php/php-fpm.sock|fcgi://localhost:9001 </Location> </VirtualHost>
HOWTO
Configuring number of servers
dynamic - the number of child processes are set dynamically based on the
following directives:
pm.max_children - the maximum number of children that can
be alive at the same time. Has to be at least as high as pm.max_spare_servers
pm.start_servers - the number of children created on startup.
this value must not be less than min_spare_servers
and not greater than max_spare_servers.
pm.min_spare_servers - the minimum number of children in 'idle'
state (waiting to process). If the number
of 'idle' processes is less than this
number then some children will be created.
pm.max_spare_servers - the maximum number of children in 'idle'
state (waiting to process). If the number
of 'idle' processes is greater than this
number then some children will be killed.
FAQ
error messages
pm.min_spare_servers(3) and pm.max_spare_servers(7) cannot be greater than pm.max_children(5)
Obviously, pm.max_children has to be at least as high as pm.max_spare_servers
proxy_fcgi AH01071: Got error 'Primary script unknown'
The fcgi 404, so you're requesting a nonexisting link
AH01079: failed to make connection to backend: httpd-UDS
USB = Unix Domain Socket, look for logging/config about the socket involved
WARNING: [pool www] ACL set, listen.owner = 'apache' is ignored
Redhat feature, check commenting out acl_users in www.conf
AH01144: No protocol handler was valid for the URL /fpm-ping (scheme 'fcgi').
If you are using a DSO version of mod_proxy, make sure the proxy submodules are included in the configuration using LoadModule.
a2enmod proxy_fcgi
Show php-fpm config
php-fpm8.0 -tt
