طرحواره گزارش برای داده‌های صادرشده در Cloud Logging

این صفحه طرح گزارش را برای داده‌های صادرشده Crashlytics و داده‌های جلسات Firebase در Cloud Logging ارائه می‌دهد.


طرح‌واره Crashlytics

Event

پیامی که یک رویداد Crashlytics را شرح می‌دهد.

نمایش JSON

{
  "name": string,
  "platform": string,
  "bundleOrPackage": string,
  "eventId": string,
  "sessionId": string,
  "eventTime": string,
  "receivedTime": string,
  "issue": {
    object (Issue)
  },
  "issueVariant": {
    object (IssueVariant)
  },
  "device": {
    object (Device)
  },
  "memory": {
    object (Memory)
  },
  "storage": {
    object (Storage)
  },
  "operatingSystem": {
    object (OperatingSystem)
  },
  "browser": {
    object (Browser)
  },
  "version": {
    object (Version)
  },
  "user": {
    object (User)
  },
  "customKeys": {
    string: string,
    ...
  },
  "installationUuid": string,
  "crashlyticsSdkVersion": string,
  "appOrientation": string,
  "deviceOrientation": string,
  "logs": [
    {
      object (Log)
    }
  ],
  "breadcrumbs": [
    {
      object (Breadcrumb)
    }
  ],
  "blameFrame": {
    object (Frame)
  },
  "exceptions": [
    {
      object (Exception)
    }
  ],
  "errors": [
    {
      object (Error)
    }
  ],
  "threads": [
    {
      object (Thread)
    }
  ],
  "processState": string,
  "issueTitle": string,
  "issueSubtitle": string,
  "buildStamp": string,
  "routePath": string
}
فیلدها شرح
name string

الزامی است. فقط خروجی. تغییرناپذیر. شناسه. نام منبع رویداد. قالب: projects/{project}/apps/{app_id}/events/{event}.
platform string

ANDROID،‏ IOS، یا WEB.
bundleOrPackage string

نام بسته نرم‌افزاری برای برنامه‌های iOS یا نام بسته برای برنامه‌های Android. قالب: com.mycompany.myapp.
eventId string

فقط خروجی. تغییرناپذیر. شناسه یکتای رویداد درطول پردازش اختصاص داده می‌شود.
sessionId string

شناسه یکتای جلسه Firebase.
eventTime 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».
receivedTime string (Timestamp format)

مُهر زمان سرور که در آن رویداد توسط Crashlytics دریافت شده است.

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه Z-normalized است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «Z» نیز پذیرفته می‌شود. مثال: «‎2014-10-02T15:01:23Z»، «‎2014-10-02T15:01:23.045123456Z» یا «‎2014-10-02T15:01:23+05:30».
state_update_time 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».
first_seen_version string

اولین display_version برنامه که این مشکل در آن دیده شده است، فقط برای مشکلات تلفن همراه تکمیل می‌شود.
last_seen_version string

جدیدترین display_version برنامه که این مشکل در آن دیده شده است، فقط برای مشکلات تلفن همراه تکمیل می‌شود.
first_time_seen 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».
last_time_seen 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».
issue object (Issue)

جزئیات مربوط به [مشکل] اختصاص‌داده‌شده به این [رویداد].
issueVariant object (IssueVariant)

جزئیات [IssueVariant] اختصاص‌داده‌شده به این [Event].
device object (Device)

فراداده دستگاه همراه.
memory object (Memory)

استفاده از حافظه دستگاه همراه.
storage object (Storage)

استفاده از دیسک/فلش دستگاه همراه.
operatingSystem object (OperatingSystem)

سیستم‌عامل و نسخه.
browser object (Browser)

مرورگر و نسخه.
version object (Version)

نسخه برنامه تلفن همراه.
user object (User)

شناسه‌های کاربر نهایی برای مالک دستگاه.
customKeys map (key: string, value: string)

کلیدهای سفارشی که توسعه‌دهنده درطول جلسه تنظیم کرده است.

