RUM Elastic APM: تفعيل RUM وقراءة مقاييس التنقل

RUM Elastic APM: فعّل RUM في APM Server وهيّئ وكيل JavaScript واقرأ spans التنقل page-load، مع ضبط CORS وخطوات التحقق من سلامة العمل.
RUM Elastic APM : activer le RUM et lire les métriques de navigation

يقيس RUM Elastic APM ما يعيشه مستخدموك في المتصفح: أزمنة التحميل وطلبات XHR والتنقلات. بالنسبة لمهندس SRE، هذا هو الجزء من الرحلة الذي لا تراه مقاييس الخادم. وفق وثائق Elastic، فإن مراقبة المستخدمين الفعليين (Real User Monitoring) «تلتقط تفاعل المستخدمين مع العملاء مثل متصفحات الويب»، بفضل وكيل JavaScript من Elastic.

يوضح هذا الدرس كيفية تفعيله من البداية إلى النهاية: في APM Server، ثم في صفحة الويب، ثم في الواجهة. كما يحدد ما تؤكده الوثائق بشأن مقاييس التنقل. ليس أي مما يرد هنا قياسًا أجرته span.observer: السلوكيات الموصوفة مأخوذة من وثائق Elastic التي اطُّلع عليها في 30 أكتوبر 2026.

باختصار

  • RUM معطّل افتراضيًا في APM Server: يجب ضبط apm-server.rum.enabled على true (أو تحديد «Enable RUM» عند استخدام Fleet).
  • يعمل الوكيل داخل المتصفح، لذلك تُشترط المصادقة المجهولة.
  • اسم حزمة npm الخاصة بالوكيل هو @elastic/apm-rum. وينشئ معاملات page-load وroute-change وuser-interaction.
  • تسرد صفحة المرجع أيضًا مقاييس Core Web Vitals (‏LCP وINP وCLS وFID)، مع حدود دعم تختلف حسب المتصفح.

RUM Elastic APM: المشكلة والهدف

قد تستجيب الخدمة خلال 80 ms على الخادم وتبدو بطيئة على الشاشة. يختبئ الوقت الضائع في DNS أو الاتصال أو تحليل المستند أو تنفيذ السكربتات. بدون قياس في المتصفح، يعمل فريق المنصة على تصحيح الأخطاء دون رؤية.

الهدف هنا بسيط: الحصول على معاملة page-load واحدة لكل زيارة، مع spans الخاصة بـ Navigation Timing، في Elastic APM. هذا ليس تتبعًا على جهة الخادم. الوكيل التقليدي في APM يراقب الطلبات والاستجابات، أما وكيل RUM فيراقب التجربة في تطبيق العميل.

انتبه إلى نقطة توافق. وفق صفحة تقديم الوكيل، هو غير متوافق مع Elastic Cloud Serverless، لأنه لا يستطيع إرسال البيانات إلى نقاط نهاية APM الخاصة بالنمط serverless. يفترض هذا المقال وجود APM Server مُدار ذاتيًا أو عبر Fleet.

المتطلبات

  • خادم APM Server مركزي: ملف تنفيذي مستقل أو مُدار عبر Fleet. تشترط الوثائق ذلك لـ RUM.
  • وصول إلى إعدادات APM Server ‏(apm-server.yml أو سياسة الوكيل في Fleet).
  • تطبيق ويب أمامي. الوكيل «محايد» تجاه الإطار: يصلح أي إطار JavaScript، بحسب Elastic.
  • متصفح حديث للاختبار. يختلف الدعم حسب المقياس (انظر أدناه).

الإصدارات: لا تحدد وثائق «current» من Elastic إصدارًا للوكيل في الصفحات التي قُرئت. دوّن إصدار @elastic/apm-rum المثبّت في مشروعك. هذه المعلومة غير متحقق منها هنا.

الخطوة 1: تفعيل RUM في APM Server

وفق صفحة إعدادات RUM، الميزة معطّلة افتراضيًا. مع الملف التنفيذي، تُصرَّح بها في apm-server.yml. مع Fleet، افتح سياسة الوكيل، وعدّل تكامل Elastic APM، وفعّل «Enable RUM» في قسم Real User Monitoring.

ملف apm-server.yml: القيمة true لـ apm-server.rum.enabled، وحدود المصادقة المجهولة، وallow_origins وsource_mapping

تعيد هذه الكتلة مثال الوثائق، دون مفتاح API. الأسطر التي ينبغي فهمها:

  • apm-server.rum.enabled: true: يفعّل نقطة نهاية RUM (الافتراضي false).
  • apm-server.auth.anonymous.rate_limit.event_limit وip_limit: يحدّان من معدل الأحداث المجهولة. تعطي الوثائق القيمتين 300 و1000 في مثالها، ولا تذكر قيمة افتراضية.
  • apm-server.auth.anonymous.allow_service: يقيّد أسماء الخدمات المقبولة. ضع فيه serviceName الخاص بواجهتك الأمامية.
  • apm-server.rum.allow_origins: الافتراضي ['*']، أي جميع النطاقات. في الإنتاج، اذكر أصولك (origins).
  • apm-server.rum.source_mapping.enabled: الافتراضي true؛ وقراءة source maps تتطلب صلاحيات إضافية.

