الوحدة 4 — مقاييس التطبيقات builtin في Dynatrace Managed: RUM والجوال والمراقبة الاصطناعية

مقاييس التطبيقات builtin في Dynatrace Managed: Apdex وCore Web Vitals وأخطاء RUM وانهيارات الجوال والتوافر الاصطناعي، في 23 بطاقة باستعلامات جاهزة.
Module 4 — Applications : les métriques application builtin, RUM web, mobile et synthétique

الوحدة 4 من مسار مقاييس Dynatrace Managed: مقاييس التطبيقات builtin الخاصة بـRUM للويب والجوال والمراقبات الاصطناعية (Apdex وإجراءات المستخدم وCore Web Vitals والأخطاء والانهيارات)، في 23 بطاقة بمفتاح دقيق ووحدة وحالة استخدام وselector جاهز للصق.

المسار: تدريب مقاييس Dynatrace Managed · الوحدة 4/7 · النوع: مرجع · المنصة: Dynatrace Managed (المقاييس الكلاسيكية)

في هذه الوحدة:

  • جدول موجز للمفاتيح الـ23، لتبقيه في متناولك
  • بطاقة لكل مقياس: ما يقيسه ومتى يُستخدم والفخ الذي ينبغي تفاديه
  • metric selector لكل بطاقة، يمكن تجربته في Data Explorer

تنظر الوحدات السابقة إلى النظام من الداخل: المضيفون والخدمات وقواعد البيانات. وتنظر هذه الوحدة من جهة المستخدم. يقيس RUM ما يعيشه الزوار الفعليون في متصفحهم أو تطبيقهم على الجوال؛ ويعيد المراقب الاصطناعي تشغيل مسار بفاصل ثابت، حتى ليلًا حين لا يتصل أحد. وبهما معًا تحصل على مؤشرات SLI الأقرب إلى ما يشعر به العميل.

كل ما يلي صالح لـDynatrace Managed: مفاتيح builtin:apps.* وbuiltin:synthetic.* وmetric selector وMetrics API v2 وData Explorer. لا Grail ولا DQL هنا. وفي Dynatrace SaaS مع Grail يستخدم RUM والمراقبة الاصطناعية مفاتيح أخرى؛ وهي مشروحة في مسار مقاييس SaaS.

تواصل هذه الوحدة الوحدة 3 المخصصة للخدمات: فإجراء مستخدم بطيء يُقرأ غالبًا مع الخدمة التي يستدعيها. وللإعداد راجع RUM وCore Web Vitals والمراقبة الاصطناعية بـHTTP والمتصفح.

مقاييس التطبيقات builtin في جدول

كل المفاتيح والوحدات والتجميعات أدناه مأخوذة من القائمة الرسمية للمقاييس المدمجة في Dynatrace Managed. يعيد عمود «النطاق» تسمية الوثائق ([web] و[mobile, custom] و[browser monitor] و[HTTP monitor])؛ وتُقرأ الأبعاد الدقيقة في وصف كل مقياس. والوحدة الفارغة تعني درجة بلا وحدة.

