REST Resource: vitals.crashrate

المورد: CrashRateMetricSet

مورد فردي يمثّل مجموعة مقاييس نسبة الأعطال.

تحتوي مجموعة المقاييس هذه على بيانات الأعطال مدمَجة مع بيانات الاستخدام لإنتاج مقياس موحّد مستقل عن أعداد المستخدمين.

فترات التجميع المتاحة:

  • DAILY: يتم تجميع المقاييس في فواصل زمنية لتاريخ التقويم. بسبب القيود السابقة، لا تتوفّر سوى المنطقة الزمنية America/Los_Angeles.
  • HOURLY: يتم تجميع المقاييس على فواصل زمنية مدتها ساعة واحدة. UTC هي المنطقة الزمنية التلقائية والوحيدة المتاحة.

المقاييس المتوافقة:

  • crashRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا عطلاً واحدًا على الأقل.
  • ‫crashRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة crashRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
  • ‫crashRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ crashRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
  • userPerceivedCrashRate (google.type.Decimal): هي النسبة المئوية للمستخدمين المختلفين خلال فترة التجميع الذين واجهوا عُطلاً واحدًا على الأقل أثناء استخدامهم تطبيقك بشكل نشط (عُطل لاحظه المستخدم). يُعتبَر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة.
  • ‫userPerceivedCrashRate7dUserWeighted (google.type.Decimal): متوسط التحرّك لقيمة userPerceivedCrashRate في آخر 7 أيام يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
  • ‫userPerceivedCrashRate28dUserWeighted (google.type.Decimal): قيمة المتوسط المتحرّك لـ userPerceivedCrashRate في آخر 28 يومًا يتم ترجيح القيم اليومية حسب عدد المستخدمين المختلفين في اليوم. غير متاح بدقة الساعة.
  • ‫distinctUsers (google.type.Decimal): عدد المستخدمين المختلفين في فترة التجميع الذين تم استخدامهم كقيمة تسوية للمقياسَين crashRate وuserPerceivedCrashRate. يتم احتساب المستخدم في هذا المقياس إذا كان يستخدم التطبيق بشكلٍ نشط خلال فترة التجميع. يُعتبَر التطبيق قيد الاستخدام النشط إذا كان يعرض أي نشاط أو ينفّذ أي خدمة تعمل في المقدّمة. يجب الحرص على عدم تجميع هذا العدد أكثر من ذلك، لأنّ ذلك قد يؤدي إلى احتساب المستخدمين عدة مرات. يتم تقريب القيمة إلى أقرب مضاعف للعدد 10 أو 100 أو 1,000 أو 1,000,000، وذلك استنادًا إلى حجم القيمة.

السمات المتوافقة:

  • ‫apiLevel (string): مستوى واجهة برمجة التطبيقات لنظام التشغيل Android الذي كان يعمل على جهاز المستخدم، على سبيل المثال: 26.
  • ‫versionCode (int64): إصدار التطبيق الذي كان يعمل على جهاز المستخدم.
  • ‫deviceModel (string): معرّف فريد لطراز جهاز المستخدم. يكون شكل المعرّف هو deviceBrand/device، حيث يتوافق deviceBrand مع Build.BRAND ويتوافق device مع Build.DEVICE، على سبيل المثال google/coral.
  • ‫deviceBrand (string): معرّف فريد للعلامة التجارية لجهاز المستخدِم، مثل google.
  • ‫deviceType (string): نوع جهاز المستخدِم (المعروف أيضًا باسم شكل الجهاز)، مثل هاتف
  • ‫countryCode (string): البلد أو المنطقة التي يقع فيها جهاز المستخدِم استنادًا إلى عنوان IP الخاص به، ويتم تمثيلهما كرمز مكوّن من حرفَين وفقًا لمعيار ISO-3166 (مثل US للولايات المتحدة).
  • ‫deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في حِزم (3 غيغابايت و4 غيغابايت وما إلى ذلك).
  • ‫deviceSocMake (string): ماركة نظام الجهاز الأساسي على الشريحة، مثل Samsung المرجع
  • ‫deviceSocModel (string): طراز نظام الجهاز الأساسي على الشريحة، مثل ‫"Exynos 2100". المرجع
  • ‫deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) بالجهاز، مثل ‫Qualcomm
  • ‫deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، مثل ‫"Kryo 240".
  • ‫deviceGpuMake (string): يشير إلى الشركة المصنّعة لوحدة معالجة الرسومات في الجهاز، مثل ARM.
  • ‫deviceGpuModel (string): طراز وحدة معالجة الرسومات في الجهاز، مثل مالي
  • ‫deviceGpuVersion (string): إصدار وحدة معالجة الرسومات في الجهاز، مثل T750.
  • ‫deviceVulkanVersion (string): إصدار Vulkan للجهاز، مثل ‫"4198400".
  • deviceGlEsVersion (string): إصدار OpenGL ES على الجهاز، مثل ‫"196610".
  • deviceScreenSize (string): حجم شاشة الجهاز، مثل NORMAL, LARGE.
  • ‫deviceScreenDpi (string): كثافة الشاشة على الجهاز، مثل mdpi وhdpi

الأذونات المطلوبة: للوصول إلى هذا المرجع، يحتاج المستخدم الذي يجري الاتصال إلى إذن عرض معلومات التطبيق (للقراءة فقط) للتطبيق.

مجموعات المقاييس ذات الصلة:

  • تحتوي السمة vitals.errors على إصدار غير معدَّل (عدد مطلق) من الأعطال.
  • يحتوي vitals.errors على مقاييس موحّدة بشأن أخطاء ANR، وهو مقياس آخر للثبات.
تمثيل JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
الحقول
name

string

المعرّف اسم المورد

التنسيق: apps/{app}/crashRateMetricSet
freshnessInfo

object (FreshnessInfo)

ملخّص حول مدى حداثة البيانات في هذا المرجع

الطُرق

get

 توضّح هذه السمة خصائص مجموعة المقاييس.

query

 يطلب هذا الإجراء المقاييس في مجموعة المقاييس.