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 في النهاية ويستخدم الأرقام الجزئية 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

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

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