Pro plan from £5 per endpoint per month · see pricing
Secronyx
In the next releaseLinux

PHP-FPM

See whether every PHP-FPM worker is busy, how many requests are queuing for one, and which script each worker is running and for how long, from the pool's status page on this host with read-only requests. This plugin is in the next Secronyx release; the current download does not include it yet.

What it answers

Questions an on-call engineer asks, which an AI client can answer with this plugin.

  • Are all PHP-FPM workers busy, and are requests queuing for one?
  • Has the pool reached its limit of worker processes?
  • Which PHP script is each worker running, and for how long?
  • Which workers used the most CPU or memory on their last request?
  • When did the PHP-FPM pool last restart?

What it returns

Each of the plugin's read-only tools, described in words.

  • The PHP-FPM pool's load in one row - active, idle and total workers, requests waiting in the listen queue and its peak, times pm.max_children was reached, slow requests, accepted connections, uptime
  • Every PHP-FPM worker, one row each - state (Idle, Running), the script it runs, how long the request has taken, method, request path without query string, and its last request's CPU and memory

At a glance

Plugin
php-fpm 1.0.0
Publisher
levantar
Platforms
Linux

Tested on

  • PHP-FPM 8.2.35 and 8.3.36 behind NGINX 1.30.6 on Linux (Ubuntu 24.04, Docker), test lab

How it logs in

Without an explicit choice, install tries the methods that need no secret first, in this order.

  • No login (a local endpoint)

Least privilege

The setup file in the pack. This plugin needs no password and creates no login: the file says what it needs on the host and how to keep that to the minimum.

# The least privilege for the php-fpm plugin. PHP-FPM's status page has no # users or roles: whoever can fetch it sees the pool's counters and, with # ?full, what every worker is running: script path, request path, query # string and the user the request authenticated as. The least privilege is # a status location that only this host can reach. # # 1. In the pool's file (/etc/php/8.3/fpm/pool.d/www.conf on Debian and # Ubuntu, /etc/php-fpm.d/www.conf on RHEL), turn the status page on, on # a listener of its own (PHP 8.0 and later). With its own listener the # page still answers when every worker of the pool is busy, which is # when you need it: # # pm.status_path = /status # pm.status_listen = 127.0.0.1:9001 # # Then restart PHP-FPM (systemctl restart php8.3-fpm). Do not add # /status to a "location ~ \.php$" of a public site. # # 2. Put this server in NGINX's http { } block, for example as # /etc/nginx/conf.d/secronyx-php-fpm.conf, then: nginx -t && nginx -s reload # It listens on loopback and refuses every other client. # # 3. Install with auth none: secronyx plugin install <pack> # On another port: --endpoint 127.0.0.1:<port> server { listen 127.0.0.1:80; server_name localhost; access_log off; location = /status { allow 127.0.0.1; deny all; fastcgi_param SCRIPT_NAME /status; fastcgi_param SCRIPT_FILENAME /status; fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_pass 127.0.0.1:9001; } }

See it run

Terminal recording from the test lab: php-fpm-linux-harness
A real run on the shared test lab.

Read-only, in layers

Every request is a GET or HEAD to the endpoint the operator configured, on a path fixed in the signed pack. Redirects are not followed, and requests known to change state are refused.

These controls narrow what the plugin can do; none of them is a guarantee on its own. An administrator can still accept a more powerful login on purpose (audited and shown in status), root or Administrator on the host can replace the agent, and the plugin can read whatever its login can see.