المفتاح الوحدة التجميعات النطاق ما يقيسه
builtin:apps.web.apdex.userType (درجة) avg ويب Apdex لإجراءات المستخدم، بحسب نوع المستخدم
builtin:apps.web.actionCount.load.browser Count value ويب عدد إجراءات التحميل، بحسب المتصفح
builtin:apps.web.actionDuration.load.browser Millisecond avg, count, max, median, min, percentile, sum ويب مدة إجراءات التحميل
builtin:apps.web.actionDuration.xhr.browser Millisecond avg, count, max, median, min, percentile, sum ويب مدة إجراءات XHR
builtin:apps.web.visuallyComplete.load.browser Millisecond avg, count, max, median, min, percentile, sum ويب زمن اكتمال عرض المنطقة المرئية
builtin:apps.web.largestContentfulPaint.load.browser Millisecond avg, count, max, median, min, percentile, sum ويب Largest Contentful Paint (LCP)
builtin:apps.web.cumulativeLayoutShift.load.browser (درجة) avg, count, max, median, min, percentile, sum ويب Cumulative Layout Shift (CLS)
builtin:apps.web.interactionToNextPaint Millisecond count, max, median, min, percentile ويب Interaction to Next Paint (INP)
builtin:apps.web.activeSessions Count value ويب الجلسات النشطة المقدَّرة
builtin:apps.web.bouncedSessionRatio Percent (%) value ويب معدل الارتداد
builtin:apps.web.countOfErrors Count value ويب الأخطاء المكتشفة، بحسب النوع والمصدر
builtin:apps.web.jsErrorsDuringUa Count value ويب أخطاء JavaScript أثناء إجراء مستخدم
builtin:apps.web.percentageOfUserActionsAffectedByErrors Percent (%) value ويب نسبة إجراءات المستخدم المتأثرة بخطأ
builtin:apps.other.apdex.osAndVersion (درجة) value جوال، مخصص Apdex بحسب نظام التشغيل وإصدار التطبيق
builtin:apps.other.uaDuration.osAndVersion Microsecond avg, count, max, median, min, percentile, sum جوال، مخصص مدة إجراءات المستخدم
builtin:apps.other.crashCount.osAndVersion Count value جوال، مخصص الانهيارات المكتشفة، بحسب النظام والإصدار
builtin:apps.other.crashFreeUsersRate.os Percent (%) value جوال، مخصص النسبة المقدَّرة للمستخدمين بلا انهيار
builtin:synthetic.browser.availability.location.total Percent (%) avg مراقب المتصفح معدل التوافر، بحسب الموقع
builtin:synthetic.browser.failure Count value مراقب المتصفح عمليات التنفيذ الفاشلة
builtin:synthetic.browser.totalDuration Millisecond avg, count, max, median, min, percentile, sum مراقب المتصفح المدة الإجمالية لإجراءات تنفيذ واحد
builtin:synthetic.http.availability.location.total Percent (%) avg مراقب HTTP معدل التوافر، بحسب الموقع
builtin:synthetic.http.duration.geo Millisecond avg, count, max, min, sum مراقب HTTP المدة التراكمية للطلبات، بحسب الموقع
builtin:synthetic.http.statusCode Count value مراقب HTTP عمليات التنفيذ بحسب رمز حالة HTTP
مقتطف من وثائق Dynatrace Managed: مفاتيح builtin:apps.web وapps.other وsynthetic مع أسمائها ووحداتها وتجميعاتها

كيف تقرأ بطاقة

تتبع كل بطاقة الترتيب نفسه: ما يقيسه المقياس، وحالة استخدام ملموسة، وفخ، ثم selector. وتقسّم الـselectors بحسب dt.entity.application للويب، وdt.entity.synthetic_test لمراقبات المتصفح، وdt.entity.http_check لمراقبات HTTP، مع التحويلات الموثقة فقط (splitBy وsort وlimit والتجميعات وpercentile). والعتبات المذكورة مراجع تُعايَر على تاريخك، لا قيم رسمية، ما لم يُذكر خلاف ذلك صراحة.

تطبيقات الويب: التجربة والأداء

builtin:apps.web.apdex.userType

درجة Apdex من 0 إلى 1 محسوبة على إجراءات المستخدم، وقابلة للتقسيم بحسب نوع المستخدم (حقيقي أو اصطناعي أو روبوت). وهي المؤشر الملخِّص للتجربة: تجمع الراضين والمتسامحين والمحبَطين وفق العتبات المضبوطة في التطبيق. حالة الاستخدام: هدف SLO باسم «Apdex المستخدمين الحقيقيين» لكل تطبيق. الفخ: دون تصفية نوع المستخدم تختلط الروبوتات والمراقبة الاصطناعية بالحركة الحقيقية.

builtin:apps.web.apdex.userType:splitBy("dt.entity.application"):avg:sort(value(avg,ascending)):limit(10)

builtin:apps.web.actionCount.load.browser

