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 رخ داده، مثلاً «زمان ارسال ورودی به پایان رسید».
  • خرابی: برای خطاهای استثنای مدیریت نشده جاوا، نوع داخلی‌ترین استثنای ایجاد شده، مثلاً 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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

issueUri

string

پیوند به مشکل در «نکات حیاتی اندروید» در کنسول Play.

firstOsVersion

object ( OsVersion )

کوچکترین نسخه سیستم عامل که این خوشه خطا در دوره زمانی درخواستی در آن رخ داده است (فقط با در نظر گرفتن رویدادهایی که با فیلترها مطابقت دارند و در دوره زمانی درخواستی).

lastOsVersion

object ( OsVersion )

آخرین نسخه سیستم عامل که این خوشه خطا در دوره زمانی درخواستی در آن رخ داده است (فقط با در نظر گرفتن رویدادهایی که با فیلترها مطابقت دارند و در دوره زمانی درخواستی).

firstAppVersion

object ( AppVersion )

اولین نسخه (شامل) برنامه که در این خطای ErrorIssue در بازه زمانی درخواستی ظاهر می‌شود (فقط با در نظر گرفتن موارد منطبق با فیلترها).

lastAppVersion

object ( AppVersion )

آخرین نسخه (شامل) برنامه که در این خطای ErrorIssue در بازه زمانی درخواستی ظاهر می‌شود (فقط با در نظر گرفتن موارد منطبق با فیلترها).

annotations[]

object ( IssueAnnotation )

فهرستی از توضیحات برای یک مشکل. توضیحات، اطلاعات اضافی ارائه می‌دهند که ممکن است در تشخیص و رفع مشکل مفید باشد.

sampleErrorReports[]

string

فقط خروجی. گزارش‌های خطای نمونه که متعلق به این ErrorIssue هستند. توجه: در حال حاضر حداکثر ۱ مورد برای هر ErrorIssue پشتیبانی می‌شود. فرمت: "apps/{app}/{report}"

حاشیه‌نویسی مسئله

نمایش یک پیام حاشیه‌نویسی برای یک مسئله.

نمایش JSON 
{
  "category": string,
  "title": string,
  "body": string
}
فیلدها
category

string

دسته‌بندی که حاشیه‌نویسی به آن تعلق دارد. یک حاشیه‌نویسی به یک دسته‌بندی واحد تعلق خواهد داشت. دسته‌بندی‌های مثال: «راهکارهای بالقوه»، «بینش».

title

string

عنوان برای حاشیه نویسی.

body

string

شامل محتویات پیام حاشیه‌نویسی است.

روش‌ها

تمام مشکلات خطایی که گزارش‌ها در آن‌ها گروه‌بندی شده‌اند را جستجو می‌کند.