این صفحه طرح گزارش را برای دادههای صادرشده Crashlytics و دادههای جلسات Firebase در Cloud Logging ارائه میدهد.
طرح جلسههای Firebase (تلفن همراه) (اگر دادههای جلسهها برای صادر کردن فعال باشد)
طرحواره Crashlytics (تلفن همراه)
Event
پیامی که یک رویداد Crashlytics را شرح میدهد.
نمایش JSON
{
"name": string,
"platform": string,
"bundleOrPackage": string,
"eventId": string,
"sessionId": string,
"crashlyticsSessionId": 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
الزامی است. فقط برونداد.
تغییرناپذیر. شناسه. نام منبع رویداد. قالب:
|
platform |
string
ANDROID، IOS، یا WEB. |
bundleOrPackage |
string
نام بسته نرمافزاری برای برنامههای iOS یا نام بسته برای برنامههای Android.
قالب: |
eventId |
string
فقط برونداد. تغییرناپذیر. شناسه یکتای رویداد درطول پردازش اختصاص داده میشود. |
sessionId |
string
شناسه یکتا برای جلسه Firebase. |
crashlyticsSessionId |
string
فقط برونداد. فقط تلفن همراه. شناسه یکتا برای جلسه Crashlytics. |
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 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-نرمالسازی میشود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده میکند. انحرافهای غیراز «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. |
فیلد اتحادیه |
|
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)
پارامترهای رویداد. شیء حاوی فهرستی از جفتهای «کلید»: مقدار. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
طرحواره Crashlytics (وب)
این بخش طرحواره Cloud Logging را برای رویدادهای وب Crashlytics صادرشده شرح میدهد.
LogEntry
پیام توصیفکننده یک رویداد وب Crashlytics در Cloud Logging
(firebasetelemetry.googleapis.com/events).
نمایش JSON
{
"insertId": "insert_id",
"jsonPayload": {
"exception.stacktrace": "stacktrace",
"exception.message": "test error",
"exception.type": "Error"
},
"httpRequest": {
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36,gzip(gfe)"
},
"resource": {
"type": "firebasetelemetry.googleapis.com/App",
"labels": {
"resource_container": "projects/PROJECT_ID",
"location": "global",
"app_id": "FIREBASE_APP_ID",
"app_version": ""
}
},
"timestamp": "2026-06-25T21:19:44.619Z",
"severity": "ERROR",
"labels": {
"attr": "value",
"app.installation.id": "INSTALLATION_ID",
"exception.type": "Error",
"service.name": "FIREBASE_APP_ID",
"app_id": "FIREBASE_APP_ID",
"location": "global",
"session.id": "SESSION_ID",
"exception.stacktrace": "stacktrace",
"gcp.resource_type": "firebasetelemetry.googleapis.com/App",
"exception.message": "test error",
"gcp.telemetry_type": "standard",
"service.version": "",
"cloud.resource.id": "//firebasetelemetry.googleapis.com/projects/PROJECT_ID/locations/global/",
"gcp.project.id": "projects/PROJECT_ID",
"user_agent.version": "150",
"gcp.project_id": "PROJECT_ID",
"resource_container": "projects/PROJECT_ID",
"os.version": "10_15_7",
"browser.platform": "macintosh",
"gcp.telemetry_config.service": "firebasetelemetry.googleapis.com",
"os.name": "intel mac os x",
"user_agent.name": "chrome",
"app.build_id": "unset"
},
"logName": "projects/PROJECT_ID/logs/firebasetelemetry.googleapis.com%2Fevents",
"receiveTimestamp": "2026-06-25T21:19:45.105200710Z",
"errorGroups": [
{
"id": "error_group_id"
}
],
"otel": {
"resource": {
"attributes": {
"gcp.resource_type": "firebasetelemetry.googleapis.com/App",
"service.version": "",
"user_agent.version": "150",
"cloud.resource.id": "//firebasetelemetry.googleapis.com/projects/PROJECT_ID/locations/global/",
"gcp.project.id": "projects/PROJECT_ID",
"os.version": "10_15_7",
"gcp.project_id": "PROJECT_ID",
"resource_container": "projects/PROJECT_ID",
"browser.platform": "macintosh",
"os.name": "intel mac os x",
"user_agent.name": "chrome",
"app.build_id": "",
"service.name": "firebase_telemetry_service",
"app_id": "FIREBASE_APP_ID",
"location": "global",
"user_agent.original": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36,gzip(gfe)"
}
}
}
}
| فیلدها | شرح |
|---|---|
insertId |
string
شناسه یکتا برای ورودی گزارش در Cloud Logging. |
jsonPayload |
object
پایهبار رویداد حاوی جزئیات استثنا
( |
httpRequest |
object
فراداده درخواست HTTP، ازجمله |
resource |
object
فراداده منبع پایششده
( |
timestamp |
string (Timestamp format)
مُهر زمان کارخواه که رویداد در آن ثبت شده است. |
severity |
string
سطح شدت گزارش (برای مثال، |
labels |
map (key: string, value: string)
برچسبهای رویداد، جلسه، مرورگر، سیستمعامل، و مشخصه سفارشی مرتبط با رویداد. |
logName |
string
نام منبع گزارش
( |
receiveTimestamp |
string (Timestamp format)
مُهر زمان سرور که در آن ورودی گزارش توسط Cloud Logging دریافت شد. |
errorGroups[] |
object
شناسههای گروه خطا به رویداد اختصاص داده شده است. |
otel |
object
مشخصههای منبع OpenTelemetry برای کارخواه وب و سرویس دورسنجی. |
فراداده مرورگر وب
ابعاد محیط مرورگر و کارخواه در labels و otel.resource.attributes پر شده است.
| فیلدها | شرح |
|---|---|
browser.platform |
string
سیستمعامل کارخواه و معماری پلاتفرم (برای مثال،
|
user_agent.name |
string
نام برنامه کارخواه مرورگر (برای مثال، |
user_agent.version |
string
نسخه اصلی یا فرعی کلاینت مرورگر (برای مثال،
|
user_agent.original |
string
رشته خام «نماینده کاربر» از درخواست کارخواه (برای مثال،
|