نقطة مفيدة أخرى: إذا كان مفتاح API أو secret token مضبوطًا، فإن تفعيل RUM يفعّل المصادقة المجهولة تلقائيًا. وتبرر الوثائق ذلك بأن وكيل RUM يعمل في المتصفح، فلا يستطيع حفظ سر.

من ناحية الموثوقية، هذا تنازل يجب تقبّله. نقطة النهاية عامة. وتحمي حدود المعدل وallow_service ميزانية أخطائك… وتخزينك، من الضوضاء أو إساءة الاستخدام.

الخطوة 2: تثبيت وكيل RUM في التطبيق

مع أداة تجميع (bundler)، ثبّت الحزمة ثم هيّئ الوكيل في أبكر وقت ممكن. هذه هي التهيئة الواردة في الوثائق، بقيم مثالية.

كود JavaScript: استيراد init من @elastic/apm-rum ثم initApm مع serviceName وserverUrl وserviceVersion وenvironment

الخيارات المفيدة، وفق صفحة الإعدادات:

  • serviceName: إلزامي، بلا قيمة افتراضية؛ حروف وأرقام ومسافات وشرطات سفلية وشرطات فقط.
  • serverUrl: الافتراضي http://localhost:8200. استبدله بعنوان APM Server الخاص بك.
  • serviceVersion: إصدار التطبيق أو مرجع git؛ يستخدمه APM Server للعثور على source map الصحيح.
  • environment: إنتاج أو اختبار وغيرهما. يعمل كمرشح عام في تطبيق APM.
  • transactionSampleRate: الافتراضي 1.0، أي تؤخذ عينات من جميع المعاملات.
  • distributedTracingOrigins: الافتراضي []. تتلقى الأصول المذكورة الترويسة traceparent.

بدون أداة تجميع، تقترح الوثائق أيضًا وسم script يحمّل حزمة UMD من unpkg، ثم elasticApm.init({ serviceName, serverUrl }). وتوصي في الإنتاج باستضافة الملف على خادمك أو شبكة CDN الخاصة بك. ومع التحميل غير المتزامن، لا يعمل التتبع الموزّع للطلبات الصادرة قبل تهيئة الوكيل.

الخطوة 3: ضبط CORS إذا اختلفت الأصول

إذا لم يكن لـ APM Server الأصل نفسه الذي للصفحة، يرسل المتصفح طلب OPTIONS تمهيديًا قبل POST. ويفشل هذا الطلب إذا لم يكن RUM مفعّلًا في APM Server، كما توضح الوثائق. في هذه الحالة، اذكر الأصول المسموح بها عبر apm-server.rum.allow_origins.

إذا وُضع وكيل (proxy) أمام APM Server، فيجب أن يردّ على الطلب التمهيدي بـ Access-Control-Allow-Headers: Content-Type وAccess-Control-Allow-Methods: POST, OPTIONS وAccess-Control-Allow-Origin بأصل الطلب. ومع الخيار sendCredentials، يلزم أيضًا Access-Control-Allow-Credentials: true. لفهم هذا النوع من الأخطاء بصورة أفضل، اقرأ دليلنا عن طلب XHR وحظر CORS.

قراءة مقاييس التنقل

بعد إعادة تحميل الصفحة، يرسل الوكيل معاملة page-load. وفق الوثائق، تغطي الصفحة وموارده، وتُقاس منذ fetchStart. وتتبع spans الخاصة بها واجهة Navigation Timing.

spans معاملة page-load في Elastic APM RUM وصيغ Navigation Timing المرتبطة بها، مع العلامتين timeToFirstByte وdomComplete

عمليًا، تقرأ:

  • تحليل DNS، واتصال TCP (بما فيه TLS)، واستجابة الخادم؛
  • تحليل المستند وتنفيذ السكربتات المتزامنة؛
  • الحدثين DOMContentLoaded وload؛
  • زمن Time to First Byte، المخزَّن في العلامة transaction.marks.agent.timeToFirstByte.

قد تتجاوز مدة page-load الحدث load في المتصفح. للحصول على قياس دقيق لهذا الحدث، استخدم span «Fire load event» أو العلامة transaction.marks.agent.domComplete.

أنواع المعاملات الأخرى هي user-interaction (النقرات؛ تُستبعد المعاملة التي بلا span) وroute-change (نقرة تغيّر المسار). كما تُلتقط أحداث pushState في تطبيقات الصفحة الواحدة.

وماذا عن Core Web Vitals؟

