Esta página proporciona información sobre la configuración y el contenido de la página de estado de FPM. Véase también fpm_get_status().
La página de estado de FPM se puede habilitar estableciendo el parámetro de configuración pm.status_path en la configuración del pool de FPM.
Por seguridad, la página de estado del FPM debería estar restringida a las solicitudes internas o a las IPs de clientes conocidos, ya que la página revela las URLs de las solicitudes y la información sobre los recursos disponibles.
Dependiendo de la configuración del servidor web, podría ser necesario configurar el servidor web para
permitir peticiones directamente a esta ruta, evitando cualquier script PHP. Un ejemplo de configuración
para Apache con FPM escuchando en UDS y pm.status_path establecido a
/fpm-status se vería así:
<LocationMatch "/fpm-status"> Order Allow,Deny Allow from 127.0.0.1 ProxyPass "unix:/var/run/php-fpm.sock|fcgi://localhost/fpm-status" </LocationMatch>
Después de recargar o reiniciar tanto el FPM como el servidor web, la página de estado será accesible desde el navegador (siempre que la petición provenga de una dirección IP permitida si se ha configurado la restricción de IP).
El formato de la salida de la página de estado puede modificarse especificando uno de los siguientes parámetros de consulta:
htmljsonopenmetricsxml
También se puede devolver información adicional utilizando el parámetro de consulta completa full.
Ejemplo de URL de la página de estado:
https://localhost/fpm-status
- Salida breve en el formato de texto por defecto
https://localhost/fpm-status?full
- Salida completa en el formato de texto por defecto
https://localhost/fpm-status?json
- Breve salida en formato JSON
https://localhost/fpm-status?html&full
- Salida completa en formato HTML
Los valores de fecha/hora utilizan el formato unix timestamp en la salida JSON y XML, de lo contrario utilizan
el formato que da como resultado la siguiente fecha de ejemplo
"03/Jun/2021:07:21:46 +0100".
| Parámetro | Descripción |
|---|---|
| pool | El nombre del conjunto de procesos FPM. |
| proccess manager | El tipo de gestor de procesos: estático, dinámico o a la carta. |
| start time | La fecha/hora en que se inició por última vez el conjunto de procesos. |
| start since | El tiempo en segundos desde que el conjunto de procesos se inició por última vez. |
| accepted conn | El número total de conexiones aceptadas. |
| listen queue | El número de solicitudes (backlog) en espera de un proceso libre. |
| max listen queue | El número máximo de solicitudes vistas en la cola de escucha en un momento dado. |
| listen queue len | El tamaño máximo permitido de la cola de escucha. |
| idle processes | El número de procesos que están actualmente inactivos (esperando peticiones). |
| active processes | El número de procesos que están procesando actualmente las solicitudes. |
| total processes | El número total actual de procesos. |
| max active processes | El número máximo de procesos activos simultáneamente. |
| max children reached |
¿Se ha alcanzado el número máximo de procesos? Si es así, el valor mostrado es
1 de lo contrario el valor es 0.
|
| slow requests |
El número total de peticiones que han alcanzado el valor configurado en
request_slowlog_timeout.
|
| Parámetro | Descripción |
|---|---|
| pid | El PID del sistema del proceso. |
| state | El estado del proceso: inactivo, en ejecución, ... |
| start time | La fecha/hora en que se inició el proceso. |
| start since | El número de segundos desde que se inició el proceso. |
| requests | El número total de solicitudes servidas. |
| request duration | El tiempo total en segundos dedicado a servir peticiones. |
| request method | El método HTTP de la última solicitud servida. |
| request uri |
El URI de la última solicitud servida (después del procesamiento del servidor web, puede ser siempre
/index.php si se utiliza un patrón de redirección del controlador frontal (front controller).
|
| content length | La longitud del cuerpo de la solicitud, en bytes, de la última solicitud. |
| user | El usuario HTTP (PHP_AUTH_USER) de la última petición. |
| script |
La ruta completa del script ejecutado por la última petición. Será
'-' si no se aplica (por ejemplo, solicitudes de páginas de estado).
|
| last request cpu | El %cpu de la última petición.Será 0 si el proceso no está inactivo, ya que el cálculo se realiza cuando se completa el procesamiento de la solicitud |
| last request memory | La cantidad máxima de memoria consumida por la última petición. Será 0 si el proceso no está inactivo, ya que el cálculo se realiza cuando se completa el procesamiento de la solicitud. |
Nota:
Todos los valores son específicos del pool y se restablecen cuando se reinicia FPM.
Nota:
La salida del formato OpenMetrics utiliza diferentes tipos de parámetros para adaptarse mejor al formato OpenMetrics. Los parámetros y las descripciones de sus valores se incluyen en la salida del formato OpenMetrics.
| Versión | Descripción |
|---|---|
| 8.1.0 | Se ha añadido el formato openmetrics. |
Before someone else misunderstands that:
"request duration The total time in seconds spent serving requests."
This is not the total time of all requests done by that process, but either the time used by the last request done (idle state), or the current request (all other states).
And the number given is not in seconds, but in microseconds.
The fpm status documentation is a mess.