REST Resource: vitals.crashrate

المورد: CrashRateMetricSet

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

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

فترات التجميع المسموح بها:

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

المقاييس المسموح بها:

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

السمات المسموح بها:

  • apiLevel (string): مستوى واجهة برمجة التطبيقات (API) لنظام التشغيل Android الذي كان قيد التشغيل على جهاز المستخدم، مثلاً 26
  • versionCode (int64): إصدار التطبيق الذي كان قيد التشغيل على جهاز المستخدم
  • deviceModel (string): المعرّف الفريد لطراز جهاز المستخدم يكون شكل المعرّف "deviceBrand/device"، حيث يتطابق deviceBrand مع Build.BRAND ويتطابق device مع Build.DEVICE، مثلاً google/coral.
  • deviceBrand (string): المعرّف الفريد للعلامة التجارية لجهاز المستخدم، مثلاً google
  • deviceType (string): نوع جهاز المستخدم (يُعرف أيضًا باسم عامل الشكل)، مثلاً PHONE
  • countryCode (string): بلد جهاز المستخدم أو منطقته استنادًا إلى عنوان IP الخاص به، ويتم تمثيله كرمز من حرفَين وفقًا لمعيار ISO-3166 (مثلاً US للولايات المتحدة)
  • deviceRamBucket (int64): ذاكرة الوصول العشوائي (RAM) للجهاز، بالميغابايت، في مجموعات (مثلاً 1024 لذاكرة الوصول العشوائي من 1 إلى 1.5 غيغابايت، و4096 لذاكرة الوصول العشوائي من 4 إلى 6 غيغابايت)
  • deviceSocMake (string): الشركة المصنّعة لنظام الجهاز الأساسي على شريحة واحدة، مثلاً Samsung مرجع
  • deviceSocModel (string): طراز نظام الجهاز الأساسي على شريحة واحدة، مثلاً "Exynos 2100" مرجع
  • deviceCpuMake (string): الشركة المصنّعة لوحدة المعالجة المركزية (CPU) للجهاز، مثلاً Qualcomm
  • deviceCpuModel (string): طراز وحدة المعالجة المركزية للجهاز، مثلاً "Kryo 240"
  • deviceGpuMake (string): الشركة المصنّعة لوحدة معالجة الرسومات (GPU) للجهاز، مثلاً ARM
  • deviceGpuModel (string): طراز وحدة معالجة الرسومات للجهاز، مثلاً Mali
  • 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

 يستعلم عن المقاييس في مجموعة المقاييس.