الوحدة 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 |

كيف تقرأ بطاقة
تتبع كل بطاقة الترتيب نفسه: ما يقيسه المقياس، وحالة استخدام ملموسة، وفخ، ثم 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
كيف تتحقق من أن الأمر يعمل
- افتح Data Explorer وانتقل إلى وضع Code والصق selector من بطاقة: يجب أن يظهر رسم بياني خلال ثوانٍ.
- إن كانت الاستجابة فارغة فاقرأ الوصف:
GET /api/v2/metrics/builtin:apps.web.apdex.userTypeبرمز مميّز بنطاقmetrics.read. فهو يسرد الوحدة والتجميعات والأبعاد. - بالنسبة إلى RUM للويب، تحقق من أن التطبيق مكتشَف فعلًا وأن JavaScript الخاص بـRUM محقون في الصفحات (تبويب الشبكة في المتصفح).
- وبالنسبة إلى المراقبة الاصطناعية، تحقق من أن المراقب نشط وأن له موقعًا مسندًا (عامًا أو خاصًا، 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، حيث ينبغي التحقق من كل مفتاح ووحدة وتجميع.