REST Resource: vitals.errors.issues

المورد: ErrorIssue

مجموعة من تقارير الأخطاء ذات الصلة التي تم تلقّيها لأحد التطبيقات.

يتم تجميع تقارير الأخطاء المشابهة معًا في مشاكل من المحتمل أن يكون لها السبب الأساسي نفسه.

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

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

تمثيل JSON 
{
  "name": string,
  "type": enum (ErrorType),
  "cause": string,
  "location": string,
  "errorReportCount": string,
  "distinctUsers": string,
  "distinctUsersPercent": {
    object (Decimal)
  },
  "lastErrorReportTime": string,
  "issueUri": string,
  "firstOsVersion": {
    object (OsVersion)
  },
  "lastOsVersion": {
    object (OsVersion)
  },
  "firstAppVersion": {
    object (AppVersion)
  },
  "lastAppVersion": {
    object (AppVersion)
  },
  "annotations": [
    {
      object (IssueAnnotation)
    }
  ],
  "sampleErrorReports": [
    string
  ]
}
الحقول
name

string

المعرّف اسم المرجع الخاص بالمشكلة

التنسيق: apps/{app}/{issue}
type

enum (ErrorType)

نوع الأخطاء المجمّعة في هذه المشكلة
cause

string

سبب المشكلة

استنادًا إلى النوع، يمكن أن يكون هذا الإعداد أحد الخيارَين التاليَين:

  • APPLICATION_NOT_RESPONDING: نوع خطأ ANR الذي حدث، مثل "انتهت مهلة إرسال الإدخال".
  • CRASH: بالنسبة إلى أخطاء استثناء Java غير المعالَجة، يكون نوع الاستثناء الأعمق الذي تم طرحه، على سبيل المثال: IllegalArgumentException. بالنسبة إلى الإشارات في الرمز البرمجي الأصلي، تكون الإشارة التي تم إطلاقها، مثل SIGSEGV.
location

string

الموقع الجغرافي الذي حدثت فيه المشكلة

استنادًا إلى النوع، يمكن أن يكون هذا الإعداد أحد الخيارَين التاليَين:

  • APPLICATION_NOT_RESPONDING: اسم النشاط أو الخدمة التي توقّفت عن الاستجابة
  • CRASH: اسم الطريقة المحتمل الذي تسبّب في حدوث الخطأ
errorReportCount

string (int64 format)

إجمالي عدد تقارير الأخطاء في هذه المشكلة (يتم أخذ مرات التكرار المطابقة للفلاتر وضمن الفترة الزمنية المطلوبة فقط في الاعتبار).
distinctUsers

string (int64 format)

تقدير لعدد المستخدمين الفريدين الذين واجهوا هذه المشكلة (مع الأخذ في الاعتبار فقط الحالات التي تتطابق مع الفلاتر وضمن الفترة الزمنية المطلوبة)
distinctUsersPercent

object (Decimal)

النسبة المئوية المقدَّرة للمستخدمين المتأثّرين بأي مشكلة والمتأثّرين بهذه المشكلة (مع الأخذ في الاعتبار فقط مرات الظهور التي تتطابق مع الفلاتر وضِمن الفترة الزمنية المطلوبة).
lastErrorReportTime

string (Timestamp format)

بداية الساعة التي حدث خلالها آخر تقرير خطأ في هذه المشكلة

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
issueUri

string

رابط إلى المشكلة في "مؤشرات Android الحيوية" ضِمن Play Console
firstOsVersion

object (OsVersion)

أصغر إصدار من نظام التشغيل حدثت فيه مجموعة الأخطاء هذه خلال الفترة الزمنية المطلوبة (مع الأخذ في الاعتبار فقط الحالات التي تتطابق مع الفلاتر وضمن الفترة الزمنية المطلوبة).
lastOsVersion

object (OsVersion)

أحدث إصدار من نظام التشغيل حدثت فيه مجموعة الأخطاء هذه خلال الفترة الزمنية المطلوبة (لا يتم أخذ سوى الحالات التي تتطابق مع الفلاتر وضمن الفترة الزمنية المطلوبة).
firstAppVersion

object (AppVersion)

أقدم إصدار (شامل) من التطبيق يظهر في ErrorIssue خلال الفترة الزمنية المطلوبة (مع الأخذ في الاعتبار فقط مرات الظهور المطابقة للفلاتر).
lastAppVersion

object (AppVersion)

أحدث إصدار (شامل) من التطبيق يظهر في ErrorIssue خلال الفترة الزمنية المطلوبة (مع الأخذ في الاعتبار فقط مرات الظهور التي تتطابق مع الفلاتر).
annotations[]

object (IssueAnnotation)

قائمة بالتعليقات التوضيحية لمشكلة معيّنة تقدّم التعليقات التوضيحية معلومات إضافية قد تساعد في تشخيص المشكلة وحلّها.
sampleErrorReports[]

string

النتائج فقط. تقارير الأخطاء النموذجية التي تنتمي إلى ErrorIssue هذا ملاحظة: الحد الأقصى المسموح به حاليًا هو 1 لكل ErrorIssue. التنسيق: "apps/{app}/{report}"

IssueAnnotation

تمثّل هذه السمة رسالة تعليق توضيحي لمشكلة.

تمثيل JSON 
{
  "category": string,
  "title": string,
  "body": string
}
الحقول
category

string

تمثّل هذه السمة الفئة التي ينتمي إليها التعليق التوضيحي. سينتمي التعليق التوضيحي إلى فئة واحدة. فئات الأمثلة: "حلّ محتمل" و"إحصاءات".
title

string

تمثّل هذه السمة عنوان التعليق التوضيحي.
body

string

تحتوي هذه السمة على محتوى رسالة التعليق التوضيحي.

الطُرق
يبحث عن جميع مشاكل الأخطاء التي تم تجميع التقارير فيها.