php开启 php-fpm状态页

php-fpm内置了一个非常有用的页面–php-fpm状态页，通过查看状态页内容可以随时了解php-fpm的工作状态，或者更进一步，可以编写脚本，定期抓取状态页的值来监控应用状态。

一、开启php-fpm状态页

开启php-fpm状态页步骤如下

1.1、开启 pm.status_path 配置项

在 php-fpm配置文件 fpm/pool.d/www.conf 中找到 pm.status_path 配置项，删除该项前面的";“，就可以启用该配置项，该配置项默认值如下,当然，也可以将其修改为其他想要的值，如”/fpmstatus"

pm.status_path = /status

1.2、修改nginx配置

在nginx的server部分增加以下配置

# location的uri和上面 pm.status_path 的值保持一致
    location = /status {
      access_log off;
      allow 127.0.0.1;
      allow 192.168.1.123; #your-ip;如果不加，就只有本机可以访问
      deny all;
      include fastcgi_params;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # 这一句也不能少,否则会输出一个空白页
      fastcgi_pass 127.0.0.1:9000;
    }

下面是一个完整的示例，文件名 /etc/nginx/conf.d/default.conf

server{
    gzip on;
    gzip_min_length 1k;
    gzip_buffers 4 16k;
    gzip_comp_level 5;
    gzip_types application/json text/plain application/x-javascript application/javascript text/javascript text/css application/xml application/x-httpd-php image/jpeg image/gif image/png;
    gzip_disable "MSIE [1-6]\.";

    listen 80;
    server_name localhost;
    index index.php index.html;
    client_max_body_size 50M;
    error_log /var/logs/test-domain-error.log;
    access_log /var/logs/test-domain-access.log;
    root /var/www/html/test-domain/public;

    location = /status {
      access_log off;
      allow 127.0.0.1;
      allow 10.100.80.43; #your-ip;
      deny all;
      include fastcgi_params;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      fastcgi_pass 127.0.0.1:9000;
    }
    
    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php {
        add_header "Access-Control-Allow-Credentials" "true";
        add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,usertoken';
        add_header "Access-Control-Allow-Origin" $http_origin;
        try_files $uri =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param SCRIPT_NAME $fastcgi_script_name;
        fastcgi_index index.php;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_read_timeout 180;
    }
}

1.3 重启服务

修改完配置后，重启nginx和php-fpm，访问 127.0.0.1/status （如果修改了默认值，改为修改后的uri即可），可以看到类似下面 php-fpm状态信息

pool:                 www
process manager:      dynamic
start time:           06/Apr/2022:14:59:27 +0800
start since:          3894
accepted conn:        2
listen queue:         0
max listen queue:     0
listen queue len:     4096
idle processes:       1
active processes:     1
total processes:      2
max active processes: 1
max children reached: 0
slow requests:        0

二、输出参数说明

php-fpm 状态信息页各项的含义如下

pool
pool 名称，多数情况下为 www.
process manager
可能的值为 static, dynamic , ondemand
start time
php-fpm启动的时间，每次重启该值都会重置
start since
从php-fpm启动到现在经过的秒数
accepted conn
该 pool 接受过的请求数
listen queue
等待连接队列中的请求数量，如果该值不为0，说明php-fpm进程处理能力不足，可能需要考虑采取加大php-fpm进程数，增加应用实例等措施进行扩容。
max listen queue
php-fpm进程启动以来，等待连接队列中请求数量的最大值
listen queue len
等待连接队列的最大值，代表了最多可以有多少个连接处于等待状态。
idle processes
空闲进程个数
active processes
活动进程个数
total processes
空闲进程+活动进程总个数
max active processes
php-fpm进程启动以来，活动进程个数的最大值
max children reached
php-fpm进程启动以来，php-fpm进程数量达到允许上限的次数，如果该值不为0，说明可能需要调大允许的php-fpm进程数最大值
slow requests
慢请求数，需要先打开允许记录 php-fpm 慢日志.如果该值不为0，可能代表应用存在慢请求，尤其需要注意是否有数据库慢查。

三、更多细节

增加full参数可以输出更多细节信息，下面是一个示例

curl 127.0.0.1/status?full

输出示例如下，输出除了包括第二部分的内容，还把每个php-fpm进程的信息输出出来了。

[root@api-doc-master-dev-864689b4f4-cxthh html]# curl localhost:8002/status?full
pool:                 www
process manager:      dynamic
start time:           06/Apr/2022:14:59:27 +0800
start since:          5999
accepted conn:        5
listen queue:         0
max listen queue:     0
listen queue len:     4096
idle processes:       2
active processes:     1
total processes:      3
max active processes: 1
max children reached: 0
slow requests:        0

************************
pid:                  27
state:                Idle
start time:           06/Apr/2022:14:59:27 +0800
start since:          5999
requests:             2
request duration:     176
request method:       GET
request URI:          /status?full
content length:       0
user:                 -
script:               -
last request cpu:     0.00
last request memory:  2097152

// 其他php-fpm进程信息略

四、更多格式

默认是按照 text/plain格式输出，实际上还支持xml，json这两种格式，增加相应参数即可，下面是url示例

// json格式输出
127.0.0.1/status?json  
// xml 格式输出
127.0.0.1/status?xml

// 以json格式，输出详细内容
127.0.0.1/status?json&full

五、prometheus 监控

from bakins/php-fpm-exporter
可以通过上面的副容器 exporter，作为prometheus的数据源，从而监控 fpm的各项指标
这个 exporter是用go语言开发的，github地址如下
https://github.com/bakins/php-fpm-exporter
最新版本为 v0.6.1，目前还是用的 v0.6.0