همه مقالات تخصصی

عیب‌یابی کندی PHP با PHP-FPM Slowlog؛ تشخیص پیش از افزایش Timeout

Slowlog محل اجرای درخواست کند را نشان می‌دهد، نه علت قطعی آن را. با تنظیم محدود، هم‌بستگی لاگ‌ها و آزمون قبل و بعد، گلوگاه PHP را بررسی کنید.

عیب‌یابی کندی PHP با PHP-FPM Slowlog؛ تشخیص پیش از افزایش Timeout

افزایش Timeout شاید خطای 504 را عقب بیندازد، اما یک Query کند یا انتظار API خارجی همچنان Worker را اشغال می‌کند. PHP-FPM Slowlog پس از گذشت آستانه تعیین‌شده، Backtrace درخواست را ثبت می‌کند. هدف این مقاله، یافتن مسیرهای تکرارشونده در اجرای PHP و مرتبط‌کردن آن‌ها با شواهد دیتابیس، شبکه و صف Pool است؛ نه افزایش کورکورانه منابع.

دامنه و پیش‌نیازها

نسخه PHP، نام سرویس و Pool مؤثر را مشخص کنید؛ مثال php8.3-fpm برای همه توزیع‌ها صحیح نیست. دسترسی مدیریتی، پنجره تغییر و مسیر بازگشت لازم‌اند. فایل Slowlog خارج از Document Root باشد و دسترسی آن محدود بماند. مسیرهای فایل و نام توابع ممکن است اطلاعات عملیاتی آشکار کنند؛ خروجی را قبل از اشتراک‌گذاری بازبینی و پس از پایان عیب‌یابی سیاست نگهداری اعمال کنید.

۱. جمع‌آوری شواهد

زمان دقیق درخواست کند، مسیر URL، مدت پاسخ، وضعیت HTTP و روند منابع را ثبت کنید. چند نمونه نماینده لازم است؛ یک درخواست ناموفق برای نتیجه‌گیری کافی نیست. در وب‌سرور reverse proxy یا FastCGI، زمان پاسخ upstream را با زمان کل درخواست مقایسه کنید. اگر FPM Status از قبل فعال است، فقط از مسیر مدیریتی محافظت‌شده، active workers و listen queue را بخوانید؛ آن را عمومی نکنید.

۲. اصلاح کنترل‌شده

در همان Pool، slowlog و request_slowlog_timeout را اضافه یا مقادیر موجود را کنترل‌شده تغییر دهید؛ directive تکراری نسازید. آستانه 5s فقط نمونه است و باید با رفتار واقعی سرویس هماهنگ شود. عمق 20 برای شروع کافی است و directive عمق به PHP 7.2 به بعد نیاز دارد. مسیر لاگ را مطابق بسته و سیاست سیستم آماده کنید؛ permission را با chmod 777 حل نکنید.

# In the affected pool configuration; paths and version are examples.
slowlog = /var/log/php8.3-fpm/site-slow.log
request_slowlog_timeout = 5s
request_slowlog_trace_depth = 20

۳. آزمون پذیرش

با باینری و فایل تنظیمات همان نسخه، syntax test و سپس reload کنترل‌شده انجام دهید. درخواست نماینده را تکرار و timestamp لاگ Slowlog را با access log تطبیق دهید. تکرار مسیر دیتابیس نیازمند بررسی Query و EXPLAIN است؛ توقف در HTTP Client نیازمند latency و timeout مقصد است. اصلاح محدود را با چند اجرای مشابه بسنجید و هم‌زمان نرخ خطا، صف Pool و مصرف حافظه را مقایسه کنید.

# Confirm the correct binary, configuration path and unit first.
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm
sudo tail -n 80 /var/log/php8.3-fpm/site-slow.log
sudo journalctl -u php8.3-fpm --since "15 minutes ago" --no-pager

خطاهای رایج و مرز تشخیص

Slowlog به‌تنهایی مشخص نمی‌کند یک خط علت اصلی است؛ Backtrace لحظه‌ای ممکن است محل انتظار عادی را نشان دهد. انتظار درخواست پیش از رسیدن به Worker هم از این Trace قابل اندازه‌گیری کامل نیست. request_slowlog_timeout با request_terminate_timeout فرق دارد: اولی ثبت Trace و دومی پایان Worker است. اگر لاگ خالی و خطای ptrace یا Permission در لاگ FPM وجود دارد، سیاست Container، Kernel و امنیت را بررسی کنید؛ محدودیت امنیتی را کورکورانه خاموش نکنید.

بازگشت و پیشگیری

پس از جمع‌آوری شواهد، آستانه یا فعال‌بودن Slowlog را متناسب با برنامه پایش تنظیم کنید؛ برای خاموش‌کردن ثبت کندی، request_slowlog_timeout را به مقدار قبلی یا 0 برگردانید و syntax test کنید. تغییرات unrelated در Pool، تعداد Workerها یا timeoutهای برنامه انجام ندهید. معیار پذیرش، کاهش قابل تکرار زمان درخواست همراه با سالم‌ماندن خطا، صف و حافظه است؛ خالی‌شدن Slowlog به‌تنهایی بهبود را ثابت نمی‌کند.

مطالعه مرتبط

برای ادامه بررسی، راهنمای تنظیم PHP-FPM و رفع خطای 504 Gateway Timeout؛ راهنمای عملی Poolها.

منابع رسمی