زبائن لا يصلون إلى موقعك ولا أثر في السجلات؟ تقارير NEL
باختصار: أصعب الأعطال على صاحب الموقع هي التي لا يراها: زبون في الزرقاء لا يفتح معه الموقع بسبب مشكلة في الطريق بين جهازه وخادمك، فلا يصل طلبه إلى سجلات الخادم أصلاً، ولا يعرف أحد أنه حاول. آلية Network Error Logging أو NEL تتيح لموقعك أن يطلب من المتصفحات الداعمة إرسال تقارير عن الطلبات التي فشلت، مثل فشل حل الاسم أو انقطاع الاتصال أو حلقة تحويل، إلى عنوان تحدده. تصفها MDN بأنها تقنية تجريبية، فهي لا تغطي كل الزوار، لكنها تكشف أنماطاً لا تكشفها أي أداة أخرى من جهة الخادم.
العطل الذي لا يظهر في السجلات
شركة صغيرة لخدمات التنظيف في عمّان تستقبل طلباتها من نموذج على الموقع. في أحد الأسابيع انخفضت الطلبات فجأة، لكن سجلات الخادم كانت نظيفة: لا أخطاء، ولا انقطاع. ثم اتصلت زبونة دائمة لتقول إن الموقع «لا يفتح من البيت» منذ أيام، بينما يفتح من عملها.
السجلات كانت نظيفة لأن الطلبات الفاشلة لم تصل إلى الخادم أصلاً. ما يحدث بين جهاز الزبون وخادمك، من حل اسم النطاق إلى فتح الاتصال إلى إتمام التشفير، يمكن أن يفشل في أماكن لا يسجلها خادمك. وأدوات مراقبة التوفر التي تفحص الموقع من مكان واحد قد لا ترى مشكلة تخص مزود إنترنت معيناً أو منطقة معينة.
ما هي NEL
تشرح MDN أن Network Error Logging آلية تُضبط عبر ترويسة استجابة HTTP اسمها NEL، وأن هذه الترويسة التجريبية تسمح للمواقع والتطبيقات بالاشتراك في تلقي تقارير عن طلبات الشبكة الفاشلة، وإن رغبت، الناجحة أيضاً، من المتصفحات الداعمة. وتُرسل التقارير إلى مجموعة تقارير معرّفة في ترويسة Report-To.
الفكرة: في زيارة ناجحة، يخبر موقعك المتصفح «إن فشل معك طلب لهذا الموقع لاحقاً، أرسل تقريراً إلى هذا العنوان». وعندما يفشل طلب في المستقبل، يرسل المتصفح التقرير متى استطاع.
الترويستان
مثال MDN بترويستين في رد الخادم:
Report-To: { "group": "nel", "max_age": 31556952, "endpoints": [ { "url": "https://example.com/csp-reports" } ] }
NEL: { "report_to": "nel", "max_age": 31556952 }
وتذكر MDN أن الأصل يجب أن يكون آمناً في نظر المتصفح، أي عبر HTTPS. وتشرح المفاتيح:
- report_to: اسم مجموعة التقارير التي تُرسل إليها تقارير الأخطاء.
- max_age: مدة صلاحية السياسة بالثواني، بطريقة تشبه سياسات HSTS المحددة بزمن. وتنبه MDN إلى أن مجموعة التقارير يجب أن تكون صلاحيتها على الأقل بطول سياسة NEL.
- include_subdomains: إن كانت true، تُطبق السياسة على النطاقات الفرعية أيضاً، لكن فقط لأخطاء حل الأسماء DNS.
- success_fraction: نسبة الطلبات الناجحة المطلوب الإبلاغ عنها، بين 0 و1، والافتراضي 0.
- failure_fraction: نسبة الطلبات الفاشلة المطلوب الإبلاغ عنها، والافتراضي 1، أي كلها.
ماذا تخبرك التقارير
كل تقرير بحسب أمثلة MDN يحمل نوع الخطأ والمرحلة التي حدث فيها والعنوان والوقت المستغرق ورمز الحالة إن وُجد. ومن أنواع الأخطاء التي تسردها MDN:
- dns.name_not_resolved: خادم DNS لدى المستخدم ردّ لكنه لم يستطع حل عنوان للرابط المطلوب.
- dns.unreachable: خادم DNS لدى المستخدم غير قابل للوصول.
- tcp.timed_out: انتهت مهلة الاتصال بالخادم.
- tcp.refused: الخادم رفض الاتصال.
- tcp.reset: أُعيد ضبط الاتصال.
- http.error: وصل رد، لكن برمز 4xx أو 5xx.
- http.response.redirect_loop: أُوقف الطلب بسبب حلقة تحويل.
وتذكر MDN أن المتصفحات يمكنها إضافة أنواع خاصة بها إلى هذه القائمة.
مثال توضيحي لقراءة نمط
مثال توضيحي: بعد تفعيل NEL أسبوعين، تجمّع شركة التنظيف التقارير في جدول بسيط. تلاحظ أن معظم أخطاء dns.name_not_resolved جاءت في يومين محددين، وكلها لطلبات الصفحة الرئيسية. هذا يطابق اليوم الذي غيّر فيه المطور خوادم الأسماء. وتلاحظ مجموعة صغيرة من http.response.redirect_loop على صفحة النموذج فقط، فتكتشف قاعدة تحويل خاطئة بين النسخة بـ www ودونها.
لا شيء من هذا كان سيظهر في سجلات الخادم، لأن الطلبات لم تكتمل.
أين ترسل التقارير
نقطة عملية مهمة: إن كان عنوان استقبال التقارير على الخادم نفسه الذي يتعطل، فقد لا تصل التقارير وقت العطل. الأفضل أن يكون عنوان الاستقبال على خدمة أو نطاق منفصل عن موقعك الرئيسي، حتى يبقى متاحاً عندما يتعثر الموقع. وهناك خدمات مراقبة تقدم استقبال هذه التقارير، أو يستطيع مطورك بناء نقطة استقبال بسيطة تحفظها في ملف.
خطة تفعيل بسيطة لموقع صغير
لا تحتاج إلى نظام مراقبة كامل لتبدأ. مثال توضيحي لخطة من أربع خطوات:
- نقطة استقبال: عنوان على نطاق فرعي أو خدمة منفصلة، يقبل التقارير ويحفظها كما هي مع وقت وصولها.
- الترويستان: يضيفهما المطور إلى ردود الصفحات الرئيسية، بمدة صلاحية تبدأ قصيرة، أسابيع لا سنة، حتى تتأكد أن كل شيء يعمل.
- مراجعة أسبوعية: شخص واحد يفتح التقارير كل أسبوع، ويجمعها حسب نوع الخطأ والصفحة واليوم.
- ربطها بالأحداث: دوّن بجانب كل تغيير تقني، كنقل الاستضافة أو تعديل التحويلات أو تجديد الشهادة، تاريخه. هكذا تفهم بسرعة إن كانت موجة أخطاء جاءت بعد تغيير معين.
بعد شهر أو اثنين، ستعرف إن كانت التقارير تفيدك فعلاً، وتقرر هل تطيل المدة أم تكتفي.
انتبه إلى الخصوصية والحجم
- التقارير تحتوي روابط: إن كانت روابط موقعك تحمل بيانات شخصية في عنوانها، كرقم هاتف في رابط تتبع الطلب، فستظهر في التقارير. راجع ذلك قبل التفعيل.
- لا تطلب الطلبات الناجحة إلا لحاجة: success_fraction افتراضياً 0. رفعها يملأ نقطة الاستقبال بتقارير كثيرة لا تفيد صاحب موقع صغير.
- اجعل max_age معقولاً: السياسة تبقى في المتصفح طوال مدتها. إن غيّرت عنوان الاستقبال، فالمتصفحات القديمة قد تستمر في الإرسال للعنوان السابق حتى تنتهي المدة.
ما لا تفعله NEL
- لا تصل من كل الزوار، لأنها تجريبية ومحدودة الدعم.
- لا ترسل تقريراً من زائر لم يزر موقعك بنجاح من قبل، لأن السياسة تُحفظ من رد سابق.
- لا تغني عن مراقبة التوفر التقليدية، بل تكملها من جهة الزبون، وتعطيك منظوراً لا تراه من الخادم.
أسئلة شائعة
هل تكشف NEL لماذا لا يفتح الموقع عند زبون معين؟
قد تكشف نوع الفشل، كخطأ في حل الاسم أو انتهاء مهلة، إن كان متصفحه يدعمها وزار الموقع بنجاح سابقاً. لكنها لا تخبرك بهوية الزبون.
هل تبطئ الموقع؟
هي ترويستان في الرد، والتقارير ترسلها المتصفحات لاحقاً. الأثر على تحميل الصفحة صغير، لكن نقطة الاستقبال يجب أن تتحمل التقارير.
هل أحتاج إلى HTTPS؟
نعم. تذكر MDN أن الأصل يجب أن يكون آمناً في نظر المتصفح.
هل التقارير تشمل النطاقات الفرعية؟
فقط إن ضبطت include_subdomains، ولأخطاء DNS وحدها بحسب MDN.
إذا كانت طلباتك تنخفض أحياناً دون أن تجد سبباً في سجلات الخادم، تواصل معنا لنضيف مراقبة من جهة الزبون إلى موقعك.