طرحواره مجموعه داده برای داده‌های صادرشده در BigQuery

این صفحه طرح مجموعه داده را برای داده‌های صادرشده Crashlytics و داده‌های جلسات Firebase در BigQuery ارائه می‌دهد.

Firebase مجموعه داده‌های جدیدی در BigQuery برای داده‌های صادرشده شما ایجاد می‌کند:


مجموعه‌داده Crashlytics

داده‌های Crashlytics به مجموعه داده BigQuery با نام firebase_crashlytics صادر می‌شود. مجموعه داده کل پروژه شما را پوشش می‌دهد، حتی اگر چندین برنامه داشته باشد.

جدول‌ها

به‌طور پیش‌فرض، Firebase جدول‌های جداگانه‌ای در مجموعه داده Crashlytics برای هر برنامه در پروژه‌تان که به BigQuery پیوند شده است ایجاد می‌کند.

نام جدول‌ها براساس شناسه برنامه (با تبدیل نقطه‌ها به زیرخط) و افزودن پلاتفرم برنامه (_IOS یا _ANDROID) به انتهای آن تعیین می‌شود. برای مثال، داده‌های برنامه Android با نام بسته com.google.test در جدولی با نام com_google_test_ANDROID قرار می‌گیرد.

  • اگر صادر کردن جاری‌سازی به BigQuery فعال باشد، داده‌ها به‌صورت هم‌زمان به جدولی که _REALTIME به آن اضافه شده است جاری‌سازی می‌شود (برای مثال، com_google_test_ANDROID_REALTIME).

  • هر ردیف در جدول نشان‌دهنده رویدادی است که در برنامه رخ داده است، ازجمله خرابی‌ها، خطاهای غیرمهلک، و خطاهای «برنامه پاسخ نمی‌دهد».

  • این جدول‌ها علاوه‌بر کلیدهای Crashlytics سفارشی که شما در برنامه‌تان تعریف کرده‌اید، حاوی مجموعه استانداردی از داده‌های Crashlytics هستند (iOS+‎ | Android | Flutter | Unity ).

ردیف‌ها

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

ستون‌ها

ستون‌های جدول برای خرابی‌ها، خطاهای غیرمهلک، و خطاهای ANR یکسان است.

  • اگر جاری‌سازی صادرات به BigQuery فعال باشد، جدول هم‌زمان همان ستون‌های جدول دسته‌ای را خواهد داشت.

  • ممکن است ستون‌هایی در ردیف‌ها داشته باشید که نشان‌دهنده رویدادهایی هستند که رد پشته ندارند.

ستون‌های جدول برای داده‌های صادرشده Crashlytics در اینجا آمده است:

نام فیلد نوع داده شرح
app_orientation رشته برای مثال، PORTRAIT، LANDSCAPE، FACE_UP، FACE_DOWN، و غیره.
application RECORD برنامه‌ای که رویداد را ایجاد کرده است
application.build_version رشته نسخه ساخت برنامه
application.display_version رشته
blame_frame RECORD فریمی که به‌عنوان علت ریشه‌ای ازکارافتادگی یا خطا شناسایی شده است
blame_frame.address INT64 نشانی در تصویر دودویی که حاوی کد است
برای قاب‌های Java تنظیم نشده است
blame_frame.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت ازکارافتادگی یا خطا است یا نه
blame_frame.file رشته نام فایل قاب
blame_frame.library رشته نام نمایشی کتابخانه‌ای که قاب را دربرمی‌گیرد
blame_frame.line INT64 شماره خط فایل قاب
blame_frame.offset INT64 انحراف بایت در تصویر دودویی که حاوی کد
است برای استثناهای Java تنظیم نشده است
blame_frame.owner رشته برای مثال، DEVELOPER، VENDOR، RUNTIME، PLATFORM، یا SYSTEM
blame_frame.symbol رشته نماد هیدراته‌شده، یا نماد خام اگر هیدراته‌شدنی نباشد
breadcrumbs REPEATED RECORD Google Analyticsنشانگرهای صفحات دارای مُهر زمان، درصورت فعال بودن
breadcrumbs.name رشته نام مرتبط با راهنمای گام‌به‌گام
breadcrumbs.params REPEATED RECORD پارامترهای مرتبط با راهنمای گام‌به‌گام
breadcrumbs.params.key رشته کلید پارامتر مرتبط با راهنمای گام‌به‌گام
breadcrumbs.params.value رشته مقدار پارامتر مرتبط با راهنمای گام‌به‌گام
breadcrumbs.timestamp مُهر زمان مُهر زمان مرتبط با ردپا
bundle_identifier رشته شناسه یکتای برنامه که در پروژه Firebase ثبت شده است (برای مثال، com.google.gmail)
برای برنامه‌های پلاتفرم Apple، این شناسه دسته نرم‌افزاری برنامه است.
برای برنامه‌های Android، این نام بسته برنامه است.
crashlytics_sdk_versions رشته نسخه کیت توسعه نرم‌افزار Crashlytics که رویداد را تولید کرده است
custom_keys REPEATED RECORD جفت‌های کلید-مقدار تعریف‌شده توسط توسعه‌دهنده
custom_keys.key رشته کلید تعریف‌شده توسط توسعه‌دهنده
custom_keys.value رشته مقدار تعریف‌شده توسط توسعه‌دهنده
device RECORD دستگاهی که رویداد در آن رخ داده است
device_orientation رشته برای مثال، PORTRAIT، LANDSCAPE، FACE_UP، FACE_DOWN، و غیره.
device.architecture رشته برای مثال، X86_32، X86_64، ARMV7، ARM64، ARMV7S، یا ARMV7K
device.manufacturer رشته سازنده دستگاه
device.model رشته مدل دستگاه
error REPEATED RECORD خطاهای غیرمهلک (فقط برنامه‌های Apple)
error_type رشته نوع خطای رویداد (برای مثال، FATAL، NON_FATAL، ANR، و غیره)
error.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت خطا است یا نه
error.code INT64 کد خطای مرتبط با NSError ثبت‌شده سفارشی برنامه
error.frames REPEATED RECORD قاب‌های ردیابی پشته
error.frames.address INT64 نشانی در تصویر باینری که حاوی کد است
error.frames.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت خطا است یا نه
error.frames.file رشته نام فایل قاب
error.frames.library رشته نام نمایشی کتابخانه‌ای که قاب را دربرمی‌گیرد
error.frames.line INT64 شماره خط فایل قاب
error.frames.offset INT64 انحراف بایت در تصویر دودویی که حاوی کد است
error.frames.owner رشته برای مثال، DEVELOPER، VENDOR، RUNTIME، PLATFORM، یا SYSTEM
error.frames.symbol رشته نماد هیدراته‌شده، یا نماد خام اگر هیدراته‌شدنی نباشد
error.queue_name رشته صفی که رشته در آن اجرا می‌شد
error.subtitle رشته زیرعنوان رشته
error.title رشته عنوان رشته
event_id رشته شناسه یکتای رویداد
event_timestamp مُهر زمان زمان وقوع رویداد
exceptions REPEATED RECORD (فقط Android) استثناهایی که درطول این رویداد رخ داده است. استثناهای تودرتو به‌ترتیب زمانی معکوس ارائه می‌شوند، یعنی آخرین رکورد اولین استثنای ایجادشده است
exceptions.blamed مقدار منطقی اگر Crashlytics تشخیص دهد که استثنا مسئول خطا یا ازکارافتادگی است، مقدار True (درست) برمی‌گرداند
exceptions.exception_message رشته پیام مرتبط با استثنا
exceptions.frames REPEATED RECORD قاب‌های مرتبط با استثنا
exceptions.frames.address INT64 نشانی در تصویر دودویی که حاوی کد است
برای قاب‌های Java تنظیم نشده است
exceptions.frames.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت ازکارافتادگی یا خطا است یا نه
exceptions.frames.file رشته نام فایل قاب
exceptions.frames.library رشته نام نمایشی کتابخانه‌ای که قاب را دربرمی‌گیرد
exceptions.frames.line INT64 شماره خط فایل قاب
exceptions.frames.offset INT64 انحراف بایت در تصویر دودویی که حاوی کد
است برای استثناهای Java تنظیم نشده است
exceptions.frames.owner رشته برای مثال، DEVELOPER، VENDOR، RUNTIME، PLATFORM، یا SYSTEM
exceptions.frames.symbol رشته نماد هیدراته‌شده، یا نماد خام اگر هیدراته‌شدنی نباشد
exceptions.nested مقدار منطقی برای همه به‌جز آخرین استثنای ایجادشده (یعنی اولین رکورد) «درست» است
exceptions.subtitle رشته زیرعنوان رشته
exceptions.title رشته عنوان رشته
exceptions.type رشته نوع استثنا (برای مثال، java.lang.IllegalStateException)
firebase_session_id رشته شناسه تولیدشده به‌طور خودکار برای جلسه Firebase که به رویداد نگاشت شده است از Crashlytics
installation_uuid رشته شناسه‌ای که نصب یکتا برای برنامه و دستگاه را مشخص می‌کند
is_fatal مقدار منطقی اینکه آیا برنامه ازکار افتاده است یا نه
issue_id رشته مشکل مرتبط با رویداد
logs REPEATED RECORD پیام‌های گزارش مُهر زمان‌دار تولیدشده توسط ثبت‌کننده Crashlytics، درصورت فعال بودن
logs.message رشته پیام ثبت‌شده
logs.timestamp مُهر زمان زمان ایجاد گزارش
memory RECORD وضعیت حافظه دستگاه
memory.free INT64 بایت حافظه باقی‌مانده
memory.used INT64 بایت‌های حافظه استفاده‌شده
operating_system RECORD جزئیات سیستم‌عامل دستگاه
operating_system.device_type رشته نوع دستگاه (برای مثال، MOBILE، TABLET، TV، و غیره)؛ همچنین به‌عنوان «دسته دستگاه» شناخته می‌شود
operating_system.display_version رشته نسخه سیستم‌عامل دستگاه
operating_system.modification_state رشته آیا دستگاه اصلاح شده است (برای مثال، برنامه قفل‌شکسته MODIFIED است و برنامه ریشه‌یابی‌شده UNMODIFIED است)
operating_system.name رشته نام سیستم‌عامل دستگاه
operating_system.type رشته (فقط برنامه‌های Apple) نوع سیستم‌عامل درحال اجرا در دستگاه (برای مثال، IOS، MACOS، و غیره)
platform رشته پلاتفرم برنامه همان‌طور که در پروژه Firebase ثبت شده است (مقادیر معتبر: IOS یا ANDROID)
process_state رشته BACKGROUND یا FOREGROUND
storage RECORD فضای ذخیره‌سازی دائمی دستگاه
storage.free INT64 بایت‌های باقی‌مانده از فضای ذخیره‌سازی
storage.used INT64 بایت‌های فضای ذخیره‌سازی استفاده‌شده
threads REPEATED RECORD رشته‌های موجود در زمان رویداد
threads.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت ازکارافتادگی یا خطا است یا نه
threads.code INT64 (فقط برنامه‌های Apple) کد خطای ثبت‌شده سفارشی برنامه NSError
threads.crash_address INT64 نشانی سیگنالی که باعث ازکارافتادن برنامه شده است؛ فقط در رشته‌های بومی ازکارافتاده وجود دارد
threads.crashed مقدار منطقی اینکه آیا رشته ازکار افتاده است یا نه
threads.frames REPEATED RECORD قاب‌های رشته
threads.frames.address INT64 نشانی در تصویر باینری که حاوی کد است
threads.frames.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت خطا است یا نه
threads.frames.file رشته نام فایل قاب
threads.frames.library رشته نام نمایشی کتابخانه‌ای که قاب را دربرمی‌گیرد
threads.frames.line INT64 شماره خط فایل قاب
threads.frames.offset INT64 انحراف بایت در تصویر دودویی که حاوی کد است
threads.frames.owner رشته برای مثال، DEVELOPER، VENDOR، RUNTIME، PLATFORM، یا SYSTEM
threads.frames.symbol رشته نماد هیدراته‌شده، یا نماد خام اگر هیدراته‌شدنی نباشد
threads.queue_name رشته (فقط برنامه‌های Apple) صفی که رشته در آن اجرا می‌شد
threads.signal_code رشته کد سیگنالی که باعث ازکارافتادن برنامه شده است؛ فقط در رشته‌های بومی ازکارافتاده وجود دارد
threads.signal_name رشته نام سیگنالی که باعث ازکار افتادن برنامه شده است، فقط در رشته‌های بومی ازکارافتاده وجود دارد
threads.subtitle رشته زیرعنوان رشته
threads.thread_name رشته نام رشته
threads.title رشته عنوان رشته
unity_metadata.debug_build مقدار منطقی اگر این ساخت اشکال‌زدایی است
unity_metadata.graphics_copy_texture_support رشته پشتیبانی از کپی کردن بافت گرافیکی طبق تعریف در Unity API
unity_metadata.graphics_device_id INT64 شناسه دستگاه گرافیکی
unity_metadata.graphics_device_name رشته نام دستگاه گرافیکی
unity_metadata.graphics_device_type رشته نوع دستگاه گرافیکی
unity_metadata.graphics_device_vendor_id INT64 شناسه فروشنده پردازنده گرافیکی
unity_metadata.graphics_device_vendor رشته فروشنده دستگاه گرافیکی
unity_metadata.graphics_device_version رشته نسخه دستگاه گرافیکی
unity_metadata.graphics_max_texture_size INT64 حداکثر اندازه اختصاص‌داده‌شده به بافت پردازشی
unity_metadata.graphics_memory_size_mb INT64 حافظه نماپردازنده به مگابایت
unity_metadata.graphics_render_target_count INT64 تعداد هدف‌های پردازشی گرافیکی
unity_metadata.graphics_shader_level INT64 سطح سایه‌زن گرافیک
unity_metadata.processor_count INT64 تعداد پردازنده‌ها (هسته‌ها)
unity_metadata.processor_frequency_mhz INT64 فرکانس پردازنده(ها) برحسب مگاهرتز
unity_metadata.processor_type رشته نوع پردازنده
unity_metadata.screen_refresh_rate_hz INT64 نرخ بازآوری صفحه‌نمایش برحسب هرتز
unity_metadata.screen_resolution_dpi رشته DPI صفحه‌نمایش به‌عنوان عدد ممیز شناور
unity_metadata.screen_size_px رشته اندازه صفحه‌نمایش به پیکسل، با قالب عرض x ارتفاع
unity_metadata.system_memory_size_mb INT64 اندازه حافظه سیستم به مگابایت
unity_metadata.unity_version رشته نسخه Unity که در این دستگاه اجرا می‌شود
user RECORD (اختیاری) اطلاعات جمع‌آوری‌شده درباره کاربر برنامه
user.email رشته (اختیاری) نشانی ایمیل کاربر
user.id رشته (اختیاری) شناسه مختص برنامه مرتبط با کاربر
user.name رشته (اختیاری) نام کاربر
variant_id رشته نوع مشکل مرتبط با این رویداد
توجه داشته باشید که همه رویدادها نوع مشکل مرتبط ندارند.


