تصدير بيانات Crashlytics إلى BigQuery

يمكنك تصدير بيانات Firebase Crashlytics إلى BigQuery. بعد نقل البيانات إلى BigQuery، يمكنك تحليل البيانات باستخدام طلبات بحث SQL وإنشاء تصورات للبيانات ولوحات بيانات مخصّصة، ويمكنك أيضًا تصدير البيانات إلى خدمات أخرى.

توضّح هذه الصفحة كيفية إعداد عملية تصدير بيانات جلسات Crashlytics و (اختياريًا) Firebase إلى BigQuery.

إعداد عملية التصدير إلى BigQuery

ملاحظة: تأكَّد من حصولك على مستوى الوصول المطلوب لعرض إعدادات تصدير البيانات إلى BigQuery أو إدارتها.

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج.

2. في بطاقة BigQuery، انقر على ربط.

3. اتّبِع التعليمات الظاهرة على الشاشة لإعداد عملية التصدير إلى BigQuery، بما في ذلك الخيارات التالية:

   • لتحسين فهم المستخدمين الذين لم يواجهوا أي أعطال والجلسات التي لم تتضمّن أي أعطال، فعِّل ميزة تصدير بيانات جلسات Firebase.

   • للحصول على إذن وصول شبه فوري إلى بيانات Crashlytics وبيانات جلسات Firebase في BigQuery، عليك تفعيل ميزة "تصدير البيانات المتدفّقة".

(اختياري) تفعيل تصدير بيانات الجلسات في Firebase

ملاحظة: لتصدير بيانات الجلسات إلى BigQuery، يجب أن يستخدم تطبيقك الحد الأدنى من إصدارات حزمة تطوير البرامج (SDK) التالية من Crashlytics:
منصات Apple: الإصدار 10.8.0 أو إصدار أحدث | Android: الإصدار 18.6.0 أو إصدار أحدث (BoM الإصدار 32.6.0 أو إصدار أحدث) | Flutter: الإصدار 3.4.5 أو إصدار أحدث | Unity: الإصدار 11.7.0 أو إصدار أحدث

يمكن أيضًا تفعيل هذا الخيار أثناء الإعداد الأوّلي لعملية التصدير إلى BigQuery.

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج.

2. في بطاقة BigQuery، انقر على إدارة.

3. ضَع علامة في مربّع الاختيار تضمين الجلسات.

يؤدي هذا الإجراء إلى تفعيل تصدير بيانات الجلسات لجميع تطبيقاتك المرتبطة. في حال تفعيل ميزة تصدير البيانات أثناء البث، ستبدأ عملية تصدير بيانات الجلسات في الوقت الفعلي أيضًا.

(اختياري) تفعيل ميزة "بث التصدير"

ملاحظة: لا تتوفّر ميزة تصدير البث إذا كان مشروعك ضمن خطة أسعار Spark أو إذا كنت تستخدم BigQuery sandbox (إمكانية الوصول إلى BigQuery بدون تكلفة).

مزيد من المعلومات عن مزايا ميزة "التصدير المتواصل" إلى BigQuery لاحقًا في هذه الصفحة.

يمكن أيضًا تفعيل هذا الخيار أثناء الإعداد الأوّلي لعملية التصدير إلى BigQuery.

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج.

2. في بطاقة BigQuery، انقر على إدارة.

3. ضَع علامة في مربّع الاختيار تضمين البث.

يتيح هذا الإجراء البث لجميع تطبيقاتك المرتبطة. في حال تفعيل ميزة تصدير جلسات Firebase، سيؤدي ذلك إلى تفعيل ميزة "بث التصدير" لبيانات الجلسات أيضًا.

إلغاء الربط بـ "BigQuery"

يؤدي إلغاء الربط من BigQuery إلى إيقاف تعبئة مجموعات البيانات المقابلة في BigQuery.

يُرجى الانتباه إلى ما يلي:

• ستبقى أي بيانات تم تصديرها إلى BigQuery محفوظة لمدة الاحتفاظ المسموح بها، وقد يستمر تطبيق رسوم التخزين وطلبات البحث. يمكنك حذف مجموعات البيانات يدويًا لمنع تحميل المزيد من الفواتير.

• إذا كانت لديك بيانات BigQuery مخزَّنة في خدمات أخرى، قد تخضع هذه البيانات لبنود مختلفة بشأن استمرار توفّر البيانات.

يمكنك إلغاء الربط من BigQuery على مستوى مشروع Firebase أو على مستوى المنتج أو على مستوى التطبيق لمنتج معيّن.

تنبيه: يؤدي إلغاء ربط مشروعك على Firebase بـ BigQuery إلى إيقاف جميع عمليات تصدير البيانات من أي منتج من منتجات Firebase (وGoogle Analytics إذا كان ذلك منطبقًا) التي أعددت لها عملية التصدير إلى BigQuery.

في ما يلي كيفية إلغاء الربط من BigQuery:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج.

2. في بطاقة BigQuery، انقر على إدارة.

3. اختَر إلغاء ربط منتج معيّن أو إلغاء ربط تطبيقات معيّنة بمنتج معيّن.

   لإلغاء ربط مشروعك في Firebase بالكامل، ابحث عن الزر في أسفل الصفحة.

4. عندما يُطلب منك ذلك، أكِّد رغبتك في إيقاف عمليات التصدير.

---

ماذا يحدث عند تفعيل ميزة التصدير؟

• تصدِّر Firebase البيانات من التطبيقات المرتبطة بـ BigQuery.

  • أثناء عملية الإعداد، يتم تلقائيًا ربط جميع التطبيقات في مشروعك بحساب BigQuery، ولكن يمكنك اختيار عدم ربط تطبيقات معيّنة أثناء عملية الإعداد.

  • يتم تلقائيًا ربط أي تطبيقات تضيفها لاحقًا إلى مشروعك على Firebase بـ BigQuery.

  • يمكنك في أي وقت إدارة التطبيقات التي تصدّر البيانات.

• يصدّر Firebase البيانات إلى موقع مجموعة البيانات الذي اخترته أثناء الإعداد.

  • ينطبق هذا الموقع الجغرافي على مجموعة بيانات Crashlytics ومجموعة بيانات جلسات Firebase (في حال تفعيل ميزة تصدير بيانات الجلسات).

  • ينطبق هذا الموقع الجغرافي فقط على البيانات التي يتم تصديرها إلى BigQuery، ولا يؤثّر في الموقع الجغرافي للبيانات المخزَّنة لاستخدامها في لوحة بيانات Crashlytics في وحدة تحكّم Firebase أو في Android Studio.

  • بعد إنشاء مجموعة بيانات، لا يمكن تغيير موقعها الجغرافي، ولكن يمكنك نسخها إلى موقع جغرافي آخر أو نقلها (إعادة إنشائها) يدويًا في موقع جغرافي آخر. لمزيد من المعلومات، اطّلِع على مقالة تغيير الموقع الجغرافي لعمليات التصدير الحالية.

  ملاحظة: لا تتوفّر إمكانية اختيار الموقع الجغرافي وتغييره لتصدير البيانات إلا إذا فعّلت عملية التصدير بعد منتصف أكتوبر 2024 أو إذا رقّيت إلى البنية الأساسية الجديدة للتصدير.

• يُعدّ Firebase عمليات مزامنة يومية لبيانات الدفعات مع BigQuery.

  • بعد الربط بـ BigQuery، قد يستغرق تصدير الدفعة الأولية من البيانات مدة تصل إلى 48 ساعة.

  • تتم المزامنة اليومية مرة واحدة في اليوم، بغض النظر عن أي عملية تصدير مجدولة ربما تكون قد أعددتها في BigQuery. يُرجى العِلم أنّ توقيت مهمة المزامنة ومدتها قد يتغيّران، لذا لا ننصح بجدولة العمليات أو المهام اللاحقة استنادًا إلى توقيت محدّد للتصدير.