تذكر صفحة التقديم «FCP وLCP وINP وFID» ضمن المقاييس المتمحورة حول المستخدم. وتفصّل صفحة المرجع أيضًا CLS وTBT والمهام الطويلة. لكن الدعم يعتمد على المتصفح:

  • FCP: المتصفحات المبنية على Chromium ‏(Chrome > 60 وEdge > 79 وOpera > 47)؛
  • LCP: Chrome > 77 فقط؛
  • FID: Chrome > 85 فقط؛
  • INP وCLS وTBT: لا تذكر الصفحة أي دعم.

فلا تفترض تغطية موحّدة. قارن دائمًا بما تنتجه حركة المرور الفعلية لديك.

كيف تتحقق من أن كل شيء يعمل

  1. أعد تحميل الصفحة وعلامة تبويب Network في أدوات المطور مفتوحة. ابحث عن طلب POST إلى serverUrl الخاص بك. المتوقع حالة 2xx.
  2. إذا ظهر فشل في الطلب التمهيدي، ارجع إلى الخطوة 3: هل RUM مفعّل؟ هل الأصل مسموح به؟
  3. في Kibana، افتح Observability > APM وابحث عن serviceName الخاص بك. رشّح حسب نوع المعاملة page-load. المسار الدقيق للقوائم يعتمد على إصدارك: غير متحقق منه هنا.
  4. افتح معاملة وتحقق من spans الظاهرة في اللقطة 3 ومن العلامة timeToFirstByte.

أفضل الممارسات

  • قيّد allow_origins وallow_service منذ الانتقال إلى الإنتاج.
  • املأ serviceVersion وenvironment لربط الأخطاء بعمليات النشر وsource maps.
  • أبقِ transactionSampleRate عند 1.0 في البداية، ثم خفّضه إذا أثقل الحجم التخزين.
  • عرّف SLO للتنقل انطلاقًا من القيم المرصودة فعليًا، لا من عتبات نظرية.
  • استضف حزمة الوكيل بنفسك بدل الاعتماد على unpkg.

ما العلاقة بـ OpenTelemetry وDynatrace؟

الوكيل @elastic/apm-rum وكيل خاص بـ Elastic، وليس SDK من OpenTelemetry. تتجه البيانات إلى APM Server وفق بروتوكول الاستقبال الخاص به. إذا كانت استراتيجيتك قائمة على OpenTelemetry، فقارن أولًا فروق نموذج البيانات. يوضح مقالنا عن OpenTelemetry وPrometheus كيف تفكر في تكامل المعايير المفتوحة.

إذا كنت تستخدم Dynatrace، فإن RUM يعمل فيها بطريقة مختلفة، بوكيل JavaScript خاص بالمنصة. يفصّل مقالنا عن RUM في Dynatrace وCore Web Vitals هذا النهج لـ Dynatrace SaaS؛ وتضع المقارنة Dynatrace مقابل Datadog هذه الخيارات في سياق أوسع. لا يوجد أي تكامل موثّق بين وكيل Elastic RUM وDynatrace: لا تفترض وجوده.

وأخيرًا، انتبه إلى الفرق بين القياس والمراقبة الشاملة: شرحناه في قابلية الملاحظة مقابل المراقبة.

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

هل RUM Elastic APM مفعّل افتراضيًا؟

لا. تشير وثائق APM Server إلى أن RUM معطّل افتراضيًا. يجب ضبط apm-server.rum.enabled: true أو تفعيل «Enable RUM» في تكامل Elastic APM ضمن Fleet.

لماذا تلزم المصادقة المجهولة؟

يعمل وكيل RUM في متصفح المستخدم، وأي سر سيكون مرئيًا. عند وجود مفتاح API أو secret token، يفعّل تفعيل RUM المصادقة المجهولة تلقائيًا. قيّدها بـ allow_service وبحدود المعدل.

هل يقيس الوكيل Core Web Vitals؟

تصف وثائق Elastic المقاييس LCP وINP وCLS وFID، مع حدود تتعلق بالمتصفح: يُعلن مثلًا أن LCP وFID لـ Chrome فقط. تحقق من القيم على حركة المرور الخاصة بك قبل تحديد SLO.

الخلاصة

يتلخص تفعيل RUM Elastic APM في ثلاث خطوات: apm-server.rum.enabled: true، وتهيئة @elastic/apm-rum بـ serviceName وserverUrl، ثم معالجة CORS. وتأتي القيمة بعد ذلك من قراءة معاملات page-load وspans الخاصة بها. ابدأ بخدمة تجريبية وحدد هدفًا أوليًا للتنقل.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Elastic N.V. Dynatrace علامة تجارية لشركة Dynatrace LLC. المعلومات مأخوذة من وثائق Elastic الرسمية التي اطُّلع عليها في 30 أكتوبر 2026: تثبيت وكيل RUM وإعدادات RUM في APM Server. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك قبل أي نشر في الإنتاج.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Facturation Datadog APM : hôtes au 99e centile et spans indexés

فوترة Datadog APM: مضيفو المئين 99 والـ spans المفهرَسة

Next Post
Circuit breaker Elasticsearch : diagnostiquer un heap saturé

circuit breaker Elasticsearch: تشخيص امتلاء الذاكرة heap

Related Posts