مجموعه‌داده جلسه‌های Firebase

داده‌های جلسه‌های Firebase به مجموعه داده BigQuery با نام firebase_sessions صادر می‌شود. مجموعه داده کل پروژه شما را پوشش می‌دهد، حتی اگر چندین برنامه داشته باشد.

جدول‌ها

به‌طور پیش‌فرض، Firebase جدول‌های جداگانه‌ای در مجموعه داده جلسه‌های Firebase برای هر برنامه در پروژه شما که به BigQuery پیوند داده شده است ایجاد می‌کند.

نام جدول‌ها براساس شناسه برنامه (با تبدیل نقطه‌ها به زیرخط) و پلتفرم برنامه (_IOS یا _ANDROID) تعیین می‌شود. برای مثال، داده‌های برنامه Android با نام بسته com.google.test در جدولی با نام com_google_test_ANDROID قرار می‌گیرد.

ردیف‌ها

هر ردیف در جدول نشان‌دهنده رویداد جلسه‌ای است که اتفاق افتاده است.

ستون‌ها

اگر جاری‌سازی صادرات به BigQuery فعال باشد، جدول هم‌زمان همان ستون‌های جدول دسته‌ای را خواهد داشت.

ستون‌های جدول برای داده‌های صادرشده جلسات Firebase در اینجا آمده است:

