لوحات معلومات الخوادم خضراء، وأزمنة استجابة الخدمات جيدة، ومع ذلك يتلقى الدعم شكاوى: «الموقع بطيء». الخادم لا يرى إلا جزءًا من الرحلة. يقيس RUM Dynatrace (مراقبة المستخدمين الفعليين، Real User Monitoring) ما يحدث في متصفح كل مستخدم: التحميل والعرض والتفاعلات وأخطاء JavaScript.
بالنسبة إلى مهندس SRE، هو المصدر الوحيد الذي يقول هل يصمد هدف مستوى الخدمة (SLO) من وجهة نظر المستخدم. وتمنح Core Web Vitals (وهي LCP وCLS وINP) لغة مشتركة مع فرق الواجهة الأمامية والمنتج: ثلاثة أرقام وعتبات معلنة وقراءة عند المئين 75 تجنّبك الاعتماد على متوسط مضلِّل.
هدف هذا الدرس: تفعيل RUM على تطبيق ويب، والتحقق من وصول البيانات، ثم قراءة Core Web Vitals بـ DQL. الإعداد صالح لـ Dynatrace SaaS وDynatrace Managed؛ أما استعلامات DQL على user.events فتخص تجربة RUM الجديدة على Grail، المتاحة في SaaS.
ما الذي تقيسه Core Web Vitals
| المؤشر | ما يقيسه | الحقل في user.events |
|---|---|---|
| LCP (Largest Contentful Paint) | اللحظة التي يظهر فيها أكبر عنصر مرئي | web_vitals.largest_contentful_paint |
| CLS (Cumulative Layout Shift) | الثبات البصري: هل «تقفز» الصفحة أثناء التحميل؟ | web_vitals.cumulative_layout_shift |
| INP (Interaction to Next Paint) | الاستجابة: التأخر بين نقرة وتحديث الشاشة | web_vitals.interaction_to_next_paint |
تنشر مشروع web.dev من Google عتبات «جيد / يحتاج تحسينًا / سيئ»؛ وهي تتطور، فارجع إلى الصفحة الرسمية بدل رقم منسوخ.
المتطلبات المسبقة
- بيئة Dynatrace SaaS أو Managed، مع صلاحية إعداد تطبيقات الويب.
- إما OneAgent مثبّت على خوادم الويب أو التطبيقات التي تقدّم صفحات HTML (حقن تلقائي)، وإما وصول إلى شيفرة التطبيق أو قالب HTML (إدراج يدوي).
- لاستعلامات DQL: تجربة RUM الجديدة مفعّلة على بيئة SaaS، ووصول إلى Notebooks.
- موافقة مسؤول حماية البيانات (DPO) على الجمع: عنوان IP وتعريف المستخدمين وSession Replay.
إعداد RUM Dynatrace خطوة بخطوة
الخطوة 1: اختر نمط الحقن
يؤدي طريقان إلى شيفرة JavaScript للمراقبة نفسها:
- الحقن التلقائي: يُدرج OneAgent، الموجود على خادم الويب، الوسم في كل صفحة HTML مقدَّمة. لا شيء يُعدَّل في الشيفرة؛ وهذا أسرع طريق.
- الإدراج اليدوي: تضيف الوسم في قالب HTML. لا غنى عنه حين لا يكون الخادم مزوّدًا بالقياس: CDN أو استضافة ثابتة أو خدمة SaaS من جهة خارجية أو تطبيق صفحة واحدة يُقدَّم من bucket.
الخطوة 2: صرّح بتطبيق الويب
أنشئ تطبيق الويب في إعدادات Dynatrace وحدّد قواعد الكشف (نطاق أو نمط URL) التي تربط الحركة بهذا التطبيق. تقسيم جيد: تطبيق لكل منتج يراه المستخدمون؛ وتجنّب جمع كل شيء في التطبيق الافتراضي، وإلا اختلطت Core Web Vitals الخاصة بالشبكة الداخلية بتلك الخاصة بالموقع العام.
الخطوة 3: احصل على الوسم للإدراج اليدوي
إذا اخترت الإدراج اليدوي، فاحصل على أحدث وسم عبر API (SaaS؛ وفي Managed يتبع عنوان URL الصيغة https://<votre-domaine>/e/<env-id>):
curl -s "$DT_URL/api/v2/rum/javaScriptTag/APPLICATION-0123456789ABCDEF?scriptExecutionAttribute=ASYNC" \
-H "Authorization: Api-Token $DT_API_TOKEN"
الاستجابة نص <script ...> يوضع في أعلى موضع ممكن داخل <head>. يقبل الوسيط scriptExecutionAttribute القيم ASYNC أو DEFER أو NONE. أتمت هذا الاستدعاء في عملية البناء: يشير الوسم إلى ملف إعداد يتطور مع إعدادات التطبيق. وللنطاق الدقيق للرمز، راجع صفحة الـ endpoint في الوثائق.
الخطوة 4: كيّف Content Security Policy
سياسة CSP صارمة تحجب بصمت السكربت أو إرسال البيانات. في أبسط حالة (حقن تلقائي وendpoint افتراضي للإشارات وSession Replay معطّل)، تكفي القاعدة الأساسية:
Content-Security-Policy: script-src 'self'; connect-src 'self';
إذا حُمّل السكربت من CDN أو أُرسلت الإشارات (beacons) إلى نطاق آخر، فأضف هذه المصادر إلى script-src وconnect-src. اختبر في بيئة ما قبل الإنتاج مع فتح وحدة تحكم المتصفح: يظهر فيها أي انتهاك لـ CSP فورًا.
الخطوة 5: اضبط الخصوصية
فعّل إخفاء عناوين IP، واحترم إشارة «Do Not Track» إذا اقتضت سياستك ذلك، ولا تعرّف المستخدمين إلا بمعرّف مستعار. وإذا فعّلت Session Replay، فاختر مستوى إخفاء يحجب حقول الإدخال (راجع Session Replay على Grail).
كيف تتحقق من أن الإعداد يعمل
افتح الصفحة في متصفح، ثم تبويب الشبكة في أدوات المطوّر: يجب أن ترى تحميل سكربت Dynatrace، ثم طلبات الإشارات بعد بضع تفاعلات. وفي Dynatrace تظهر الجلسات الأولى خلال دقائق.
في SaaS، مع تجربة RUM الجديدة، اقرأ LCP عند المئين 75 لكل صفحة في Notebook:
fetch user.events
| filter characteristics.has_page_summary
| filter isNotNull(web_vitals.largest_contentful_paint)
| summarize page_LCP = percentile(web_vitals.largest_contentful_paint, 75), by:{ page.name }
| sort page_LCP desc
ثم المؤشرات الثلاثة معًا، لكل تطبيق:
fetch user.events, from:now()-24h
| filter characteristics.has_page_summary
| summarize {
lcp_p75 = percentile(web_vitals.largest_contentful_paint, 75),
cls_p75 = percentile(web_vitals.cumulative_layout_shift, 75),
inp_p75 = percentile(web_vitals.interaction_to_next_paint, 75),
pages = count()
}, by:{ frontend.name }
عمود فارغ لـ INP ليس بالضرورة خطأ: لا يوجد المؤشر إلا إذا تفاعل المستخدم مع الصفحة. وفي Managed (RUM الكلاسيكي)، تُقرأ Core Web Vitals في تحليل تطبيق الويب وإجراءات المستخدم.
أفضل الممارسات
- قُد بالمئين 75، وليس بالمتوسط أبدًا: المتوسط يُخفي مستخدمي الهواتف البطيئين.
- قسّم بحسب الصفحة والجهاز: تراجع LCP يمس غالبًا قالبًا واحدًا.
- حوّل مؤشرًا إلى SLO: مثلًا «90% من صفحات الدفع بـ LCP جيد» على 28 يومًا، مع تنبيهات burn rate بدل عتبة ثابتة.
- اربط الواجهة الأمامية بالخلفية: إجراء بطيء يُتتبَّع حتى spans الخدمة المستدعاة (راجع OpenTelemetry من البداية إلى النهاية).
- كمّل بالمراقبة الاصطناعية للساعات التي لا حركة فيها، حيث لا يجد RUM ما يقيسه.
الأسئلة الشائعة
هل يبطئ RUM الصفحات؟
يُحمَّل السكربت بشكل غير متزامن ويرسل بياناته دفعات. تكلفته منخفضة، لكن قِسها: قارن LCP قبل التفعيل وبعده على صفحة اختبار في بيئة ما قبل الإنتاج.
لماذا لا تصل أي بيانات مع أن الوسم موجود؟
الأسباب الثلاثة الأكثر شيوعًا: سياسة CSP تحجب السكربت أو الإشارات، أو قاعدة كشف تربط الحركة بتطبيق آخر، أو مانع إعلانات على جهاز الاختبار. تحقق من تبويب الشبكة ثم وحدة التحكم.
هل يجب تفعيل Session Replay في الوقت نفسه؟
لا، فهو خيار منفصل. ابدأ بـ RUM وحده، وتحقق من الخصوصية مع مسؤول حماية البيانات، ثم فعّل Session Replay على نسبة صغيرة من الجلسات.
الخلاصة
يُعدّ RUM Dynatrace في ساعة واحدة: حقن تلقائي أو وسم يدوي، وCSP ملائمة، وقواعد خصوصية واضحة. ثم يبدأ العمل الحقيقي: قراءة LCP وCLS وINP عند المئين 75، صفحة بصفحة، وتحويلها إلى أهداف مستوى خدمة تعكس أخيرًا ما يعيشه المستخدمون.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية تعود إلى مالكها. تتطور أسماء الحقول والشاشات والإعدادات، لذا تحقق منها في الوثائق الرسمية لإصدارك.