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