عدد إجراءات تحميل الصفحات، مقسّمًا بحسب المتصفح. وهو الحركة كما يراها العميل، نظير معدل معالجة الخدمات. حالة الاستخدام: انخفاض مفاجئ بينما تستجيب الخدمات طبيعيًا يدل غالبًا على مشكلة في CDN أو DNS أو في حقن JavaScript الخاص بـRUM. الفخ: لإجراءات XHR والإجراءات المخصصة مفاتيحها الخاصة؛ والتطبيق ذو الصفحة الواحدة يولّد القليل من «load».

builtin:apps.web.actionCount.load.browser:splitBy("dt.entity.application"):sum

builtin:apps.web.actionDuration.load.browser

مدة إجراءات التحميل، من النقرة إلى نهاية التحميل. حالة الاستخدام: تتبّع المئين 90 لكل تطبيق بدل المتوسط الذي يخفي الذيل البطيء. الفخ: تشمل هذه المدة شبكة العميل والعرض؛ فارتفاعها لا يأتي بالضرورة من الخلفية.

builtin:apps.web.actionDuration.load.browser:splitBy("dt.entity.application"):percentile(90)

builtin:apps.web.actionDuration.xhr.browser

مدة إجراءات XHR، أي الاستدعاءات غير المتزامنة التي تطلقها نقرة داخل صفحة محمَّلة. وفي تطبيق الصفحة الواحدة تكون غالبًا مقياس الأداء الرئيسي. حالة الاستخدام: ربط ارتفاع بزمن استجابة الخدمة المستدعاة (الوحدة 3). الفخ: قد تضخّم استدعاءات الخلفية سيئة التجميع القياس أو تشوّهه.

builtin:apps.web.actionDuration.xhr.browser:splitBy("dt.entity.application"):percentile(90)

builtin:apps.web.visuallyComplete.load.browser

الزمن اللازم ليكتمل عرض محتوى المنطقة المرئية. وهو مقياس خاص بـDynatrace، يلتصق بإحساس «الصفحة جاهزة». حالة الاستخدام: المقارنة قبل نشر واجهة أمامية وبعده. الفخ: قد يؤخر شريط عرض متحرك أو حركة لا تنتهي القيمة دون أن يزعج المستخدم.

builtin:apps.web.visuallyComplete.load.browser:splitBy("dt.entity.application"):median

builtin:apps.web.largestContentfulPaint.load.browser

زمن عرض أكبر عنصر في المنطقة المرئية، وهو أحد Core Web Vitals. تصف Google قيمة LCP بأنها «جيدة» إن كانت أقل من أو تساوي 2.5 ثانية عند المئين 75؛ وهذا المرجع مصدره web.dev لا Dynatrace. حالة الاستخدام: تتبّع LCP لصفحات الهبوط الحساسة لمحركات البحث. الفخ: يُحسب فقط لإجراءات التحميل وللمتصفحات التي تتيح الواجهة.

builtin:apps.web.largestContentfulPaint.load.browser:splitBy("dt.entity.application"):percentile(75)

builtin:apps.web.cumulativeLayoutShift.load.browser

درجة بلا وحدة لإزاحات العناصر المرئية غير المتوقعة أثناء التحميل. حالة الاستخدام: اكتشاف لافتة أو إعلان أُدخل دون حجز مكانه فيجعل المستخدم ينقر في المكان الخطأ. الفخ: إنه درجة لا مدة؛ فلا تضعه على المحور نفسه مع المقاييس بالمللي ثانية.

builtin:apps.web.cumulativeLayoutShift.load.browser:splitBy("dt.entity.application"):percentile(75)

builtin:apps.web.interactionToNextPaint

Interaction to Next Paint: الفاصل بين تفاعل (نقرة أو إدخال) والعرض التالي. وهو مؤشر Core Web Vital للاستجابة الذي حل محل First Input Delay. حالة الاستخدام: اكتشاف JavaScript ثقيل يجمّد الواجهة. الفخ: لا تدرج الوثائق التجميع avg لهذا المفتاح؛ استخدم الوسيط أو المئين.

builtin:apps.web.interactionToNextPaint:splitBy("dt.entity.application"):percentile(75)

builtin:apps.web.activeSessions