شیئی حاوی فهرستی از جفت‌های «کلید»: مقدار. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationUuid string

شناسه یکتا برای نصب برنامه دستگاه. این فیلد برای محاسبه تعداد یکتای کاربران تحت‌تأثیر قرارگرفته استفاده می‌شود.
crashlyticsSdkVersion string

نسخه Crashlytics SDK.
appOrientation string

جهت برنامه در زمان خرابی (عمودی یا افقی).
deviceOrientation string

جهت دستگاه در زمان خرابی (عمودی یا افقی).
logs[] object (Log)

پیام‌های ثبت‌شده توسط توسعه‌دهنده درطول جلسه.
breadcrumbs[] object (Breadcrumb)

رویدادهای Analytics که توسط کیت توسعه نرم‌افزار Analytics درطول جلسه ضبط شده است.
blameFrame object (Frame)

قاب ردیابی پشته که توسط پردازش Crashlytics مقصر شناخته شده است. ممکن است در تحلیل‌گر آینده وجود نداشته باشد.
exceptions[] object (Exception)

فقط Android و وب. استثناهایی که درطول این رویداد رخ داده است. استثناهای تودرتو به‌ترتیب زمانی معکوس ارائه می‌شوند، به‌طوری‌که آخرین رکورد اولین استثنای ایجادشده است.
errors[] object (Error)

فقط Apple. خطای غیرمهلکی که توسط کیت توسعه نرم‌افزار iOS و ردپای پشته آن ضبط شده است.
threads[] object (Thread)

رشته‌های برنامه موجود در زمان ثبت رویداد. هرکدام حاوی یک ردیابی پشته است. یک رشته مقصر این خطا شناخته خواهد شد.
processState string

وضعیت پردازش برنامه در زمان رویداد.
issueTitle string

عنوان مشکلی که رویداد در آن گروه‌بندی شده است. این معمولاً نام روش یا فایل منبع است.
issueSubtitle string

زیرعنوان مشکلی که رویداد در آن گروه‌بندی شده است. این معمولاً یک نماد یا پیام استثنا است.
buildStamp string

فراداده ارائه‌شده توسط سیستم ساخت برنامه، ازجمله اطلاعات مخزن کنترل نسخه.
routePath string

فقط وب. مسیر برنامه وب هنگام وقوع رویداد، به‌استثنای پارامترهای پُرسمان و قطعه.

Memory

استفاده از حافظه دستگاه همراه.

نمایش JSON

{
  "used": string,
  "free": string
}
فیلدها شرح
used string (int64 format)

بایت‌های درحال استفاده.
free string (int64 format)

بایت آزاد است.

Storage

استفاده از دیسک/فلش دستگاه همراه. برای همه دستگاه‌ها گزارش نشده است.

نمایش JSON

{
  "used": string,
  "free": string
}
فیلدها شرح
used string (int64 format)

بایت استفاده شده است.
free string (int64 format)

بایت آزاد است.

User

شناسه‌های کاربر نهایی که توسعه‌دهنده ارائه کرده است.

نمایش JSON

{
  "id": string
}
فیلدها شرح
id string

شناسه کاربر اگر توسط توسعه‌دهنده برنامه ارائه شده باشد.

Frame

فریمی در ردیابی پشته.

نمایش JSON

{
  "line": string,
  "file": string,
  "symbol": string,
  "offset": string,
  "address": string,
  "library": string,
  "owner": string,
  "blamed": boolean
}
فیلدها شرح
line string (int64 format)

شماره خط در فایل قاب.
file string

نام فایل منبعی که قاب در آن پیدا شده است.
symbol string

نماد قاب پس‌از ابهام‌زدایی یا نمادگذاری. نماد خام از دستگاه درصورتی‌که نتوان آن را هیدراته کرد.
offset string (int64 format)

انحراف بایت در تصویر دودویی که حاوی کد است. برای قاب‌های بومی وجود دارد.
address string (int64 format)

نشانی در تصویر باینری که حاوی کد است. ارائه برای قاب‌های بومی.
library string

