قد تؤخر زيادة المهلة خطأ 504 دون إصلاح استعلام بطيء أو انتظار API خارجي. يسجّل PHP-FPM Slowlog تتبّعاً للطلب عندما يتجاوز عتبة محددة. نستخدمه لتحديد مسارات التنفيذ المتكررة وربطها بأدلة قاعدة البيانات والشبكة وPool، بدلاً من زيادة العمال أو مدة التنفيذ عشوائياً.
النطاق والمتطلبات
حدّد إصدار PHP واسم الخدمة وPool الفعّال؛ php8.3-fpm مثال لا اسم موحد. يلزم وصول مصرح به ونافذة تغيير ومسار تراجع. ضع Slowlog خارج Document Root وبصلاحيات محدودة. قد تكشف المسارات وأسماء الدوال تفاصيل تشغيلية؛ راجع السجلات قبل مشاركتها وحدّد الاحتفاظ بعد التحقيق.
١. اجمع الأدلة
سجّل التوقيت والمسار والمدة وحالة HTTP واتجاه الموارد. اجمع عينات ممثلة ولا تعتمد على فشل واحد. قارن زمن upstream بالمدة الإجمالية في خادم الويب. إذا كانت صفحة FPM Status موجودة، افحص العمال النشطين وlisten queue عبر مسار إداري محمي، ولا تنشر الصفحة للعامة.
٢. نفّذ تغييراً مضبوطاً
أضف أو عدّل slowlog وrequest_slowlog_timeout في Pool المتأثر دون تكرار التوجيهات. خمس ثوانٍ قيمة توضيحية تُضبط حسب الحمل. عمق 20 نقطة بداية، وتوجيه العمق متاح منذ PHP 7.2. جهّز مسار السجل وفق الحزمة والسياسة الأمنية، ولا تستخدم صلاحيات كتابة عامة مثل 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
٣. اختبارات القبول
افحص الإعداد بالباینري والمسار المطابقين للإصدار، ثم أعد التحميل بصورة مضبوطة. كرّر طلباً ممثلاً وطابق التوقيت مع access log. تكرار استدعاء قاعدة البيانات يستلزم فحص Query والخطة، والتوقف في HTTP Client يستلزم قياس الوجهة ومهلتها. اختبر الإصلاح في تشغيلات مماثلة مع الأخطاء والصف والذاكرة، لا زمن الاستجابة وحده.
# 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
الأخطاء الشائعة وحدود التشخيص
لا يثبت التتبّع اللحظي أن السطر الظاهر هو السبب الجذري؛ قد يكون انتظاراً عادياً. كما أنه لا يقيس كاملاً انتظار الطلب قبل وصوله إلى Worker. يسجّل request_slowlog_timeout التتبّع، بينما قد ينهي request_terminate_timeout العامل. عند غياب السجل وظهور أخطاء ptrace أو الصلاحيات، افحص سياسة الحاوية والنواة والأمان دون تعطيل الحماية عشوائياً.
التراجع والوقاية
بعد جمع الأدلة قرّر إبقاء Slowlog للمراقبة أو إعادة العتبة لقيمتها السابقة؛ صفر يعطّل تسجيل الطلبات البطيئة. افحص قبل إعادة التحميل مجدداً ولا تغيّر عدد العمال أو مهلات التطبيق غير المرتبطة. يتطلب القبول تحسناً متكرراً دون زيادة الأخطاء والصف والذاكرة؛ خلو Slowlog وحده لا يثبت تحسن الأداء.
قراءة ذات صلة
لمتابعة التشخيص، اقرأ دليل ضبط PHP-FPM وحل خطأ 504 Gateway Timeout: دليل عملي للـPool.