العدد المقدَّر للجلسات النشطة، أي التي يُؤكَّد فيها أن المستخدم ما زال موجودًا. وتوضح الوثائق أن التقدير يقوم على خوارزمية HyperLogLog. حالة الاستخدام: معرفة كم مستخدمًا تمسّه حادثة في هذه اللحظة، وهو رقم متوقع في كل تواصل عن الحادثة. الفخ: قيمة تقريبية؛ فلا تطابقها حرفيًا مع أداة تسويق.

builtin:apps.web.activeSessions:splitBy("dt.entity.application"):max

builtin:apps.web.bouncedSessionRatio

نسبة الجلسات المقتصرة على صفحة واحدة وطلب ويب واحد. حالة الاستخدام: قد يكشف ارتفاع مفاجئ بعد النشر في الإنتاج صفحة رئيسية معطلة لا تراها المقاييس التقنية. الفخ: يتوقف الارتداد كثيرًا على نوع الصفحة؛ فلصفحة معلومات معدل مرتفع بطبيعتها.

builtin:apps.web.bouncedSessionRatio:splitBy("dt.entity.application"):avg

builtin:apps.web.countOfErrors

عدد الأخطاء المكتشفة، وقابل للتقسيم بحسب نوع المستخدم ونوع الخطأ والمصدر. حالة الاستخدام: فصل أخطاء JavaScript عن أخطاء الطلبات لمعرفة أي فريق يُستدعى. الفخ: قد يهيمن سكربت طرف ثالث كثير الضجيج (إعلان أو دردشة) على العدّاد؛ فصفِّ المصدر قبل التنبيه.

builtin:apps.web.countOfErrors:splitBy("dt.entity.application"):sum:sort(value(sum,descending)):limit(10)

builtin:apps.web.jsErrorsDuringUa

أخطاء JavaScript التي وقعت أثناء إجراء مستخدم. ويعد توأمه builtin:apps.web.jsErrorsWithoutUa الأخطاء التي وقعت بين إجراءين. حالة الاستخدام: الأخطاء أثناء الإجراء تمس نقرة مباشرة، فهي أكثر إلحاحًا. الفخ: العدّاد الخام ينمو مع الحركة؛ فانسبه إلى عدد الإجراءات.

builtin:apps.web.jsErrorsDuringUa:splitBy("dt.entity.application"):sum

builtin:apps.web.percentageOfUserActionsAffectedByErrors

نسبة إجراءات المستخدم التي فيها خطأ مكتشف واحد على الأقل. وهي مطبَّعة أصلًا على الحركة، فتصلح مؤشر SLI لخطأ جهة العميل. حالة الاستخدام: هدف SLO «أقل من X% من الإجراءات بها خطأ»، تحدد X انطلاقًا من تاريخك. الفخ: خطأ بلا أثر ظاهر يُحتسب كصفحة بيضاء.

builtin:apps.web.percentageOfUserActionsAffectedByErrors:splitBy("dt.entity.application"):avg

تطبيقات الجوال والتطبيقات المخصصة

builtin:apps.other.apdex.osAndVersion

Apdex لإجراءات المستخدم في تطبيق جوال أو مخصص، بحسب نظام التشغيل وإصدار التطبيق. حالة الاستخدام: التحقق من أن إصدارًا جديدًا نُشر في المتاجر لا يتدهور معه الأداء قبل توسيع النشر التدريجي. الفخ: تحتفظ الإصدارات القديمة بعدد قليل من المستخدمين؛ فيتذبذب Apdex فيها كثيرًا على عينة صغيرة.

builtin:apps.other.apdex.osAndVersion:splitBy():avg

builtin:apps.other.uaDuration.osAndVersion

مدة إجراءات المستخدم على الجوال، بحسب النظام والإصدار. حالة الاستخدام: مقارنة المئين 90 بين إصدارين من التطبيق. الفخ: الوحدة هي الميكروثانية لا المللي ثانية كما في الويب؛ تحقق من المحور قبل أن تستنتج وجود تراجع.

builtin:apps.other.uaDuration.osAndVersion:splitBy():percentile(90)

builtin:apps.other.crashCount.osAndVersion

