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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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

بالإضافة إلى ذلك، توفّر وحدة تحكُّم Firebase لوحة بيانات لتقييم قواعد أمان Firebase، وهي عرض مفيد وسريع لعمليات استدعاء القواعد. يمكنك أيضًا تتبُّع استخدام قواعد أمان Firebase من خلال Cloud Monitoring. يوفّر ذلك مقاييس تقييم القواعد نفسها، بالإضافة إلى إمكانية إنشاء لوحات بيانات مخصّصة وتحليل الاتجاهات وإعداد التنبيهات (على سبيل المثال، عند ارتفاع الطلبات المرفوضة). اطّلِع على مرجع مقاييس Cloud Monitoring للحصول على القائمة الكاملة بالمقاييس المتاحة.

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

مقاييس Cloud Monitoring

Cloud Monitoring تجمع المقاييس والأحداث والبيانات الوصفية من منتجات Google Cloud. تسجِّل لوحة بيانات الاستخدام في Cloud Firestore Console بيانات المقاييس نفسها. لإعداد لوحات بيانات مخصّصة وتنبيهات بشأن الاستخدام، استخدِم Cloud Monitoring.

Cloud Monitoring يتضمّن مقاييس Cloud Firestore التالية:

اسم المقياس	الوصف
عمليات قراءة المستندات	عدد عمليات قراءة المستندات الناجحة. يمكنك تقسيم هذا المقياس حسب نوع القراءة: LOOKUP أو QUERY. لا يشمل هذا المقياس عمليات القراءة من عمليات التصدير المُدارة أو عمليات الحذف المجمَّع عمليات.
عمليات كتابة المستندات	عدد عمليات كتابة المستندات الناجحة. يمكنك تقسيم المقياس حسب نوع الكتابة: CREATE أو UPDATE. لا يشمل هذا المقياس عمليات الكتابة من عمليات الاستيراد المُدارة.
عمليات حذف المستندات	عدد عمليات حذف المستندات الناجحة.
الاتصالات النشطة	عدد الاتصالات النشطة بقاعدة البيانات. تحتفظ كل حزمة SDK نشطة للأجهزة الجوّالة والويب باتصال واحد يمكن مشاركته بين عدّة مستمعين للقطات. تنشئ مكتبات برامج الخادم اتصالاً واحدًا لكل مستمع للقطات.
مستمعو اللقطات	عدد مستمعي اللقطات على مستوى جميع الاتصالات النشطة.
عدد عمليات الحذف التي تتم بعد انتهاء مدة البقاء	العدد الإجمالي للمستندات التي تم حذفها من خلال سياسات مدة البقاء (TTL).
المهل الزمنية بين انتهاء صلاحية المستند وحذفه بعد انتهاء مدة البقاء	الوقت المنقضي بين انتهاء صلاحية مستند بموجب سياسة مدة البقاء (TTL) وحذفه فعليًا.

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

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

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

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

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

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

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

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

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

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

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

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