• تصدّر Firebase نسخة من بياناتك الحالية إلى BigQuery.

  • بالنسبة إلى كل تطبيق مرتبط، تتضمّن عملية التصدير هذه جدول دُفعات يحتوي على البيانات من المزامنة اليومية.

  • يمكنك تحديد جدول زمني يدويًا لعمليات إعادة تعبئة البيانات لجدول الدفعات لمدة تصل إلى 30 يومًا مضت أو لأحدث تاريخ تم فيه تفعيل التصدير إلى BigQuery (أيهما أحدث).

  يُرجى العِلم أنّه في حال فعّلت تصدير بيانات Crashlytics قبل منتصف أكتوبر 2024، يمكنك أيضًا إعادة ملء البيانات لمدة 30 يومًا قبل اليوم الذي فعّلت فيه عملية التصدير.

• تنفِّذ Firebase ما يلي في حال تفعيل ميزة التصدير المتواصل إلى BigQuery.

  • سيكون لكل تطبيق مرتبط أيضًا جدول خاص به في الوقت الفعلي يحتوي على بيانات يتم تعديلها باستمرار (بالإضافة إلى جدول الدُفعات الخاص بالتطبيق لتصدير الدُفعات اليومية).

  • بعد تفعيل البث، قد يستغرق بدء بث البيانات ساعة واحدة.

  ألا تظهر لك البيانات في جدول "الوقت الفعلي"؟

  1. تأكَّد من أنّك أرسلت حدثَين على الأقل من تطبيقك إلى Crashlytics وانتظرت بضع دقائق بعد إرسالهما.

  2. تأكَّد من أنّ مشروعك على Firebase يستخدِم خطة التسعير Blaze بنظام الدفع حسب الاستخدام.
     يمكنك التحقّق من ذلك من خلال النظر إلى أسفل يمين Firebase وحدة التحكّم.

  3. إذا لم تظهر أي بيانات في جدول الوقت الفعلي بعد إرسال حدثَين والانتظار بضع دقائق، اتّبِع الخطوات التالية:

     1. انتقِل إلى بطاقة BigQuery في وحدة تحكّم Firebase.

     2. أوقِف ميزة تصدير البث المباشر ثم أعِد تفعيلها.

     3. تأكَّد من أنّ حساب الخدمة [e-mail] موجود في مشروعك على Firebase ولديه دور وكيل خدمة Firebase Crashlytics.
        يمكنك التحقّق من ذلك في صفحة إدارة الهوية وإمكانية الوصول في وحدة تحكّم Google Cloud (احرص على وضع علامة في مربّع الاختيار تضمين عمليات منح الأدوار التي تقدّمها Google).

     4. أرسِل حدثَين على الأقل إلى Crashlytics وانتظِر بضع دقائق.

  4. إذا لم تظهر لك البيانات في الجدول في الوقت الفعلي، يُرجى التواصل مع فريق دعم Firebase.

---

مزايا بث التصدير إلى BigQuery

يتم تصدير البيانات تلقائيًا إلى BigQuery في عملية تصدير مجمّعة يومية. بالإضافة إلى ذلك، يمكنك بث بيانات Crashlytics وجلسات Firebase في الوقت الفعلي باستخدام ميزة BigQueryالبث. يمكنك استخدام البيانات المتدفقة لأي غرض يتطلّب بيانات مباشرة، مثل عرض المعلومات في لوحة بيانات مباشرة أو مشاهدة عملية طرح مباشرة أو مراقبة مشاكل التطبيق التي تؤدي إلى تنبيهات وسير عمل مخصّص.

ملاحظة: لا تتوفّر ميزة تصدير البث إذا كان مشروعك ضمن خطة أسعار Spark أو إذا كنت تستخدم BigQuery sandbox (إمكانية الوصول إلى BigQuery بدون تكلفة).

