状态页面

配置

可以在 FPM poll 配置中设置 pm.status_path 配置参数来启用 FPM 状态页面。

警告

为了安全，FPM 状态页面应仅限于内部请求或已知客户端 IP，因为该页面会显示请求 URL 和可用资源的有关信息。

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>

重载/重启 FPM 和 Web 服务器后，可以从浏览器访问状态页面（如果配置了 IP 限制，请求只能来自允许的 IP）。

查询参数

可以指定以下某一查询参数来更改状态页面输出的格式：

html
json
openmetrics
xml

也可以使用 full 查询参数返回附加信息。

状态页面 URL 示例：

https://localhost/fpm-status ——默认文本格式的简短输出
https://localhost/fpm-status?full ——默认文本格式的完整输出
https://localhost/fpm-status?json ——JSON 格式的简短输出
https://localhost/fpm-status?html&full ——HTML 格式的完整输出

显示信息

日期/时间值在 JSON/XML 输出中使用 unix 时间戳格式，否则将生成以下示例日期 "03/Jun/2021:07:21:46 +0100"。

**基础信息——始终在状态页面显示**
参数	说明
pool	FPM 进程池的名称。
proccess manager	进程管理器类型——static、dynamic 或 ondemand。
start time	进程池最后一次启动的日期/时间。
start since	进程自启动以来的秒数。
accepted conn	服务的请求总数
listen queue	当前等待空闲进程的请求（backlog）总数。
max listen queue	监听队列在任一时间看到的最大请求数。
listen queue len	The maximum allowed size of the listen queue.
idle processes	当前空闲（等待请求）的进程数。
active processes	当前正在处理请求的进程数。
total processes	当前进程总数。
max active processes	The maximum number of concurrently active processes.
max children reached	是否达到了最大进程数？如果是，则值显示为 `1`，否则为 `0`。
slow requests	The total number of requests that have hit the configured `request_slowlog_timeout`.

**每个进程的信息——仅在 `full` 输出模式中显示**
参数	说明
pid	进程的系统 PID。
state	进程状态——空闲、运行……
start time	进程开始的日期/时间。
start since	进程自启动以来的秒数。
requests	最大服务请求数。
request duration	服务请求所花费的总时间（以秒为单位）。
request method	最后服务请求的 HTTP 方法。
request uri	最后服务请求的 URI（在 Web 服务器处理后，如果使用前端控制器模式重定向，将始终是 `/index.php`）。
content length	最后一个请求的请求正文长度，以字节为单位。
user	最后一个请求的 HTTP 用户（`PHP_AUTH_USER`）。
script	最后一个请求执行的执行脚本的完整路径。如果不适用（比如状态页面请求），将是 `'-'`。
last request cpu	最后一个请求的 %cpu。如果进程不空闲，将为 0，因为进程是在请求处理完成时进行计算的。
last request memory	最后一个请求消耗的最大内存量。如果进程不空闲，将为 0，因为进程是在请求处理完成时进行计算的。

注意:
当 FPM 重启时，重置所有池指定的值。

注意:
openMetrics 格式输出使用不同的参数类型以便更好的适应 OpenMetrics 格式。参数和值的说明包含在 OpenMetrics 格式输出中。

更新日志

版本	说明
8.1.0	新增 openmetrics 格式。