توضّح هذه الصفحة كيفية تتبُّع استخدام Cloud Firestore ورصد المشاكل المحتملة في تطبيقك.
لوحة بيانات الاستخدام
استخدِم لوحات بيانات الاستخدام في وحدة تحكّم Google Cloud ووحدة تحكّم Firebase لعرض عمليات قراءة المستندات وكتابتها وحذفها بمرور الوقت.
التحكم في الدخول
تتطلّب لوحات بيانات الاستخدام إذن monitoring.timeSeries.list في Cloud IAM.
تمنح أدوار "مالك المشروع" و"محرّر المشروع" و"مُشاهد المشروع" هذا الإذن. يمكنك أيضًا منح هذا الإذن من خلال دور Cloud Monitoring أو دور مخصّص.
لوحة بيانات استخدام قاعدة البيانات
للاطّلاع على مقاييس الاستخدام لقاعدة بيانات Cloud Firestore، افتح صفحة الاستخدام الخاصة بقاعدة البيانات في "وحدة تحكّم Google Cloud".
في Google Cloud Console، انتقِل إلى صفحة قواعد البيانات.
اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.
في قائمة التنقّل، انقر على الاستخدام.
انقر على الرابط في الرسالة التي تظهر على الصفحة للاطّلاع على استخدام قاعدة البيانات.
لوحة بيانات الاستخدام المجمَّع
إذا كان مشروعك يتضمّن عدّة Cloud Firestore قواعد بيانات، يمكنك الاطّلاع على مقاييس الاستخدام المجمّعة في وحدة تحكّم Google Cloud أو وحدة تحكّم Firebase.
Google Cloud Console
في Google Cloud Console، انتقِل إلى صفحة استخدام المشروع.
الانتقال إلى استخدام مشروع على السحابة الإلكترونية في Google Cloud
تعرض لوحة بيانات استخدام المشروع عمليات المستندات بمرور الوقت على النحو التالي:
وحدة تحكُّم Firebase
الانتقال إلى Cloud Firestore صفحة الاستخدام (وحدة تحكّم Firebase)
لوحة بيانات الاستخدام وتقارير الفوترة
تقدّم لوحات بيانات الاستخدام Cloud Firestore في وحدتَي تحكّم Firebase وCloud تقديرًا للاستخدام، ويمكن أن تساعدك في تحديد الارتفاعات المفاجئة في الاستخدام، ولكن لوحة البيانات لا تعرض العمليات التي تتم فوترتها بشكل دقيق، ومن المرجّح أن يكون الاستخدام الذي تتم فوترته أعلى. وفي جميع حالات التناقض، يكون لتقرير الفوترة الأولوية على لوحة بيانات الاستخدام.
تشمل العمليات التي تؤدي إلى حدوث تناقضات بين لوحة بيانات الاستخدام والاستخدام الذي تتم فوترته ما يلي:
- عمليات الاستيراد والتصدير لا تظهر عمليات القراءة والكتابة التي يتم تنفيذها من خلال هذه العمليات في لوحة بيانات الاستخدام.
- عمليات الكتابة التي لا تجري أي عملية (no-op) وتتحقّق فقط من وجود مستند أو عدم وجوده تساهم في عمليات القراءة التي يتم تحصيل رسوم مقابلها، ولكنها تظهر على النحو
UPDATE_NOOPوDELETE_NOOPعلى التوالي في لوحة بيانات استخدام عمليات الكتابة. - عمليات الكتابة غير الفعّالة قد تظهر العمليات التي لا تؤدي إلى تغيير في قاعدة البيانات، مثل عملية تعديل لا تغيّر قيم الحقول أو عملية كتابة في مستند محذوف، في لوحة بيانات الاستخدام على النحو
UPDATE_NOOPأوDELETE_NOOP. على الرغم من أنّها تظهر على أنّهاNOOP، إلا أنّها تساهم في العمليات التي يتم تحصيل رسوم مقابلها. عمليات الكتابة المجمّعة في الحالات التي يتم فيها إجراء عمليات كتابة متعددة إلى المستند نفسه بشكل متسلسل وسريع، قد تجمع لوحة بيانات الاستخدام عمليات الكتابة المتعددة معًا وتحسبها كعملية واحدة. عند فوترة الاستخدام، يتم احتساب كل عملية كتابة بشكل منفصل.
تؤدي لوحة بيانات الاستخدام أيضًا إلى تصغير عمليات الكتابة لتحويلات الحقول، مثل الطوابع الزمنية للخادم والزيادات الرقمية وعمليات اتحاد المصفوفات. بالنسبة إلى عمليات تحويل الحقول، قد تحتسب لوحة بيانات الاستخدام عمليات متعددة كعملية واحدة.
- طلبات البحث التي تعرض صفرًا من النتائج، وتتسبّب في تكلفة عملية قراءة واحدة، ويتم تحصيل رسوم مقابل هذا الاستخدام ولكنّه لا يظهر في لوحة بيانات الاستخدام.
- عمليات القراءة من إدخالات الفهرس التي تمت قراءتها يتم تحصيل رسوم مقابل هذا الاستخدام، ولكنّه لا يظهر في لوحة بيانات الاستخدام. على سبيل المثال، يتم تحصيل رسوم من طلبات البحث الخاصة بالتجميع مقابل إدخالات الفهرس التي تتم قراءتها، ولكن لا يظهر هذا الاستخدام في لوحة بيانات الاستخدام.
- طلبات لعرض معرّفات المجموعات. تعرض لوحة بيانات الاستخدام عملية قراءة واحدة لكل معرّف مجموعة، وهو ما يختلف عن الفوترة.
لا تسجّل لوحة بيانات الاستخدام عمليات انتهاء الصلاحية التلقائية التي تنفّذها سياسات مدة البقاء (TTL). يُرجى الرجوع إلى مقاييس مدة البقاء من Cloud Monitoring.
استخدام قاعدة الأمان
بالإضافة إلى ذلك، توفّر "وحدة تحكّم Firebase" لوحة بيانات لتقييم "قواعد الأمان في Firebase"، وهي تعرض نظرة عامة مفيدة وسريعة على عمليات استدعاء القواعد. يمكنك أيضًا مراقبة استخدام "قواعد الأمان" في Firebase من خلال Cloud Monitoring. يوفّر ذلك مقاييس تقييم القواعد نفسها، بالإضافة إلى إمكانية إنشاء لوحات بيانات مخصّصة وتحليل المؤشرات وإعداد التنبيهات (على سبيل المثال، عند ارتفاع عدد الطلبات المرفوضة). راجِع مرجع مقاييس Cloud Monitoring للاطّلاع على القائمة الكاملة بالمقاييس المتاحة.
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
للاطّلاع على لوحة بيانات محدّدة مسبقًا أو لإعداد لوحة بيانات، يُرجى الاطّلاع على استخدام لوحة بيانات المراقبة.