php-fpmのステータスページを表示 Apache & htaccess

概要

Apache環境で php-fpm のステータスページを htaccess で制御して表示する方法を試した際の記録です。

試した環境

CentOS 8
php7.4
Apache 2.4

php-fpm の pm.status_path について

pm.status_path はFPMの情報をみるためのパスを設定する項目です。

https://www.php.net/manual/ja/install.fpm.configuration.php#pm.status-path

php-fpmのconfの設定

php-fpm には次のパラメータを設定します。他のパラメータについては省略します。

listen: TCPで起動する。UNIXドメインソケットだと実現できない。
pm.status_path: ステータスを表示するページ。このドキュメントでは phpfpm_status として進める

listen = 9000
pm.status_path = /fpm_status
# 他のパラメータについては省略

.htaccess の設定

.htaccess は次のように設定します。

<FilesMatch fpm_status$>
    SetHandler "proxy:fcgi://127.0.0.1:9000/fpm_status"

    # 必要に応じてIP制限などを実施
    Require all denied
    Require ip X.X.X.X
</FilesMatch>

アクセスしてみる

http://localhost/fpm_status でアクセスすることができます。 (※ localhost の部分は任意のホスト名に変更する。)

パラメータを次のようにすることでjsonで受け取れます。

http://localhost/fpm_status?json&full

レスポンス例

{
  "pool": "www",
  "process manager": "dynamic",
  "start time": 1616509794,
  "start since": 2852,
  "accepted conn": 59,
  "listen queue": 0,
  "max listen queue": 0,
  "listen queue len": 128,
  "idle processes": 1,
  "active processes": 1,
  "total processes": 2,
  "max active processes": 1,
  "max children reached": 0,
  "slow requests": 0,
  "processes": [
    {
      "pid": 35,
      "state": "Idle",
      "start time": 1616509794,
      "start since": 2852,
      "requests": 29,
      "request duration": 532,
      "request method": "GET",
      "request uri": "/fpm_status?json&full",
      "content length": 0,
      "user": "-",
      "script": "-",
      "last request cpu": 0.00,
      "last request memory": 2097152
    },
    {
      "pid": 36,
      "state": "Running",
      "start time": 1616509794,
      "start since": 2852,
      "requests": 30,
      "request duration": 517,
      "request method": "GET",
      "request uri": "/fpm_status?json&full",
      "content length": 0,
      "user": "-",
      "script": "-",
      "last request cpu": 0.00,
      "last request memory": 0
    }
  ]
}