طرحواره گزارش برای داده‌های صادرشده در 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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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.
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

استثنای Java یا Javascript و ردیابی پشته آن. فقط از برنامه‌های 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 تعیین کرده باشد که خطا در این رشته رخ داده است درست است.
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 تعیین کرده باشد که پشته‌ردیابی در این خطا محل وقوع خطا است، درست است.
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 تعیین کرده باشد که پشته‌ردیابی در این رشته محل وقوع خطا است، درست است.
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».

نمایش 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

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

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

دستگاهی را که برنامه‌های Firebase در آن نصب شده است به‌صورت منحصربه‌فرد شناسایی می‌کند.
eventTime string (Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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 یا Breadcrumb باشد. ‫payload فقط می‌تواند یکی از موارد زیر باشد:
log object (Log)

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

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

Log

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

نمایش JSON

{
  "logTime": string,
  "message": string
}
فیلدها شرح
logTime string (Timestamp format)

مهر زمان دستگاه هنگام ثبت خط.

از RFC 3339 استفاده می‌کند، که در آن برونداد تولیدشده همیشه با Z عادی‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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 عادی‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیر از «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)

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

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