عدد الانهيارات المكتشفة، بحسب النظام والإصدار. حالة الاستخدام: إصدار تتركز فيه الانهيارات بعد نشره مباشرة يبرر تجميد النشر. الفخ: العدّاد المطلق يتبع عدد المستخدمين؛ ففضّل معدل المستخدمين بلا انهيار للمقارنة.

builtin:apps.other.crashCount.osAndVersion:splitBy():sum

builtin:apps.other.crashFreeUsersRate.os

النسبة المقدَّرة للمستخدمين الفريدين غير المتأثرين بانهيار، بحسب نظام التشغيل (تقدير HyperLogLog بحسب الوثائق). وهو مؤشر SLI لاستقرار الجوال الأوضح لفريق المنتج. حالة الاستخدام: تتبّع هدف استقرار لكل منصة iOS وAndroid. الفخ: قيمة مقدَّرة، قليلة الموثوقية في تطبيق ذي جمهور ضعيف جدًا.

builtin:apps.other.crashFreeUsersRate.os:splitBy():avg

المراقبات الاصطناعية للمتصفح وHTTP

builtin:synthetic.browser.availability.location.total

معدل توافر مراقبات المتصفح، بحسب الموقع. حالة الاستخدام: مؤشر SLI لتوافر مسار حرج (تسجيل الدخول أو الدفع)، يُقاس حتى دون حركة حقيقية. وتستثني المتغيرة …totalWoMaintenanceWindow نوافذ الصيانة، وهذا مفيد لتقرير SLA. الفخ: يكفي موقع واحد فاشل لخفض المتوسط؛ فانظر إلى التقسيم بحسب الموقع قبل التصعيد.

builtin:synthetic.browser.availability.location.total:splitBy("dt.entity.synthetic_test"):avg

builtin:synthetic.browser.failure

عدد عمليات التنفيذ الفاشلة لمراقب متصفح. وبنسبته إلى builtin:synthetic.browser.total تحصل على معدل فشل. حالة الاستخدام: التنبيه على عدة إخفاقات متتالية بدل إخفاق واحد، وهو كثيرًا ما يعود إلى خلل عابر في شبكة الموقع. الفخ: السكربت الذي تعطله تغييرات الواجهة يفشل أيضًا؛ فتحقق من التفاصيل قبل اتهام الإنتاج.

builtin:synthetic.browser.failure:splitBy("dt.entity.synthetic_test"):sum

builtin:synthetic.browser.totalDuration

مدة كل إجراءات تنفيذ واحد، لكل مراقب. حالة الاستخدام: خط أساس ثابت دون تباين شبكات العملاء، لاكتشاف تراجع الأداء عند النشر. الفخ: إضافة خطوة إلى السكربت تطيل المدة؛ فدوّن هذه التغييرات على رسومك.

builtin:synthetic.browser.totalDuration:splitBy("dt.entity.synthetic_test"):avg

builtin:synthetic.http.availability.location.total

معدل توافر مراقبات HTTP، بحسب الموقع. وهي أخف من مراقبات المتصفح، فتراقب واجهات API ونقاط الصحة بتواتر عال. حالة الاستخدام: مؤشر SLI لتوافر API عامة. الفخ: يتحقق مراقب HTTP من استجابة لا من عرض صفحة؛ فلا يغني عن مراقب متصفح لمسار.

builtin:synthetic.http.availability.location.total:splitBy("dt.entity.http_check"):avg

builtin:synthetic.http.duration.geo

المدة التراكمية لكل طلبات مراقب HTTP، بحسب الموقع. وتفكك المفاتيح المجاورة …dns.geo و…tcpConnectTime.geo و…tlsHandshakeTime.geo و…timeToFirstByte.geo هذا الزمن. حالة الاستخدام: ارتفاع محصور في موقع واحد يوجّه نحو الشبكة لا التطبيق. الفخ: لا وسيط ولا مئين موثقين لهذا المفتاح.

builtin:synthetic.http.duration.geo:splitBy("dt.entity.http_check"):max

builtin:synthetic.http.statusCode

