كل المقالات التقنية

صفحة حالة PHP-FPM: اعرفوا مدى ازدحام المجمّع فعلاً

فعّلوا pm.status_path وping في PHP-FPM وقيّدوا الوصول واستخدموا max children reached وlisten queue لضبط المجمّع.

صفحة حالة PHP-FPM: اعرفوا مدى ازدحام المجمّع فعلاً

ضبط pm.max_children دون بيانات تخمين. تخبركم صفحة حالة PHP-FPM بعدد العمليات النشطة وهل تنتظر الطلبات في طابور وهل بلغ المجمّع سقفه. يفعّلها هذا الدليل بأمان ويفسّر المخرجات.

١. التفعيل في المجمّع

; /etc/php/8.3/fpm/pool.d/www.conf (غيّروا الإصدار بما يناسب خادمكم)
pm.status_path = /fpm-status
ping.path = /fpm-ping
ping.response = pong

بعد التغيير أعيدوا تحميل خدمة PHP-FPM. وبدون تقييد الوصول تكشف هذه الصفحة معلومات داخلية.

٢. وصول مقيّد في Nginx

location = /fpm-status {
    allow 127.0.0.1;
    deny all;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;
    fastcgi_pass unix:/run/php/php-fpm.sock;
}

يُسمح للخادم نفسه فقط (127.0.0.1). ولا تجعلوا المسار عاماً.

٣. قراءة المخرجات

curl -s http://127.0.0.1/fpm-status

الحقول المهمة: active processes وidle processes تعرضان الحمل اللحظي، وlisten queue عدد الطلبات المنتظرة لعملية، وmax children reached عدد مرات امتلاء pm.max_children، وslow requests الطلبات الأبطأ من عتبة slowlog.

٤. اتخاذ القرار

إذا استمر max children reached بالارتفاع وكان listen queue غير صفري فالمجمّع صغير؛ لكن قبل رفعه قيسوا ذاكرة كل عملية حتى لا يبلغ الخادم OOM (الذاكرة وOOM). وإذا لم يمتلئ المجمّع أبداً فتكبيره لا يفيد. والضبط الكامل في ضبط المجمّع.

٥. المراقبة

سجّلوا المخرجات دورياً أو مرّروها إلى أداة مراقبة. ومسار ping مناسب لفحص صحة بسيط.

٦. مثال توضيحي وليس قياساً حقيقياً

لنفترض أنه في ساعة الذروة ارتفع max children reached من 0 إلى رقم كبير وكان listen queue موجباً. بعد رفع حذر لـ pm.max_children بحسب الذاكرة الحرة توقف العداد عن الصعود. هذا سيناريو مختلق للتوضيح وليس قياساً حقيقياً.

٧. أخطاء شائعة

  • ترك /fpm-status مفتوحاً للجميع.
  • رفع max_children دون قياس الذاكرة.
  • قراءة المخرجات مرة واحدة في ساعة هادئة.
  • نسيان إعادة التحميل بعد تغيير المجمّع.

٨. أسئلة شائعة

ما الفرق بين ping وstatus؟ ping يقول إنه حي فقط، وstatus يعطي إحصاءات كاملة.

ماذا يفعل ?full؟ يعرض أيضاً تفاصيل كل عملية.

وماذا عن عدة مجمّعات؟ لكل مجمّع مسار حالته.

٩. قائمة تحقق سريعة

  1. فُعّل status_path وping.
  2. قُيّد الوصول في Nginx.
  3. أُعيد التحميل.
  4. قُرئت المخرجات في ساعة الذروة.
  5. قورنت تغييرات المجمّع بالذاكرة.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

PHP manual: FPM configuration · Nginx ngx_http_fastcgi_module