نام نمایشی کتابخانه‌ای که شامل قاب است.
owner string

یکی از DEVELOPER،‏ VENDOR،‏ RUNTIME،‏ PLATFORM، یا SYSTEM.
blamed boolean

وقتی درست است که تجزیه‌وتحلیل Crashlytics تشخیص داده باشد که این قاب احتمالاً علت خطا است.

Exception

یک استثنای جاوا یا جاوا اسکریپت و ردیابی پشته آن. فقط از برنامه‌های Android و وب.

نمایش JSON

{
  "type": string,
  "exceptionMessage": string,
  "nested": boolean,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
فیلدها شرح
type string

نوع استثنا، برای مثال java.lang.IllegalStateException.
exceptionMessage string

پیام مرتبط با استثنا.
nested boolean

برای همه درست است به‌جز آخرین استثنای ایجادشده (یعنی اولین رکورد).
title string

عنوان استثنا.
subtitle string

زیرعنوان استثنا.
blamed boolean

وقتی Crashlytics تشخیص دهد که این رشته جایی است که خطا در آن رخ داده است، مقدار True (درست) است.
frames[] object (Frame)

قاب‌های موجود در ردیابی پشته استثنا.

Error

خطای غیرمهلک و ردیابی پشته‌ای آن، فقط از برنامه‌های Apple.

نمایش JSON

{
  "queue": string,
  "code": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
فیلدها شرح
queue string

صفی که رشته در آن اجرا می‌شد.
code string (int64 format)

کد خطای مرتبط با NSError ثبت‌شده سفارشی برنامه.
title string

عنوان خطا.
subtitle string

زیرعنوان خطا.
blamed boolean

اگر Crashlytics تشخیص دهد که ردیابی پشته در این خطا جایی است که اشکال رخ داده است، مقدار True خواهد بود.
frames[] object (Frame)

قاب‌های موجود در ردیابی پشته خطا.

Thread

رشته برنامه.

JSON representation</code></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>{
  "crashed": boolean,
  "name": string,
  "queue": string,
  "signal": string,
  "signalCode": string,
  "crashAddress": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ],
  "threadId": string,
  "sysThreadId": string,
  "threadState": enum (State)
}
فیلدها شرح
crashed boolean

وقتی رشته ازکار افتاده باشد، «درست» است.
name string

نام رشته.
queue string

صفی که رشته در آن اجرا می‌شد.
signal string

نام سیگنالی که باعث ازکارافتادن برنامه شده است. فقط در رشته‌های بومی ازکارافتاده وجود دارد.
signalCode string

کد سیگنالی که باعث ازکارافتادن برنامه شده است. فقط در رشته‌های بومی ازکارافتاده وجود دارد.
crashAddress string (int64 format)

نشانی سیگنالی که باعث ازکارافتادن برنامه شده است. فقط در رشته‌های بومی ازکارافتاده وجود دارد.
title string

عنوان رشته.
subtitle string

زیرعنوان رشته.
blamed boolean

اگر Crashlytics تشخیص دهد که ردیابی پشته در این رشته جایی است که خطا رخ داده است، مقدار True خواهد بود.
frames[] object (Frame)

قاب‌های موجود در ردیابی پشته رشته.
threadId string (int64 format)

شناسه رشته، فقط برای رشته‌های ANR دردسترس است.
sysThreadId string (int64 format)

شناسه سیستم رشته، فقط برای رشته‌های ANR دردسترس است.
threadState enum (State)

فقط خروجی. وضعیت رشته در زمان وقوع خطای ANR.

State

وضعیت رشته هنگام وقوع خطای ANR.

شمارشی‌ها شرح
STATE_UNSPECIFIED

وضعیت رشته نامشخص است.
THREAD_STATE_TERMINATED

رشته بسته شد.
THREAD_STATE_RUNNABLE

رشته قابل‌اجرا بود.
THREAD_STATE_TIMED_WAITING

رشته با مهلت زمانی درحال انتظار بود.
THREAD_STATE_BLOCKED

رشته مسدود شد.
THREAD_STATE_WAITING

رشته درحال انتظار بود.
THREAD_STATE_NEW

رشته شروع شده است، اما هنوز چیزی اجرا نشده است.
THREAD_STATE_NATIVE_RUNNABLE

رشته بومی بود و نتوانستیم به‌طور اکتشافی تعیین کنیم که درحال انتظار است، بنابراین فرض می‌کنیم قابل‌اجرا است.
THREAD_STATE_NATIVE_WAITING

با روش اکتشافی تشخیص دادیم که رشته درحال انتظار است.


طرح‌واره جلسه‌های Firebase

FirebaseSessionEvent

جلسه‌های ضبط‌شده توسط کیت توسعه نرم‌افزار Firebase App Quality Sessions.

نمایش JSON

{
  "sessionId": string,
  "eventType": enum (SessionEventType),
  "firstSessionId": string,
  "sessionIndex": integer,
  "firebaseInstallationId": string,
  "eventTime": string,
  "version": {
    object (Version)
  },
  "device": {
    object (Device)
  },
  "operatingSystem": {
    object (OperatingSystem)
  }
}
فیلدها شرح
sessionId string

شناسه یکتای جلسه Firebase.
eventType enum (SessionEventType)

نوع رویداد جلسه. درحال‌حاضر، کیت توسعه نرم‌افزار فقط از رویدادهای SESSION_START پشتیبانی می‌کند.
firstSessionId string

شناسه اولین جلسه از آخرین شروع سرد. این شناسه و sessionId برای راه‌اندازی‌های برنامه یکسان خواهد بود.
sessionIndex integer

تعداد جلسه‌ها را از آخرین شروع سرد نشان می‌دهد.
firebaseInstallationId string

دستگاهی را که برنامه‌های Firebase در آن نصب شده است به‌طور منحصربه‌فرد شناسایی می‌کند.
eventTime 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».
version object (Version)

شماره‌های نسخه برنامه تلفن همراه.
device object (Device)

فراداده دستگاه همراه.
operatingSystem object (OperatingSystem)

سیستم‌عامل و نسخه.

SessionEventType

انواع SessionEvent که ضبط می‌شود.

شمارشی‌ها شرح
SESSION_EVENT_TYPE_UNKNOWN

نامشخص.
SESSION_START

جلسه برنامه شروع شد.


طرح‌واره گزارش دستگاه

DeviceLog

ساختار ورودی‌های deviceLog را نشان می‌دهد.

نمایش JSON

{
  "eventId": string,
  "sessionId": string,

  // Union field payload can be only one of the following:
  "log": {
    object (Log)
  },
  "breadcrumb": {
    object (Breadcrumb)
  }
  // End of list of possible types for union field payload.
}
فیلدها شرح
eventId string

فقط خروجی. تغییرناپذیر. شناسه رویدادی که این مورد با آن مرتبط است.
sessionId string

شناسه یکتای جلسه Firebase.

فیلد اتحادیه payload. بارداده می‌تواند گزارش Crashlytics یا «ردپا» باشد. payload فقط می‌تواند یکی از موارد زیر باشد:
log object (Log)

گزارش Crashlytics.
breadcrumb object (Breadcrumb)

نشانگر صفحات Crashlytics.

Log

خطوط گزارش ارائه‌شده توسط توسعه‌دهنده که درطول جلسه ضبط شده است.

نمایش JSON

{
  "logTime": string,
  "message": string
}
فیلدها شرح
logTime 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».
message string

پیام گزارش.

Breadcrumb

رویدادهای Analytics که درطول جلسه ضبط شده است.

نمایش JSON

{
  "eventTime": string,
  "title": string,
  "params": {
    string: string,
    ...
  }
}
فیلدها شرح
eventTime 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».
title string

نام رویداد تحلیلی.
params map (key: string, value: string)

پارامترهای رویداد.

شیئی حاوی فهرستی از جفت‌های «کلید»: مقدار. مثال: { «نام»: «آچار»، «جرم»: «۱٫۳ کیلوگرم»، «تعداد»: «۳» }.