عدد عمليات التنفيذ بحسب رمز حالة HTTP، لكل موقع. حالة الاستخدام: التمييز بين 503 (الخدمة غير متاحة) و401 (انتهاء صلاحية الرمز المميّز في المراقب)، وهما حادثتان مختلفتان جدًا. الفخ: الرمز 200 لا يضمن محتوى صحيحًا؛ فأضف قاعدة تحقق في المراقب.

builtin:synthetic.http.statusCode:splitBy("dt.entity.http_check"):sum

كيف تتحقق من أن الأمر يعمل

  1. افتح Data Explorer وانتقل إلى وضع Code والصق selector من بطاقة: يجب أن يظهر رسم بياني خلال ثوانٍ.
  2. إن كانت الاستجابة فارغة فاقرأ الوصف: GET /api/v2/metrics/builtin:apps.web.apdex.userType برمز مميّز بنطاق metrics.read. فهو يسرد الوحدة والتجميعات والأبعاد.
  3. بالنسبة إلى RUM للويب، تحقق من أن التطبيق مكتشَف فعلًا وأن JavaScript الخاص بـRUM محقون في الصفحات (تبويب الشبكة في المتصفح).
  4. وبالنسبة إلى المراقبة الاصطناعية، تحقق من أن المراقب نشط وأن له موقعًا مسندًا (عامًا أو خاصًا، ActiveGate للمراقبة الاصطناعية).
curl -s -H "Authorization: Api-Token $DT_TOKEN" \
  "https://managed.example.com/e/ENV-ID/api/v2/metrics/query?metricSelector=builtin:synthetic.http.availability.location.total:avg&from=now-24h"

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

  • اجمع بين RUM والمراقبة الاصطناعية: يقول RUM ما يعيشه المستخدمون، وتقول المراقبة الاصطناعية هل تستجيب الخدمة حين لا يستخدمها أحد.
  • المئينات بدل المتوسطات للمدد: فالمتوسط يخفي المستخدمين الأبطأ.
  • استبعد الروبوتات والمراقبة الاصطناعية من أهداف SLO لتجربة المستخدمين الحقيقيين بفضل نوع المستخدم.

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

لماذا تبدأ مفاتيح الجوال بـapps.other؟

في Dynatrace Managed تشترك تطبيقات الجوال والتطبيقات المخصصة في العائلة builtin:apps.other.*، الموسومة [mobile, custom] في الوثائق. ولا تحمل بادئة خاصة إلا مفاتيح قليلة مثل builtin:apps.mobile.sessionCount.

هل مؤشرات Core Web Vitals في Dynatrace هي نفسها عند Google؟

إنها تقيس الظواهر نفسها (LCP وCLS وINP) عند مستخدميك الحقيقيين، لكن على جمهورك ومتصفحاتك. فقد تختلف الأرقام عن تقارير Google التي تعتمد على عينة أخرى.

هل تعمل هذه المفاتيح في Dynatrace SaaS؟

في الواجهة الكلاسيكية لـSaaS نعم. أما في Grail فيعرض RUM والمراقبة الاصطناعية مفاتيح أخرى تُستعلم بـDQL؛ ويفصّلها مسار مقاييس SaaS.

بهذه البطاقات الـ23 صارت لديك مؤشرات SLI من جهة المستخدم: التجربة والاستجابة والأخطاء واستقرار الجوال والتوافر الاصطناعي. وتنزل الوحدة التالية مجددًا إلى العمليات وبيئات التشغيل والحاويات.

→ الوحدة 3: الخدمات · فهرس المسار · الوحدة 5: العمليات والحاويات ←

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. هذه الوحدة مختارات معلَّق عليها: يبقى المرجع هو الوثائق الرسمية لإصدارك من Dynatrace Managed، حيث ينبغي التحقق من كل مفتاح ووحدة وتجميع.

Total
0
Shares
Leave a Reply

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

Previous Post
Module 3 — Services : 20 métriques service builtin de Dynatrace Managed

الوحدة 3 — مقاييس الخدمات في Dynatrace Managed: 20 مقياس خدمة builtin

Next Post
Module 5 — Processus et conteneurs : les métriques processus builtin, runtimes et Kubernetes

الوحدة 5 — مقاييس العمليات builtin في Dynatrace Managed: بيئات التشغيل وKubernetes

Related Posts