توضّح هذه الصفحة كيفية تتبُّع استخدامك Cloud Firestore ورصد المشاكل المحتملة في تطبيقك.
لوحة بيانات الاستخدام
استخدِم لوحات بيانات الاستخدام في وحدة تحكّم Google Cloud ووحدة تحكّم Firebase لعرض عمليات قراءة المستندات وكتابتها وحذفها بمرور الوقت.
التحكم في الدخول
تتطلّب لوحات بيانات الاستخدام إذن monitoring.timeSeries.list في Cloud IAM.
تمنح أدوار "مالك المشروع" و"محرّر المشروع" و"مُشاهد المشروع" هذا الإذن. يمكنك أيضًا منح هذا الإذن
من خلال دور Cloud Monitoring
أو دور مخصّص.
لوحة بيانات استخدام قاعدة البيانات
للاطّلاع على مقاييس الاستخدام لقاعدة بيانات Cloud Firestore، افتح صفحة الاستخدام الخاصة بقاعدة البيانات في "وحدة تحكّم Google Cloud".
في Google Cloud Console، انتقِل إلى صفحة قواعد البيانات.
اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.
في قائمة التنقّل، انقر على الاستخدام.
انقر على الرابط في الرسالة التي تظهر على الصفحة للاطّلاع على استخدام قاعدة البيانات.
لوحة بيانات استخدام قاعدة بيانات Cloud Firestore في Google Cloud Console."/>
لوحة بيانات الاستخدام المجمَّع
إذا كان مشروعك يتضمّن عدة قواعد بيانات Cloud Firestore، يمكنك الاطّلاع على مقاييس الاستخدام المجمّعة في Google Cloud Console أو وحدة تحكّم Firebase.
Google Cloud Console
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة استخدام المشروع.
الانتقال إلى استخدام مشروع Google Cloud
تعرض لوحة بيانات استخدام المشروع عمليات المستندات بمرور الوقت على النحو التالي:
لوحة بيانات استخدام مشروع Cloud Firestore في Google Cloud Console."/>
Firebase وحدة التحكّم
الانتقال إلى صفحة استخدام Cloud Firestore (وحدة تحكّم Firebase)
لوحة بيانات استخدام Cloud Firestore في وحدة تحكّم Firebase."/>
لوحة بيانات الاستخدام وتقارير الفوترة
تقدّم لوحات بيانات استخدام Cloud Firestore في وحدتَي تحكّم Firebase وCloud تقديرًا للاستخدام. ويمكن أن تساعدك في تحديد الارتفاعات المفاجئة في الاستخدام. ومع ذلك، فإنّ لوحة البيانات ليست عرضًا دقيقًا للعمليات التي يتم تحصيل رسوم مقابلها. من المحتمل أن يكون الاستخدام الذي يتم تحصيل رسوم مقابله أعلى. في جميع حالات التناقض، يكون لتقرير الفوترة الأولوية على لوحة بيانات الاستخدام.
تشمل العمليات التي تتسبّب في حدوث تناقضات بين لوحة بيانات الاستخدام والاستخدام الذي تتم فوترته ما يلي:
- عمليات الاستيراد والتصدير لا تظهر عمليات القراءة والكتابة التي يتم تنفيذها من خلال هذه العمليات في لوحة بيانات الاستخدام.
- عمليات الكتابة التي لا تنفّذ أي عملية وتتحقّق فقط تساهم عمليات الكتابة التي تتحقّق فقط من وجود مستند أو عدم وجوده في عمليات القراءة التي يتم تحصيل رسوم مقابلها، ولكنها تظهر على النحو التالي: `UPDATE_NOOP` و `DELETE_NOOP` على التوالي في لوحة بيانات استخدام عمليات الكتابة.
- عمليات الكتابة التي لا تؤدي إلى أي تغيير قد تظهر العمليات التي لا تؤدي إلى تغيير في قاعدة البيانات، مثل عملية تعديل لا تغيّر قيم الحقول أو عملية كتابة إلى مستند محذوف، في لوحة بيانات الاستخدام على أنّها `UPDATE_NOOP` أو `DELETE_NOOP`. وعلى الرغم من ظهورها على أنّها `NOOP`، إلا أنّها تساهم في العمليات التي يتم تحصيل رسوم مقابلها.
عمليات الكتابة المجمّعة في الحالات التي يتم فيها إجراء عمليات كتابة متعددة إلى المستند نفسه بتسلسل سريع، قد تجمع لوحة بيانات الاستخدام عمليات الكتابة المتعددة معًا وتحسبها كعملية واحدة. عند فوترة الاستخدام، سيظلّ يتم احتساب كل عملية كتابة بشكل منفصل.
تعمل لوحة بيانات الاستخدام أيضًا على تصغير عمليات الكتابة لتحويلات الحقول، مثل الطوابع الزمنية للخادم والزيادات الرقمية وعمليات اتحاد المصفوفات. بالنسبة إلى عمليات تحويل الحقول، قد تحتسب لوحة بيانات الاستخدام عمليات متعددة كعملية واحدة.
- طلبات البحث التي تعرض صفر نتيجة تتسبّب طلبات البحث التي تعرض صفر نتيجة في تكلفة عملية قراءة واحدة. يتم تحصيل رسوم مقابل هذا الاستخدام، ولكنّه لا يظهر في لوحة بيانات الاستخدام.
- عمليات القراءة من إدخالات الفهرس التي تمت قراءتها يتم تحصيل رسوم مقابل هذا الاستخدام، ولكنّه لا يظهر في لوحة بيانات الاستخدام. على سبيل المثال، يتم تحصيل رسوم من طلبات البحث الخاصة بالتجميع مقابل إدخالات الفهرس التي تتم قراءتها، ولكن لا يظهر هذا الاستخدام في لوحة بيانات الاستخدام.
لا تسجّل لوحة بيانات الاستخدام عمليات انتهاء الصلاحية التلقائية التي تنفّذها سياسات مدة البقاء (TTL). يُرجى الرجوع إلى مقاييس TTL من Cloud Monitoring.
استخدام قاعدة الأمان
بالإضافة إلى ذلك، توفّر "وحدة تحكّم Firebase" لوحة بيانات لتقييم "قواعد الأمان"، وهي تعرض نظرة عامة مفيدة وسريعة على عمليات استدعاء القواعد. يمكنك إضافة تحليل تفصيلي إلى لوحة البيانات هذه في Cloud Monitoring.
لوحة بيانات مراقبة "قواعد Cloud Firestore"
في Firebase console."/>
Cloud Monitoring مقياس
تجمع Cloud Monitoring المقاييس والأحداث والبيانات الوصفية من منتجات Google Cloud. تعرض لوحة بيانات الاستخدام في وحدة تحكّم Cloud Firestore بيانات المقاييس نفسها. لإعداد لوحات بيانات مخصّصة وتنبيهات بشأن الاستخدام، استخدِم Cloud Monitoring.
يتضمّن Cloud Monitoring مقاييس Cloud Firestore التالية:
| اسم المقياس | الوصف |
|---|---|
| قراءات المستندات |
عدد عمليات قراءة المستندات الناجحة. يمكنك تقسيم هذا المقياس حسب نوع القراءة: LOOKUP أو QUERY. لا يتضمّن هذا المقياس عمليات القراءة من عمليات التصدير المُدارة أو الحذف المجمّع. |
| عمليات الكتابة في المستندات |
عدد عمليات كتابة المستندات الناجحة. يمكنك تقسيم المقياس حسب نوع عملية الكتابة: CREATE أو UPDATE. لا يتضمّن هذا المقياس عمليات الكتابة من عمليات الاستيراد المُدارة. |
| عمليات حذف المستندات | عدد عمليات حذف المستندات الناجحة. |
| الاتصالات النشطة |
عدد الاتصالات النشطة بقاعدة البيانات. تحتفظ كل حزمة SDK نشطة للأجهزة الجوّالة والويب باتصال واحد يمكن مشاركته بين عدّة أدوات معالجة لبيانات اللقطات. تنشئ مكتبات برامج الخادم اتصالاً واحدًا لكل أداة معالجة لبيانات اللقطة. |
| أدوات معالجة اللقطات |
عدد المستمعين إلى اللقطات في جميع الاتصالات النشطة |
| عدد عمليات الحذف حسب مدة البقاء |
إجمالي عدد المستندات التي تم حذفها بموجب سياسات مدة البقاء (TTL) |
| تأخيرات الحذف بسبب انتهاء صلاحية الوقت المحدّد للبقاء |
الوقت المنقضي بين انتهاء صلاحية المستند بموجب سياسة مدة البقاء (TTL) ووقت حذفه فعليًا |
- استخدام التحديثات في الوقت الفعلي
استخدِم مقياسَي "عمليات الاستماع إلى اللقطات" و"عمليات الاستماع إلى الاتصالات النشطة" لقياس مدى استخدامك للتعديلات في الوقت الفعلي.
لنفترض أنّ أحد المستخدمين يفتح تطبيقك على هاتفه. بعد ذلك، يتصل التطبيق بـ Cloud Firestore ويشترك في 10 طلبات بحث. يؤدي ذلك إلى زيادة مقاييسك بمقدار اتصال نشط واحد و10 مستمعين للّقطات.
- معدّل أخذ العيّنات
يتم أخذ عيّنات من مقاييس Cloud Firestore كل دقيقة، ولكن قد يستغرق ظهور التعديلات في لوحات البيانات مدة تصل إلى 4 دقائق.
مقاييس وقت الاستجابة
تتوفّر مقاييس وقت الاستجابة في الخلفية من خلال مقاييس Google Cloud firestore الشائعة.
على سبيل المثال، يمكن العثور على رسم بياني لوقت الاستجابة p50 في طريقة عرض "مستكشف المقاييس" في Cloud Console.
إعداد Cloud Monitoring لوحة بيانات
للاطّلاع على لوحة بيانات محدّدة مسبقًا أو لإعداد لوحة بيانات، يُرجى الاطّلاع على استخدام لوحة بيانات المراقبة.