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

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

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

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

التحكّم في إمكانية الوصول

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

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

لعرض مقاييس الاستخدام لقاعدة بيانات Cloud Firestore، افتح صفحة الاستخدام في قاعدة البيانات ضمن "وحدة تحكُّم Google Cloud Platform".

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

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

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

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

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

    لوحة بيانات استخدام قاعدة بيانات Cloud Firestore في وحدة تحكّم Google Cloud Platform

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

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

وحدة تحكُّم Google Cloud Platform

في "وحدة تحكّم Google Cloud Platform"، انتقِل إلى صفحة استخدام المشروع.

الانتقال إلى استخدام مشروع Google Cloud Platform

تعرض لوحة معلومات استخدام المشروع عمليات المستندات بمرور الوقت على النحو التالي:

لوحة بيانات استخدام مشروع Cloud Firestore في "وحدة تحكّم Google Cloud Platform"

وحدة تحكُّم Firebase

الانتقال إلى صفحة استخدام Cloud Firestore (وحدة تحكُّم Firebase)

لوحة بيانات استخدام Cloud Firestore في "وحدة تحكُّم Firebase".

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

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

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

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

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

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

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

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

بالإضافة إلى ذلك، توفِّر وحدة تحكُّم Firebase لوحة بيانات لتقييم قواعد الأمان، وهي عبارة عن عرض مفيد وسريع لعمليات استدعاء القواعد. ويمكنك إضافة تحليل تفصيلي إلى لوحة البيانات هذه في Cloud Monitoring.

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

مراقبة قواعد Cloud Firestore
في وحدة تحكم Firebase.

مقاييس مراقبة السحابة الإلكترونية

تجمع خدمة Cloud Monitoring مقاييس وفعاليات وبيانات وصفية من منتجات Google Cloud. تعرض لوحة بيانات الاستخدام في وحدة تحكم Cloud Firestore بيانات المقاييس نفسها. لإعداد لوحات بيانات مخصّصة وتنبيهات استخدام، استخدِم "مراقبة السحابة الإلكترونية"

تتضمن مراقبة السحابة الإلكترونية مقاييس Cloud Firestore التالية:

اسم المقياس الوصف
قراءات المستندات

عدد ما تمت قراءة المستند بنجاح. يمكنك تقسيم هذا المقياس حسب نوع القراءة: LOOKUP أو QUERY.

ولا يشمل هذا المقياس قراءات من عمليات التصدير المُدارة.

عمليات كتابة المستندات

عدد المستندات الناجحة التي تمت كتابتها. ويمكنك تقسيم المقياس حسب نوع الكتابة: CREATE أو UPDATE.

ولا يشمل هذا المقياس عمليات الاستيراد من عمليات الاستيراد المُدارة.

عمليات حذف المستند عدد عمليات حذف المستندات بنجاح.
الاتصالات النشطة

عدد الاتصالات النشطة بقاعدة البيانات الخاصة بك.

تحتفظ كل حزمة SDK نشطة للأجهزة الجوّالة والويب باتصال واحد يمكن مشاركته مع العديد من المستمعين لللقطات. تنشئ مكتبات برامج الخادم اتصالاً واحدًا لكل أداة معالجة لقطة.

أدوات معالجة اللقطات

عدد أدوات معالجة اللقطات في جميع الاتصالات النشطة.

عدد عمليات الحذف المنقضية

إجمالي عدد المستندات التي تم حذفها بموجب سياسات مدة البقاء (TTL)

انتهاء صلاحية المدة المستغرَقة في تنفيذ عمليات الحذف

انقضى الوقت بين وقت انتهاء صلاحية مستند بموجب سياسة مدة البقاء (TTL) ووقت حذفه فعلاً.

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

استخدِم مقاييس أدوات معالجة البيانات النشطة واللقطات من أجل قياس استخدامك للتحديثات في الوقت الفعلي.

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

معدل العينات

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

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

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

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

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

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

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