نام فیلد نوع داده شرح
instance_id رشته شناسه نصب Firebase‏ (FID) از دستگاه. نصب یکتای برنامه + دستگاه را شناسایی می‌کند
session_id رشته شناسه یکتای این جلسه
first_session_id رشته اولین شناسه از سری جلسه‌هایی که این جلسه از زمان راه‌اندازی سرد برنامه در آن قرار دارد. از این شناسه می‌توان برای گروه‌بندی همه جلسه‌هایی که از زمان شروع سرد رخ داده‌اند استفاده کرد. اگر این جلسه اولین جلسه باشد، این فیلد با session_id یکسان خواهد بود.
session_index عدد صحیح ترتیب این جلسه پس‌از شروع سرد برنامه وارد شد. برای اولین جلسه پس‌از شروع سرد، این مقدار 0 خواهد بود. هر بار که جلسه‌ای بدون وقوع راه‌اندازی سرد ایجاد شود (برای مثال، پس‌از ۳۰ دقیقه عدم فعالیت)، شاخص افزایش می‌یابد.
event_type رشته نوع رویدادی که در جلسه اتفاق افتاده است (برای مثال، SESSION_START)
event_timestamp مُهر زمان زمان وقوع رویداد
received_timestamp مُهر زمان زمانی که سرور رویداد را از دستگاه دریافت کرد
performance_data_collection_enabled مقدار منطقی آیا جمع‌آوری داده‌های کیت توسعه نرم‌افزار «پایشگر کارایی Firebase» در زمان جلسه فعال بوده است یا نه
crashlytics_data_collection_enabled مقدار منطقی آیا جمع‌آوری داده‌های کیت توسعه نرم‌افزار Firebase Crashlytics در زمان جلسه فعال بوده است یا نه
application RECORD برنامه را توصیف می‌کند
application.build_version رشته نسخه ساخت برنامه (برای مثال، 1523456)
application.display_version رشته نسخه نمایشی برنامه (برای مثال، 4.1.7)
device RECORD دستگاهی که رویداد در آن رخ داده است
device.model رشته مدل دستگاه
device.manufacturer رشته سازنده دستگاه. برای برنامه‌های پلاتفرم Apple، این مقدار NULL خواهد بود.
operating_system RECORD سیستم‌عامل دستگاه را شرح می‌دهد
operating_system.display_version رشته نسخه نمایشی سیستم‌عامل (برای مثال، 10.2.1)
operating_system.name رشته نام سیستم‌عامل
operating_system.type رشته نوع سیستم‌عامل (برای مثال، IOS). این فیلد فقط برای دستگاه‌های Apple تنظیم می‌شود.
operating_system.device_type رشته نوع دستگاه (برای مثال، MOBILE، TABLET، TV)