- PHP-Resource

Status Page

This page provides information on the setup and contents of the FPM status page. See also fpm_get_status().

Configuration

The FPM status page can be enabled by setting the pm.status_path configuration parameter in the FPM pool configuration.

Achtung

For security the FPM status page should be restricted to internal requests or known client IPs only as the page reveals request URLs and information about available resources.

Depending on the web server configuration it might be needed to configure the web server to allow requests directly to this path, bypassing any PHP scripts. An example of a configuration for Apache with FPM listening on UDS and pm.status_path set to /fpm-status would look like:

<LocationMatch "/fpm-status">
 Order Allow,Deny
 Allow from 127.0.0.1
 ProxyPass "unix:/var/run/php-fpm.sock|fcgi://localhost/fpm-status"
</LocationMatch>

After reloading or restarting both FPM and the web server the status page will be accessible from the browser (as long as the request comes from an allowed IP address if the IP restriction was configured).

Query Parameters

The format of the status page output can be altered by specifying one of the following query parameters:

html
json
openmetrics
xml

Additional information can also be returned using the full query parameter.

Example status page URLs:

https://localhost/fpm-status - Brief output in the default text format
https://localhost/fpm-status?full - Full output in the default text format
https://localhost/fpm-status?json - Brief output in JSON format
https://localhost/fpm-status?html&full - Full output in HTML format

Displayed Information

Date/Time values use the unix timestamp format in JSON and XML output, otherwise they use the format resulting in the following example date "03/Jun/2021:07:21:46 +0100".

**Basic information - Always displayed on the status page**
Parameter	Description
pool	The name of the FPM process pool.
proccess manager	The process manager type - static, dynamic or ondemand.
start time	The date/time that the process pool was last started.
start since	The time in seconds since the process pool was last started.
accepted conn	The total number of accepted connections.
listen queue	The number of requests (backlog) currently waiting for a free process.
max listen queue	The maximum number of requests seen in the listen queue at any one time.
listen queue len	The maximum allowed size of the listen queue.
idle processes	The number of processes that are currently idle (waiting for requests).
active processes	The number of processes that are currently processing requests.
total processes	The current total number of processes.
max active processes	The maximum number of concurrently active processes.
max children reached	Has the maximum number of processes ever been reached? If so the displayed value is `1` otherwise the value is `0`.
slow requests	The total number of requests that have hit the configured `request_slowlog_timeout`.

**Per-process information - only displayed in `full` output mode**
Parameter	Description
pid	The system PID of the process.
state	The state of the process - Idle, Running, ...
start time	The date/time at which the process started.
start since	The number of seconds since the process started.
requests	The total number of requests served.
request duration	The total time in seconds spent serving requests.
request method	The HTTP method of the last served request.
request uri	The URI of the last served request (after webserver processing, it may always be `/index.php` if you use a front controller pattern redirect).
content length	The length of the request body, in bytes, of the last request.
user	The HTTP user (`PHP_AUTH_USER`) of the last request.
script	The full path of the script executed by the last request. This will be `'-'` if not applicable (eg. status page requests).
last request cpu	The %cpu of the last request. This will be 0 if the process is not Idle because the calculation is done when the request processing is complete.
last request memory	The maximum amount of memory consumed by the last request. This will be 0 if the process is not Idle because the calculation is done when the request processing is complete.

Hinweis:
All values are specific to the pool and are reset when FPM is restarted.

Hinweis:
OpenMetrics format output uses different parameter types to better suit the OpenMetrics format. The parameters and descriptions of their values are included in the OpenMetrics format output.