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 שהתרחש, לדוגמה, 'Input dispatching timed out'.
  • CRASH: בשגיאות של חריגות שלא טופלו ב-Java, הסוג של החריגה הפנימית ביותר שהופעלה, למשל, IllegalArgumentException. עבור אותות בקוד Native, האות שהופעל, למשל SIGSEGV.
location

string

המיקום שבו הבעיה התרחשה.

בהתאם לסוג, הערך יכול להיות:

  • APPLICATION_NOT_RESPONDING: שם הפעילות או השירות שהפסיקו להגיב.
  • קריסה: שם ה-method שגרם לשגיאה.
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

קישור לבעיה בתפקוד האפליקציה ב-Play Console.
firstOsVersion

object (OsVersion)

גרסת מערכת ההפעלה הכי קטנה שבה התרחשה קבוצת השגיאות הזו בתקופת הזמן המבוקשת (רק מקרים שתואמים למסננים ושנכללים בתקופת הזמן המבוקשת).
lastOsVersion

object (OsVersion)

גרסת מערכת ההפעלה האחרונה שבה התרחשה קבוצת השגיאות הזו בתקופת הזמן המבוקשת (רק מקרים שתואמים למסננים ובתקופת הזמן המבוקשת).
firstAppVersion

object (AppVersion)

גרסת האפליקציה המוקדמת ביותר (כולל) שבה מופיעה השגיאה או הבעיה בטווח הזמן המבוקש (רק מקרים שתואמים למסננים).
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

מכיל את התוכן של הודעת ההערה.

Methods
חיפוש של כל בעיות השגיאות שהדוחות קובצו לפי סוג.