طرحواره گزارش برای داده‌های صادر شده در 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
}
فیلدها توضیحات
name string

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

platform string

پلتفرم موبایل (اندروید یا iOS).

bundleOrPackage string

نام بسته برای برنامه‌های iOS یا نام بسته برای برنامه‌های اندروید. فرمت: com.mycompany.myapp .

eventId string

فقط خروجی. تغییرناپذیر. شناسه رویداد منحصر به فرد در حین پردازش اختصاص داده می‌شود.

sessionId string

شناسه منحصر به فرد برای جلسه Firebase.

eventTime string (Timestamp format)

مهر زمانی دستگاه که رویداد در آن ثبت شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری 0، 3، 6 یا 9 استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری 0، 3، 6 یا 9 استفاده می‌کند. آفست‌های غیر از "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

نسخه SDK کرش‌لیتیکز.

appOrientation string

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

deviceOrientation string

جهت دستگاه در زمان تصادف (عمودی یا افقی).

logs[] object (Log)

پیام‌های ثبت‌شده توسط توسعه‌دهنده در طول جلسه را ثبت کنید.

breadcrumbs[] object (Breadcrumb)

رویدادهای تحلیلی که توسط SDK تحلیلی در طول جلسه ثبت شده‌اند.

blameFrame object (Frame)

فریم ردیابی پشته توسط پردازش Crashlytics مقصر شناخته شده است. ممکن است در آنالیزورهای آینده وجود نداشته باشد.

exceptions[] object (Exception)

فقط اندروید. استثناهایی که در طول این رویداد رخ داده‌اند. استثناهای تو در تو به ترتیب زمانی معکوس نمایش داده می‌شوند، به طوری که آخرین رکورد، اولین استثنای رخ داده است.

errors[] object (Error)

فقط اپل. یک خطای غیرمهلک که توسط iOS SDK و stacktrace آن ثبت شده است.

threads[] object (Thread)

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

processState string

وضعیت فرآیند برنامه در زمان رویداد.

issueTitle string

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

issueSubtitle string

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

buildStamp 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

یک فریم در stacktrace.

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

یکی از گزینه‌های توسعه‌دهنده، فروشنده، زمان اجرا، پلتفرم یا سیستم.

blamed boolean

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

Exception

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

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

فریم‌های موجود در stacktrace مربوط به استثنا.

Error

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

نمایش 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 مشخص کرده باشد که stacktrace در این خطا، محل وقوع خطا است.

frames[] object (Frame)

فریم‌های موجود در stacktrace مربوط به خطا.

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 مشخص کرده باشد که stacktrace در این تاپیک محل وقوع خطا است.

frames[] object (Frame)

فریم‌های موجود در stacktrace رشته.

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

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


طرحواره جلسات فایربیس

FirebaseSessionEvent

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

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

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

firstSessionId string

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

sessionIndex integer

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

firebaseInstallationId string

به طور منحصر به فرد دستگاهی را که برنامه‌های Firebase روی آن نصب شده است، شناسایی می‌کند.

eventTime string (Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری 0، 3، 6 یا 9 استفاده می‌کند. آفست‌های غیر از "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 فیلد Union. بار داده می‌تواند یک لاگ Crashlytics یا یک Breadcrumb باشد. payload می‌تواند فقط یکی از موارد زیر باشد:

log object (Log)

گزارش Crashlytics.

breadcrumb object (Breadcrumb)

خرده نان Crashlytics.

Log

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

نمایش JSON 

{
  "logTime": string,
  "message": string
}
فیلدها توضیحات
logTime string (Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری 0، 3، 6 یا 9 استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30".

message string

پیام ثبت وقایع.

Breadcrumb

رویدادهای تحلیلی ثبت شده در طول جلسه.

نمایش JSON 

{
  "eventTime": string,
  "title": string,
  "params": {
    string: string,
    ...
  }
}
فیلدها توضیحات
eventTime string (Timestamp format)

مهر زمانی دستگاه برای رویداد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری 0، 3، 6 یا 9 استفاده می‌کند. آفست‌های غیر از "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" }.