مراقبة نشاط Cloud Firestore

توضّح هذه الصفحة كيفية رصد استخدامك Cloud Firestore و رصد المشاكل المحتمَلة في تطبيقك.

لوحة بيانات الاستخدام

استخدِم لوحات بيانات الاستخدام في وحدة تحكّم Google Cloud ووحدة تحكّم Firebase للاطّلاع على عمليات قراءة المستندات وكتابتها وحذفها بمرور الوقت.

التحكم في الدخول

تتطلّب لوحات بيانات الاستخدام إذن monitoring.timeSeries.list Cloud IAM. يمنح دور "مالك المشروع" و"المحرِّر" و"المُشاهد" هذا الإذن. يمكنك أيضًا منح هذا الإذن من خلال دور Cloud Monitoring أو دور مخصّص.

لوحة بيانات استخدام قاعدة البيانات

للاطّلاع على مقاييس الاستخدام لقاعدة بيانات Cloud Firestore، افتح صفحة الاستخدام في قاعدة البيانات في وحدة تحكّم Google Cloud.

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

    الانتقال إلى قواعد البيانات

  2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

  3. في قائمة التنقّل، انقر على الاستخدام.

  4. انقر على الرابط في الرسالة التي تظهر على الصفحة للاطّلاع على استخدام قاعدة البيانات.

    ‎ <span class=لوحة بيانات استخدام قاعدة بيانات Cloud Firestore في وحدة تحكّم Google Cloud"/>

لوحة بيانات الاستخدام المجمَّع

إذا كان مشروعك يتضمّن قواعد بيانات Cloud Firestore متعددة، يمكنك الاطّلاع على مقاييس الاستخدام المجمّعة في Google Cloud Console أو وحدة تحكّم Firebase.

Google Cloud Console

في Google Cloud Console، انتقِل إلى صفحة استخدام المشروع.

الانتقال إلى صفحة "استخدام مشروع Google Cloud"

تعرض لوحة بيانات استخدام المشروع عمليات المستندات بمرور الوقت على النحو التالي:

‎ <span class=لوحة بيانات استخدام مشروع Cloud Firestore في وحدة تحكّم Google Cloud."/>

وحدة تحكّم Firebase

الانتقال إلى صفحة استخدام Cloud Firestore (وحدة تحكّم Firebase)

‎ <span class=لوحة بيانات استخدام Cloud Firestore في وحدة تحكّم Firebase."/>

لوحة بيانات الاستخدام وتقارير الفوترة

تقدّم لوحات بيانات استخدام Cloud Firestore في وحدات تحكّم Firebase وCloud Console تقديرًا للاستخدام. ويمكن أن تساعدك في تحديد الارتفاعات في معدّل الاستخدام. ومع ذلك، لا تقدّم لوحة البيانات عرضًا دقيقًا للعمليات التي يتمّ تحصيل رسومها. من المرجّح أن يكون الاستخدام الذي تمّت فوترته أعلى. في جميع حالات الاختلاف، يُمنَح تقرير الفوترة الأولوية على لوحة بيانات الاستخدام.

تشمل العمليات التي تؤدي إلى حدوث تناقضات بين لوحة بيانات الاستخدام ومقدار الاستهلاك الذي تمّت فوترته ما يلي:

  • عمليات الاستيراد والتصدير عمليات القراءة والكتابة التي تُجريها هذه العمليات لا تظهر في لوحة بيانات الاستخدام.
  • عمليات الكتابة التي لا تؤدي إلى أي إجراء، وتكون مخصّصة للتحقّق فقط تساهم عمليات الكتابة التي تتحقّق فقط من وجود مستند أو عدم وجوده في عمليات القراءة التي يتم تحصيل رسومها، ولكن يتم عرضها باسم UPDATE_NOOP وDELETE_NOOP على التوالي في لوحة بيانات استخدام الكتابة.
  • عمليات الكتابة بدون إجراء قد تظهر العمليات التي لا تؤدي إلى تغيير في قاعدة البيانات، مثل التعديل الذي لا يغيّر قيم الحقول أو الكتابة في مستند محذوف، في لوحة بيانات الاستخدام على أنّها UPDATE_NOOP أو DELETE_NOOP. ومع أنّها تظهر على أنّها NOOP، فإنّها تساهم في العمليات التي يتمّ تحصيل رسومها.
  • عمليات الكتابة المصغّرة في الحالات التي تتضمّن عمليات كتابة متعددة للمستند نفسه بشكلٍ متتابعٍ سريع، قد تُدمج لوحة بيانات الاستخدام عمليات الكتابة المتعدّدة معًا وتحتسبها كعملية واحدة. عند احتساب الاستخدام في الفوترة، لا يزال يتم احتساب كل عملية كتابة بشكل منفصل.

    تُجمِّع لوحة بيانات الاستخدام أيضًا عمليات الكتابة لعمليات تحويل الحقول، مثل الطوابع الزمنية للخادم والعمليات الحسابية الرقمية وعمليات دمج الصفائف. بالنسبة إلى عمليات تحويل الحقول، قد تحتسب لوحة بيانات الاستخدام عمليات متعدّدة كعملية واحدة.

  • طلبات البحث التي لا تعرض أي نتائج تُكبِّد طلبات البحث التي لا تتضمّن أي نتائج تكلفة عملية قراءة واحدة. ويتم تحصيل رسوم مقابل هذا الاستخدام، ولكن لا يظهر في لوحة بيانات الاستخدام.
  • عمليات القراءة من إدخالات الفهرس المقروءة ويتم تحصيل رسوم مقابل هذا الاستخدام، ولكنه لا يظهر في لوحة بيانات الاستخدام. على سبيل المثال، يتم تحصيل رسوم من طلبات البحث التجميعية مقابل إدخالات الفهرس التي تتم قراءتها، ولكن لا يظهر هذا الاستخدام في لوحة بيانات الاستخدام.

لا تُسجِّل لوحة بيانات الاستخدام للعمليات التي تم حذفها عمليات انتهاء الصلاحية التلقائية التي تنفّذها سياسات "المدة التي تظل فيها البيانات صالحة". يُرجى الرجوع إلى مقاييس TTL من Cloud Monitoring.

استخدام قاعدة الأمان

بالإضافة إلى ذلك، توفّر "وحدة تحكّم Firebase" لوحة تحكم تقييم قواعد الأمان، وهي عرض مفيد وسريع للاطّلاع على عمليات استدعاء القواعد. يمكنك إضافة تحليل تفصيلي في Cloud Monitoring إلى لوحة البيانات هذه.

الانتقال إلى "القواعد"

<span class=لوحة بيانات مراقبة <span class=قواعد Cloud Firestore في وحدة تحكّم Firebase."/>

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

للاطّلاع على لوحة بيانات محدّدة مسبقًا أو لإعداد لوحة بيانات، اطّلِع على استخدام لوحة بيانات المراقبة.

الخطوات التالية