طرحواره مجموعه داده برای داده‌های صادرشده در 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).

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

  • جدول‌ها علاوه‌بر هرگونه کلید 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 سابقه تکراری نشانگر صفحات Google Analytics با مُهر زمان، درصورت فعال بودن
breadcrumbs.name رشته نام مرتبط با خرده‌مسیر
breadcrumbs.params سابقه تکراری پارامترهای مرتبط با خرده‌نشان
breadcrumbs.params.key رشته کلید پارامتر مرتبط با خرده‌نشان
breadcrumbs.params.value رشته مقدار پارامتر مرتبط با خرده‌نشان
breadcrumbs.timestamp مُهر زمان مُهر زمان مرتبط با ردپا
bundle_identifier رشته شناسه یکتای برنامه که در پروژه Firebase ثبت شده است (برای مثال، com.google.gmail)
برای برنامه‌های پلاتفرم Apple، این شناسه بسته نرم‌افزاری برنامه است.
برای برنامه‌های Android، این نام بسته نرم‌افزاری برنامه است.
crashlytics_sdk_versions رشته نسخه کیت توسعه نرم‌افزار Crashlytics که رویداد را تولید کرده است
custom_keys سابقه تکراری جفت‌های کلید-مقدار تعریف‌شده توسط توسعه‌دهنده
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 سابقه تکراری خطاهای غیرمهلک (فقط برنامه‌های Apple)
error_type رشته نوع خطای رویداد (برای مثال، FATAL، NON_FATAL، ANR، و غیره)
error.blamed مقدار منطقی اینکه آیا Crashlytics تشخیص داده است که این قاب علت خطا است یا نه
error.code INT64 کد خطای مرتبط با NSError ثبت‌شده سفارشی برنامه
error.frames سابقه تکراری قاب‌های ردیابی پشته
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 سابقه تکراری (فقط Android) استثناهایی که درطول این رویداد رخ داده است. استثناهای تودرتو به‌ترتیب زمانی معکوس ارائه می‌شوند، به این معنی که آخرین گزارش اولین استثنایی است که ایجاد شده است
exceptions.blamed مقدار منطقی اگر Crashlytics تعیین کند استثنا مسئول خطا یا خرابی است درست است
exceptions.exception_message رشته پیامی مرتبط با استثنا
exceptions.frames سابقه تکراری قاب‌های مرتبط با استثنا
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 سابقه تکراری پیام‌های گزارش مهر زمان تولیدشده توسط گزارشگر 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 سابقه تکراری رشته‌های موجود در زمان رویداد
threads.blamed مقدار منطقی آیا Crashlytics تشخیص داده است که این قاب علت خرابی یا خطا است یا نه
threads.code INT64 (فقط برنامه‌های Apple) کد خطای ثبت سفارشی NSError برنامه
threads.crash_address INT64 نشانی سیگنالی که باعث ازکارافتادن برنامه شده است؛ فقط در رشته‌های بومی ازکارافتاده وجود دارد
threads.crashed مقدار منطقی آیا رشته ازکارافتاده است
threads.frames سابقه تکراری قاب‌های رشته
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 رشته تعداد نقطه در اینچ صفحه‌نمایش به‌عنوان یک عدد ممیز شناور
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)