Мониторинг и проверка состояния PHP-FPM

Расширенные примеры проверки статуса PHP-FPM

Пример 1. Полная настройка pm.status_path и запрос в формате JSON с детальным выводом

Конфигурация пула (файл /etc/php/8.2/fpm/pool.d/www.conf):

; Включение статуса
pm.status_path = /status
; Доступные форматы: plain, html, json, xml (используется по умолчанию plain)
; Для json достаточно добавить ?json в URL

Перезапуск PHP-FPM:

sudo systemctl restart php8.2-fpm

Запрос статуса через UNIX-сокет с указанием нужного сокета:

curl --unix-socket /var/run/php/php8.2-fpm.sock http://localhost/status?json 2>/dev/null

Пример ответа (сокращён):

{"pool":"www","process-manager":"dynamic","start-time":1700000000,"start-since":12345,"accepted-conn":1024,"listen-queue":0,"max-listen-queue":0,"listen-queue-len":128,"idle-processes":2,"active-processes":3,"total-processes":5,"max-active-processes":10,"max-children-reached":0,"slow-requests":0}

Пояснение ключевых полей: pool - имя пула, active-processes - число обрабатываемых запросов, idle-processes - свободные процессы, listen-queue - очередь ожидающих соединений (важно для нагрузки).

Пример 2. Самодельный скрипт на PHP с обработкой ошибок и повторными попытками

<?php
function getFpmStatus($socketPath = '/var/run/php/php8.2-fpm.sock', $timeout = 3) {
    $url = '/status?json';
    $attempts = 3;
    while ($attempts--) {
        $ctx = stream_context_create(['socket' => ['timeout' => $timeout]]);
        $fp = @stream_socket_client('unix://' . $socketPath, $errno, $errstr, $timeout, STREAM_CLIENT_CONNECT, $ctx);
        if ($fp) {
            $request = "GET $url HTTP/1.0\r\nHost: localhost\r\n\r\n";
            fwrite($fp, $request);
            $response = stream_get_contents($fp);
            fclose($fp);
            // Разделяем заголовки и тело
            list($headers, $body) = explode("\r\n\r\n", $response, 2);
            $data = json_decode($body, true);
            if (json_last_error() === JSON_ERROR_NONE) {
                return $data;
            }
        }
        usleep(200000); // 0.2 секунды перед повтором
    }
    throw new Exception("Не удалось получить статус PHP-FPM: $errstr ($errno)");
}

try {
    $status = getFpmStatus();
    echo "Активных процессов: " . $status['active-processes'] . PHP_EOL;
    echo "Свободных процессов: " . $status['idle-processes'] . PHP_EOL;
    echo "Длина очереди: " . $status['listen-queue'] . PHP_EOL;
} catch (Exception $e) {
    echo "Ошибка: " . $e->getMessage();
}
?>

Результат выполнения:

Активных процессов: 3
Свободных процессов: 2
Длина очереди: 0

Скрипт пригоден для использования в cron или в качестве внешнего проверяющего модуля.

Пример 3. Настройка Nginx location с ограничением доступа и проверка через браузер

# В блоке server конфигурации Nginx (обычно /etc/nginx/sites-enabled/default)
location /fpm-status {
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME /fpm-status;
    # Доступ только с локального IP и из доверенной подсети
    allow 127.0.0.1;
    allow 10.0.0.0/8;
    deny all;
    # Кэширование не требуется
    add_header Cache-Control no-cache;
}

После перезагрузки Nginx (sudo nginx -s reload) статус становится доступен по адресу:

http://127.0.0.1/fpm-status?json

Ответ в браузере:

{"pool":"www","process-manager":"dynamic",...}

Данный метод удобен для визуального контроля и для интеграции с HTTP-проверками внешних мониторинговых систем.

Пример 4. Использование socat для нестандартных запросов

# Установка соединения с UNIX-сокетом и отправка HTTP-запроса
{ echo -e "GET /status?plain HTTP/1.0\r\nHost: localhost\r\n\r\n"; sleep 1; } | socat - UNIX-CONNECT:/var/run/php/php8.2-fpm.sock

Вывод (plain text):

HTTP/1.0 200 OK
Content-Type: text/plain;charset=utf-8
...

pool:                 www
process manager:      dynamic
start time:           ...
start since:          12345
accepted conn:        1024
listen queue:         0
max listen queue:     0
listen queue len:     128
idle processes:       2
active processes:     3
total processes:      5
max active processes: 10
max children reached: 0
slow requests:        0

Такой вывод легко парсится grep и awk для извлечения конкретных полей.

Пример 5. Интеграция с Prometheus через php-fpm_exporter

# Запуск экспортёра (предварительно установить из репозитория)
php-fpm-exporter --endpoint http://127.0.0.1/fpm-status?json --web.listen-address=:9253
# Метрики доступны на http://localhost:9253/metrics

Пример метрик в Prometheus:

# HELP php_fpm_up Was the last scrape of php-fpm successful.
# TYPE php_fpm_up gauge
php_fpm_up{pool="www"} 1
# HELP php_fpm_active_processes The number of active processes.
# TYPE php_fpm_active_processes gauge
php_fpm_active_processes{pool="www"} 3
# HELP php_fpm_idle_processes The number of idle processes.
# TYPE php_fpm_idle_processes gauge
php_fpm_idle_processes{pool="www"} 2
...

Это решение подходит для масштабного сбора метрик и визуализации в Grafana.