عند تفعيل ميزة التصدير المتواصل إلى BigQuery، ستتوفّر لك أيضًا جداول في الوقت الفعلي (بالإضافة إلى جداول الدفعات). سيتضمّن كلا النوعين من الجداول مخطط مجموعة البيانات نفسه، ولكن إليك بعض الاختلافات المهمة بين جداول المعالجة المجمّعة والجداول في الوقت الفعلي:

جدول الدُفعات	جدول "الوقت الفعلي"
يتم تصدير البيانات مرة واحدة يوميًا. يتم تخزين الأحداث بشكل دائم قبل كتابتها بشكل مجمّع إلى BigQuery. يمكن إعادة تعبئة البيانات لمدة تصل إلى 30 يومًا سابقًا*.	يتم تصدير البيانات في الوقت الفعلي. لا تتوفّر إمكانية ملء البيانات السابقة.

يُعدّ جدول الدفعات مثاليًا للتحليل طويل الأمد وتحديد المؤشرات بمرور الوقت، لأنّنا نخزّن الأحداث بشكل دائم قبل تسجيلها، ويمكن إعادة ملء الجدول بالبيانات السابقة لمدة تصل إلى 30 يومًا*. عندما نكتب البيانات في جدول الوقت الفعلي، نكتبها على الفور في BigQuery، ما يجعلها مثالية للوحات البيانات المباشرة والتنبيهات المخصّصة. يمكن دمج هذين الجدولين باستخدام طلب بحث ربط للاستفادة من مزايا كليهما.

بشكلٍ تلقائي، يبلغ وقت انتهاء صلاحية القسم في جدول الوقت الفعلي 30 يومًا. لمعرفة كيفية تعديل ذلك، راجِع مقالة ضبط تاريخ انتهاء صلاحية الأقسام في مستندات BigQuery.

^{* يمكنك الاطّلاع على تفاصيل حول إتاحة التعبئة في الترقية إلى البنية الأساسية الجديدة للتصدير.}

---

الأسعار وBigQuery sandbox

إذا كان مشروعك على Firebase ضمن خطة التسعير Spark بدون تكلفة، يمكنك استخدام BigQuery sandbox، الذي يوفّر إمكانية الوصول إلى BigQuery بدون تكلفة. للحصول على معلومات حول BigQuery ووضع الحماية وإمكاناتهما، يُرجى الاطّلاع على استخدام BigQuery في وضع الحماية.

إذا كان مشروعك على Firebase يستند إلى خطة أسعار Blaze "الدفع حسب الاستخدام"، يمكنك استخدام جميع ميزات BigQuery. يخضع استخدامك BigQuery لأسعار BigQuery، التي تشمل استخدامًا محدودًا بدون تكلفة.

---

الترقية إلى البنية الأساسية الجديدة للتصدير في BigQuery

في منتصف تشرين الأول (أكتوبر) 2024، أطلقت Crashlytics بنية أساسية جديدة لتصدير البيانات المجمّعة من Crashlytics إلى BigQuery.

• إذا فعّلت ميزة التصدير المجمّع بعد أكتوبر 2024، سيستخدم مشروعك على Firebase تلقائيًا البنية الأساسية الجديدة للتصدير. ليس عليك اتّخاذ أي إجراء.

• إذا فعّلت التصدير المجمّع قبل أو خلال أكتوبر 2024، راجِع المعلومات الواردة في "كيف يمكن الترقية إلى البنية الأساسية الجديدة للتصدير في BigQuery؟" لتحديد ما إذا كان عليك اتّخاذ أي إجراء.

---

ما هي الخطوات التالية؟

• راجِع أمثلة على طلبات بحث SQL.

• إنشاء لوحات بيانات مخصّصة باستخدام البيانات التي تم تصديرها وخدمات Google Cloud المختلفة، مثل Looker Studio

• مزيد من المعلومات عن مخطط مجموعة البيانات للبيانات التي يتم تصديرها