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. עבור אותות בקוד Native, האות שהופעל, למשל SIGSEGV.
location

string

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

בהתאם לסוג, זה יכול להיות:

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

קישור לבעיה בדף 'תפקוד האפליקציה ל-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

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

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