REST Resource: vitals.crashrate

المورد: CrashRateMetricSet

مورد Singleton الذي يمثل مجموعة مقاييس الأعطال.

تحتوي مجموعة المقاييس هذه على بيانات الأعطال جنبًا إلى جنب مع بيانات الاستخدام لإنشاء مقياس محسوب بشكل مستقل عن أعداد المستخدمين.

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

  • 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"، حيث يتطابق الجهاز مع BrandBrand مع الجهاز، أمّا الجهاز يتوافق مع Build.DEVICE، مثل google/coral.
  • deviceBrand (string): معرّف فريد للعلامة التجارية لجهاز المستخدم، مثل Google.
  • deviceType (string): النوع (يُعرف أيضًا باسم شكل الجهاز) لجهاز المستخدم، مثل هاتف
  • countryCode (string): يشير هذا المصطلح إلى البلد أو المنطقة في جهاز المستخدم استنادًا إلى عنوان IP الخاص به، ويتم تمثيله برمز ISO-3166 المكوّن من حرفَين (مثل US للولايات المتحدة).
  • deviceRamBucket (int64): ذاكرة الوصول العشوائي للجهاز، بالميغابايت، في الحِزم (3 غيغابايت، 4 غيغابايت، إلخ).
  • deviceSocMake (string): استخدام شريحة النظام الأساسية على الجهاز، مثل Samsung المرجع
  • deviceSocModel (string): طراز شريحة النظام الأساسية على الجهاز، مثل "Exynos 2100". المرجع
  • deviceCpuMake (string): يُرجى استخدام وحدة المعالجة المركزية (CPU) للجهاز، على سبيل المثال: كوالكوم
  • deviceCpuModel (string): طراز وحدة المعالجة المركزية (CPU) للجهاز، على سبيل المثال، "Kryo 240"
  • deviceGpuMake (string): تحديد وحدة معالجة الرسومات الخاصة بالجهاز، على سبيل المثال ذِرَاع
  • deviceGpuModel (string): طراز وحدة معالجة الرسومات الخاصة بالجهاز، على سبيل المثال مالي
  • deviceGpuVersion (string): إصدار وحدة معالجة الرسومات للجهاز، على سبيل المثال، T750.
  • deviceVulkanVersion (string): إصدار Vulkan من الجهاز، مثل "4198400".
  • deviceGlEsVersion (string): إصدار OpenGL ES من الجهاز، على سبيل المثال، "196610".
  • deviceScreenSize (string): حجم شاشة الجهاز، مثل عادي، كبير.
  • deviceScreenDpi (string): كثافة شاشة الجهاز، مثل mdpi، وhdpi

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

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

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

string

اسم المورد

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

object (FreshnessInfo)

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

الطُرق

get

 يصف خصائص مجموعة المقاييس.

query

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