داده‌های Crashlytics را به BigQuery صادر کنید

شما می‌توانید داده‌های Firebase Crashlytics خود را به BigQuery منتقل کنید. زمانی که داده‌ها در BigQuery قرار گرفتند، می‌توانید داده‌ها را با استفاده از کوئری‌های SQL تجزیه و تحلیل کنید ، مصورسازی داده‌ها و داشبوردهای سفارشی بسازید و حتی داده‌ها را به سرویس‌های دیگر منتقل کنید .

این صفحه نحوه تنظیم خروجی گرفتن از داده‌های جلسات Crashlytics و (اختیاری) Firebase به BigQuery را شرح می‌دهد.

تنظیم خروجی به BigQuery

1. در کنسول Firebase ، به صفحه Integrations بروید.

2. در کارت BigQuery ، روی پیوند (Link) کلیک کنید.

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

   • برای بهبود درک کاربران بدون خرابی و جلسات بدون خرابی، قابلیت صادرات داده‌های جلسات Firebase را فعال کنید .

   • برای دسترسی تقریباً بلادرنگ به داده‌های Crashlytics و داده‌های جلسات Firebase خود در BigQuery ، قابلیت streaming export را فعال کنید .

لغو پیوند از BigQuery

قطع ارتباط از BigQuery مانع از پر شدن مجموعه داده‌های مربوطه در BigQuery می‌شود.

از موارد زیر آگاه باشید:

• هر داده‌ای که قبلاً به BigQuery صادر شده باشد، برای مدت زمان مجاز نگهداری باقی خواهد ماند و ممکن است هزینه‌های ذخیره‌سازی و پرس‌وجو همچنان اعمال شود. می‌توانید مجموعه(های) داده خود را به صورت دستی حذف کنید تا از هرگونه هزینه اضافی جلوگیری شود.

• اگر داده‌های BigQuery شما در سرویس‌های دیگر ذخیره شده است، ممکن است شرایط متفاوتی برای ماندگاری داده‌ها وجود داشته باشد.

شما می‌توانید در سطح پروژه فایربیس، در سطح محصول یا در سطح برنامه برای یک محصول خاص، از BigQuery جدا شوید.

نحوه‌ی لغو اتصال از BigQuery به شرح زیر است:

1. در کنسول Firebase ، به صفحه Integrations بروید.

2. در کارت BigQuery ، روی مدیریت (Manage) کلیک کنید.

3. برای لغو پیوند یک محصول خاص یا لغو پیوند برنامه‌های خاص برای یک محصول خاص، انتخاب کنید.

   برای قطع ارتباط کامل پروژه Firebase خود، دکمه موجود در پایین صفحه را پیدا کنید.

4. وقتی از شما خواسته شد، تأیید کنید که می‌خواهید صادرات را متوقف کنید.

وقتی export رو ​​فعال می‌کنی چه اتفاقی می‌افته؟

• فایربیس داده‌ها را از برنامه‌های مرتبط با BigQuery استخراج می‌کند.

  • در طول راه‌اندازی، به‌طور پیش‌فرض، تمام برنامه‌های پروژه شما به BigQuery لینک می‌شوند، اما می‌توانید انتخاب کنید که برنامه‌های خاص در طول راه‌اندازی لینک نشوند .

  • هر برنامه‌ای که بعداً به پروژه Firebase خود اضافه کنید، به‌طور خودکار به BigQuery پیوند داده می‌شود.

  • در هر زمانی، می‌توانید مدیریت کنید که کدام برنامه‌ها داده‌ها را صادر کنند .

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

  • این مکان هم برای مجموعه داده Crashlytics و هم برای مجموعه داده Sessions در Firebase (در صورتی که داده‌های Session برای خروجی گرفتن فعال باشد) اعمال می‌شود.

  • این مکان فقط برای داده‌های صادر شده به BigQuery قابل استفاده است و تاثیری بر مکان داده‌های ذخیره شده برای استفاده در داشبورد Crashlytics کنسول Firebase یا در Android Studio ندارد.

  • پس از ایجاد یک مجموعه داده، مکان آن قابل تغییر نیست، اما می‌توانید مجموعه داده را در مکان دیگری کپی کنید یا به صورت دستی مجموعه داده را در مکان دیگری جابجا (بازسازی) کنید. برای کسب اطلاعات بیشتر، به تغییر مکان برای صادرات موجود مراجعه کنید.

• فایربیس همگام‌سازی‌های روزانه داده‌های دسته‌ای شما را با BigQuery تنظیم می‌کند.

  • پس از اتصال به BigQuery ، ممکن است خروجی اولیه داده‌های دسته‌ای تا ۴۸ ساعت طول بکشد.

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

