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

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

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

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

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

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

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

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

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

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

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

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

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

   لوحة بيانات استخدام قاعدة بيانات Cloud Firestore في Google Cloud Console."/>

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

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

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

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

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

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

• عمليات الكتابة المجمَّعة: في الحالات التي تتضمّن عمليات كتابة متعدّدة في المستند نفسه بتسلسل سريع، قد تجمع لوحة بيانات الاستخدام عمليات كتابة متعدّدة معًا وتحتسبها كعملية واحدة. عند تحصيل رسوم الاستخدام، يتم احتساب كل عملية كتابة على حدة.

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

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

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

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

بالإضافة إلى ذلك، يوفّر Firebase لوحة بيانات تقييم قواعد أمان Firebase، وهي عرض مفيد وسريع لعمليات استدعاء القواعد. يمكنك أيضًا مراقبة استخدام قواعد أمان Firebase من خلال Cloud Monitoring. يوفّر ذلك مقاييس تقييم القواعد نفسها، بالإضافة إلى إمكانية إنشاء لوحات بيانات مخصّصة وتحليل الاتجاهات وإعداد التنبيهات (على سبيل المثال، عند ارتفاع الطلبات المرفوضة). راجِع مرجع مقاييس 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).
المهلات بين انتهاء صلاحية المستند وحذفه حسب مدة البقاء (TTL)	الوقت المنقضي بين انتهاء صلاحية مستند بموجب سياسة مدة البقاء (TTL) وحذفه فعليًا

استخدام التعديلات في الوقت الفعلي

استخدِم مقياسَي الاتصالات النشطة ومستمعي اللقطات لقياس استخدامك للتعديلات في الوقت الفعلي.

لنفترض أنّ أحد المستخدمين يفتح تطبيقك على هاتفه. يتصل التطبيق بعد ذلك بـ Cloud Firestore ويشترك في 10 طلبات بحث. يؤدي ذلك إلى زيادة مقاييسك بمقدار اتصال نشط واحد و10 مستمعين للقطات.

معدّل البيانات في الملف الصوتي

يتم أخذ عينات من مقاييس Cloud Firestore كل دقيقة، ولكن قد تستغرق التعديلات مدة تصل إلى 4 دقائق لتظهر في لوحات البيانات.

مقاييس وقت الاستجابة

تتوفّر مقاييس وقت استجابة الخادم من خلال مقاييس Google Cloud Firestore الشائعة.

على سبيل المثال، يمكن العثور على رسم بياني لوقت الاستجابة في المئوي الخامسين p50 latency في عرض مستكشف المقاييس في Cloud Console.

إعداد لوحة بيانات Cloud Monitoring

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

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

• مزيد من المعلومات عن Cloud Monitoring.
• التعرّف على أفضل الممارسات لمراقبة أداء Firestore.