International PHP Conference Berlin 2023

状态页面

此页面提供 FPM 状态页面的设置和内容的相关信息。请参见 fpm_get_status()

配置

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

警告

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

取决于 Web 服务器配置,可能需要配置 Web 服务器允许绕过任何 PHP 脚本,直接请求该路径。Apache 在 UDS 上监听 FPM 并且 pm.status_path 设置为 /fpm-status 的配置示例看起来就像是这样:

<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 监听队列的最大允许数量。
idle processes 当前空闲(等待请求)的进程数。
active processes 当前正在处理请求的进程数。
total processes 当前进程总数。
max active processes 并发活动进程的最大数量。
max children reached 是否达到了最大进程数?如果是,则值显示为 1,否则为 0
slow requests 达到配置 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 格式。
add a note

User Contributed Notes 1 note

up
3
uwe at ohse dot de
1 month ago
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.
To Top