• فایربیس یک کپی از داده‌های موجود شما را به BigQuery ارسال می‌کند.

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

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

  توجه داشته باشید که اگر قبل از اواسط اکتبر ۲۰۲۴، خروجی گرفتن از داده‌های Crashlytics را فعال کرده باشید، می‌توانید ۳۰ روز قبل از روزی که خروجی گرفتن را فعال کرده‌اید، دوباره اطلاعات را پر کنید.

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

  • هر برنامه‌ی لینک‌شده، جدول بی‌درنگ مخصوص به خود را نیز خواهد داشت که شامل داده‌های دائماً در حال به‌روزرسانی است (علاوه بر جدول دسته‌ای برنامه برای خروجی گرفتن روزانه از دسته‌ها).

  • پس از فعال کردن پخش، ممکن است تا ۱ ساعت طول بکشد تا پخش داده‌ها شروع شود.

  آیا داده‌ها را در جدول بلادرنگ خود نمی‌بینید؟

  1. مطمئن شوید که حداقل دو رویداد را از برنامه خود به Crashlytics ارسال کرده‌اید و پس از ارسال آنها چند دقیقه صبر کرده‌اید.

  2. مطمئن شوید که پروژه Firebase شما در طرح قیمت‌گذاری Blaze با پرداخت به ازای استفاده قرار دارد.
     می‌توانید این را با نگاه کردن به گوشه پایین سمت چپ کنسول Firebase بررسی کنید.

  3. اگر پس از ارسال دو رویداد و چند دقیقه انتظار، هنوز هیچ داده‌ای در جدول بی‌درنگ شما وجود ندارد:

     1. به کارت BigQuery در کنسول Firebase بروید.

     2. غیرفعال کردن و سپس فعال کردن مجدد خروجی استریمینگ.

     3. مطمئن شوید که حساب سرویس service- PROJECT_NUMBER @gcp-sa-crashlytics.iam.gserviceaccount.com در پروژه Firebase شما قرار دارد و نقش Firebase Crashlytics Service Agent را بر عهده دارد.
        می‌توانید این مورد را در صفحه IAM کنسول Google Cloud بررسی کنید (مطمئن شوید که کادر انتخاب Include Google-provided role grants را علامت زده‌اید).

     4. حداقل دو رویداد را به Crashlytics ارسال کنید و چند دقیقه صبر کنید.

  4. اگر هنوز داده‌ها را در جدول بلادرنگ خود نمی‌بینید، با پشتیبانی Firebase تماس بگیرید .

مزایای خروجی گرفتن از استریم به BigQuery

به طور پیش‌فرض، داده‌ها به صورت روزانه و دسته‌ای به BigQuery صادر می‌شوند. علاوه بر این، می‌توانید داده‌های Crashlytics و جلسات Firebase خود را به صورت بلادرنگ با BigQuery streaming پخش کنید. می‌توانید از داده‌های پخش شده برای هر هدفی که نیاز به داده‌های زنده دارد، مانند ارائه اطلاعات در یک داشبورد زنده، تماشای یک به‌روزرسانی به صورت زنده یا نظارت بر مشکلات برنامه که باعث ایجاد هشدارها و گردش‌های کاری سفارشی می‌شوند، استفاده کنید.

وقتی قابلیت ارسال جریانی به BigQuery را فعال می‌کنید، جداول بلادرنگ (Realtime) نیز خواهید داشت (علاوه بر جداول دسته‌ای). هر دو نوع جدول، طرح مجموعه داده یکسانی خواهند داشت، اما در اینجا چند تفاوت مهم بین جداول دسته‌ای و جداول بلادرنگ وجود دارد:

جدول دسته‌ای برای تحلیل بلندمدت و شناسایی روندها در طول زمان ایده‌آل است، زیرا ما رویدادها را قبل از نوشتن به طور مداوم ذخیره می‌کنیم و می‌توان آن‌ها را تا 30 روز* در جدول ذخیره کرد. وقتی داده‌ها را در جدول بلادرنگ شما می‌نویسیم، بلافاصله آن را در BigQuery می‌نویسیم و بنابراین برای داشبوردهای زنده و هشدارهای سفارشی ایده‌آل است. این دو جدول را می‌توان با یک کوئری دوخت ترکیب کرد تا از مزایای هر دو بهره‌مند شوید.

به طور پیش‌فرض، جدول realtime دارای زمان انقضای پارتیشن 30 روزه است. برای یادگیری نحوه تغییر این زمان، به بخش تنظیم انقضای پارتیشن در مستندات BigQuery مراجعه کنید.

^{* جزئیات مربوط به پشتیبانی از پر کردن مجدد را در ارتقاء به زیرساخت صادرات جدید مشاهده کنید.}

قیمت‌گذاری و سندباکس BigQuery

اگر پروژه Firebase شما در طرح قیمت‌گذاری بدون هزینه Spark قرار دارد، می‌توانید از BigQuery sandbox استفاده کنید که دسترسی رایگان به BigQuery را فراهم می‌کند. برای اطلاعات بیشتر در مورد BigQuery sandbox و قابلیت‌های آن، به بخش «استفاده از BigQuery sandbox» مراجعه کنید.

اگر پروژه Firebase شما در طرح قیمت‌گذاری Blaze با پرداخت در محل قرار دارد، می‌توانید از تمام ویژگی‌های BigQuery استفاده کنید. استفاده شما از BigQuery تابع قیمت‌گذاری BigQuery است که شامل استفاده محدود و بدون هزینه می‌شود.

ارتقا به زیرساخت جدید صادرات برای BigQuery

در اواسط اکتبر ۲۰۲۴، Crashlytics زیرساخت جدیدی را برای صادرات دسته‌ای داده‌های Crashlytics به BigQuery راه‌اندازی کرد.

• اگر بعد از اکتبر ۲۰۲۴ ، قابلیت صادرات دسته‌ای را فعال کرده باشید، پروژه Firebase شما به طور خودکار از زیرساخت صادرات جدید استفاده می‌کند و نیازی به انجام هیچ کاری نیست.

• اگر قبل یا در طول اکتبر ۲۰۲۴ ، قابلیت صادرات دسته‌ای را فعال کرده‌اید، اطلاعات موجود در بخش «چگونه زیرساخت صادرات جدید BigQuery را ارتقا دهیم؟» را بررسی کنید تا مشخص شود که آیا نیاز به انجام اقدامی دارید یا خیر.

بعدش چی؟

• بررسی مثال‌های کوئری‌های SQL

• با استفاده از داده‌های خروجی و سرویس‌های مختلف Google Cloud مانند Looker Studio ، داشبوردهای سفارشی بسازید .

• درباره طرحواره مجموعه داده برای داده‌های صادر شده اطلاعات کسب کنید.