Skip to content

Commit dfaada9

Browse files
committed
docs(php-fpm-status): add realistic multi-pool output example
The previous "Multi-pool output (default)" section only showed a quiet-day pool-overview table and gave the impression that the multi-pool layout never renders per-pool process tables. In practice the plugin emits one overview table plus one process table for each pool that has `Running` workers (the default view filters out idle workers; `--lengthy` includes them). Add a problem-case example (one pool OK, one pool saturated with long-running requests) that shows the overview table followed by a per-pool process table for the saturated pool. Keep the quiet-day example afterwards as a reference for the collapsed single-table layout.
1 parent 2897ace commit dfaada9

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

check-plugins/php-fpm-status/README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -210,6 +210,28 @@ PID ! Reqs ! LastDur ! Mthd ! URI ! User
210210

211211
### Multi-pool output (default)
212212

213+
With multiple `--url` arguments, the plugin emits a summary line, a pool-overview table with one row per pool, and a separate process table for each pool that has `Running` workers (the default view filters out idle workers; use `--lengthy` to include them). The example below shows a gateway where the `wordpress` pool is quiet and the `nextcloud` pool is saturated with long-running requests:
214+
215+
```text
216+
2 pools checked, 1 OK, 1 CRIT (nextcloud)
217+
218+
Pool ! Req/s ! Act ! Tot ! Sat ! Slow+
219+
----------+-------+-----+-----+--------+------
220+
wordpress ! 2.1 ! 1 ! 5 ! 20.0% ! 0
221+
nextcloud ! 71.0 ! 10 ! 10 ! 100.0% ! 0
222+
223+
Pool nextcloud — processes:
224+
PID ! Reqs ! LastDur ! Mthd ! URI ! User
225+
------+------+----------+------+--------------+-----
226+
55238 ! 5 ! 926ms ! GET ! /index.php?… ! -
227+
55239 ! 5 ! 923ms ! GET ! /index.php?… ! -
228+
55240 ! 5 ! 924ms ! GET ! /index.php?… ! -
229+
55241 ! 4 ! 926ms ! GET ! /index.php?… ! -
230+
55242 ! 1 ! 3s ! GET ! /index.php?… ! -
231+
```
232+
233+
A "quiet day" run where both pools are OK and have no running workers collapses to a single overview table without any per-pool process tables:
234+
213235
```text
214236
2 pools checked, 2 OK
215237

0 commit comments

Comments
 (0)