مراقبة نشاط 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 أو وحدة تحكّم 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

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

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