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

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

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

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

• مجموعه داده جلسه‌های Firebase (اگر داده‌های جلسه‌ها برای صادر کردن فعال باشد)

توجه: صادر کردن مستقیم Crashlytics به BigQuery برای برنامه‌های وب پشتیبانی نمی‌شود. برای طرح‌واره گزارش‌های برنامه وب ذخیره‌شده در باکت firebase-telemetry Cloud Logging، به طرح‌واره گزارش برای داده‌های صادرشده در Cloud Logging مراجعه کنید.

---

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

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

جدول‌ها

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

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

توجه: همچنین می‌توانید از صادر کردن داده‌ها به BigQuery برای برنامه‌های تلفن همراه خاص در پروژه‌تان از داخل کنسول Firebase انصراف دهید.

• اگر صادر کردن جاری‌سازی به 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	مقدار منطقی	این فیلد منسوخ شده است. درعوض از error_type استفاده کنید. اینکه آیا برنامه ازکار افتاده است یا نه
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)