Сторінка стану
На цій сторінці представлена інформація про налаштування та зміст сторінки стану FPM. Дивіться також опис функції fpm_get_status()
Налаштування
Сторінку стану FPM можна увімкнути шляхом встановлення параметра конфігурації pm.status_path у пулі FPM конфігурації.
Застереження
З метою безпеки сторінка стану FPM повинна бути обмежена внутрішніми запитами або відомими IP-адресами клієнтів, оскільки сторінка показує URL-адресу запиту та інформацію про доступні ресурси.
Від конфігурації веб-сервера залежить, чи потрібно в його налаштуваннях дозволяти запити безпосередньо до цього шляху, оминаючи будь-які PHP-скрипти. Приклад конфігурації для сервера Apache з менеджером процесів FPM, який слухає UDS, і директивою pm.status_path із встановленим значенням /fpm-status буде виглядати так:
<LocationMatch "/fpm-status"> Order Allow,Deny Allow from 127.0.0.1 ProxyPass "unix:/var/run/php-fpm.sock|fcgi://localhost/fpm-status"
Після перезавантаження або перезапуску менеджера FPM і веб-сервера сторінка стану буде доступна з браузера (за умови, що запит надходить з дозволеної IP-адреси, якщо було налаштовано обмеження IP-адрес).
Параметри запиту
Формат виведення сторінки стану може бути змінено шляхом вказівки одного з наступних параметрів запиту:
htmljsonopenmetricsxml
Додаткову інформацію також можна повернути за допомогою параметра запиту full
Приклади URL-адрес сторінок стану:
https://localhost/fpm-status- Короткий висновок у текстовому форматі за замовчуваннямhttps://localhost/fpm-status?full- Повний висновок у текстовому форматі за замовчуваннямhttps://localhost/fpm-status?json- Короткий висновок у форматі JSONhttps://localhost/fpm-status?html&full- Повний висновок у форматі HTML
Відображувана інформація
Значення дати/часу використовують формат мітки часу UNIX у вихідних даних JSON та XML, інакше вони використовують формат, що призводить до наступного прикладу дати: "03/Jun/2021:07:21:46 +0100"
Основна інформація – завжди відображається на сторінці стану
| Параметр | Опис |
|---|---|
| pool | Ім'я пулу процесів FPM. |
| proccess manager | Тип менеджера процесу - static (статичний), dynamic (динамічний) або ondemand (на вимогу). |
| start time | Дата/час останнього запуску пулу процесів. |
| start since | Час за секунди з моменту останнього запуску пулу процесів. |
| accepted conn | Загальна кількість прийнятих сполук. |
| listen queue | Кількість запитів (backlog), які очікують вільного процесу. |
| max listen queue | Максимальна кількість запитів у черзі на прослуховування будь-якої миті часу. |
| listen queue len | Максимально допустимий розмір черги прослуховування. |
| idle processes | Кількість процесів, які зараз простоюють (очікують запитів). |
| active processes | Кількість процесів, які нині опрацьовують запити. |
| total processes | Поточна загальна кількість процесів. |
| max active processes | Максимальна кількість одночасно активних процесів. |
| max children reached | Чи було досягнуто максимальної кількості процесів? Якщо так, то відображуване значення буде , інакше значення буде |
| slow requests | Загальна кількість запитів, які досягли налаштованого request_slowlog_timeout |
Інформація про кожний процес — відображається лише у режимі виводу full
| Параметр | Опис |
|---|---|
| pid | Системний процес PID. |
| state | Стан процесу - Idle, Running, ... |
| start time | Дата/час початку процесу. |
| start since | Кількість секунд від початку процесу. |
| requests | Загальна кількість обслуговуваних запитів. |
| request duration | Загальний час у мікросекундах, витрачений обслуговування останнього запиту. |
| request method | Метод HTTP останнього обслуговуваного запиту. |
| request uri | URI останнього обслуженого запиту (після обробки веб-сервером він завжди може дорівнювати /index.php, якщо ви використовуєте шаблонний редирект фронт-контролера). |
| content length | Довжина тіла запиту в байтах, останній запит. |
| user | HTTP-користувач (PHP_AUTH_USER) останнього запиту. |
| script | Повний шлях до скрипта, виконаного останнім запитом. Це буде '-', якщо не застосовується (наприклад, запити сторінки стану). |
| last request cpu | Відсоток зайнятого часу при виконанні останнього запиту. Це значення буде 0, якщо процес не в стані Idle, тому що обчислення проводиться після закінчення обробки запиту. Значення може перевищити 100 %, тому що метрика покаже, який відсоток від загального часу роботи процесора зайняв останній запит — у розрахунку будуть враховані процеси на всіх ядрах, тоді як 100 % — це значення тільки для одного ядра. |
| last request memory | Максимальний обсяг пам'яті, спожитий останнім запитом. Це значення дорівнюватиме 0, якщо процес не простоює, так як обчислення проводиться після закінчення обробки запиту. |
Зауваження :
Всі значення специфічні для пулу і скидаються під час перезапуску FPM.
Зауваження :
У форматі OpenMetrics використовуються різні типи параметрів, щоб краще відповідати формату OpenMetrics. Параметри та опис їх значень включені у вихідні дані формату OpenMetrics.
список змін
| Версия | Опис |
|---|---|
| 8.1.0 | Доданий формат OpenMetrics. |