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

توضّح هذه الصفحة كيفية استخدام مقاييس Cloud Monitoring في Cloud Firestore لتتبُّع قاعدة البيانات.

Cloud Monitoring مقاييس Cloud Firestore

تقدّم الأقسام التالية نظرة عامة على المقاييس المتاحة في Cloud Firestore.

الموارد الخاضعة للمراقبة

يمثّل المورد المراقَب في Cloud Monitoring كيانًا منطقيًا أو ماديًا، مثل آلة افتراضية أو قاعدة بيانات أو تطبيق. تحتوي الموارد الخاضعة للمراقبة على مجموعة فريدة من المقاييس التي يمكن استكشافها أو إعداد تقارير عنها من خلال لوحة بيانات أو استخدامها لإنشاء تنبيهات. يحتوي كل مورد أيضًا على مجموعة من تصنيفات الموارد، وهي أزواج مفتاح/قيمة تتضمّن معلومات إضافية حول المورد. تتوفّر تصنيفات الموارد لجميع المقاييس المرتبطة بالموارد.

باستخدام واجهة برمجة التطبيقات Cloud Monitoring، تتم مراقبة أداء Cloud Firestore باستخدام المرجع التالي:

المقاييس

للاطّلاع على القائمة الكاملة بمقاييس Cloud Firestore، راجِع مقاييس Cloud Firestore. يوضّح القسم التالي بعض المقاييس المتاحة.

مقاييس وقت تشغيل الخدمة

تقدّم مقاييس serviceruntime نظرة عامة عالية المستوى على عدد زيارات المشروع. تتوفّر هذه المقاييس لمعظم واجهات برمجة التطبيقات Google Cloud. يحتوي نوع المورد المراقَب consumed_api على هذه المقاييس الشائعة. يتم أخذ عيّنات من هذه المقاييس كل 30 دقيقة، ما يؤدي إلى تسوية البيانات.

تصنيف الموارد المهم لمقاييس serviceruntime هو method. يمثّل هذا التصنيف طريقة RPC الأساسية التي يتم استدعاؤها. قد لا يكون اسم طريقة حزمة SDK التي تستدعيها مطابقًا لاسم طريقة RPC الأساسية. والسبب في ذلك هو أنّ حزمة SDK توفّر تجريدًا عالي المستوى لواجهة برمجة التطبيقات. ومع ذلك، عند محاولة فهم كيفية تفاعل تطبيقك مع Cloud Firestore، من المهم فهم المقاييس استنادًا إلى اسم طريقة RPC.

إذا كنت بحاجة إلى معرفة طريقة RPC الأساسية لطريقة معيّنة في حزمة SDK، يمكنك الاطّلاع على مستندات واجهة برمجة التطبيقات.

api/request_latencies

يوفّر مقياس api/request_latencies توزيعات وقت الاستجابة على مستوى جميع الطلبات المكتملة.

تسجّل Cloud Firestore المقاييس من مكوّن Cloud Firestore Service. تشمل مقاييس وقت الاستجابة الوقت الذي يتلقّى فيه Cloud Firestore الطلب إلى الوقت الذي ينتهي فيه Cloud Firestore من إرسال الرد، بما في ذلك التفاعلات مع طبقة التخزين. نتيجةً لذلك، لا يتم تضمين وقت الاستجابة الكاملة (RTT) بين العميل وخدمة Cloud Firestore في هذه المقاييس.

مقاييس عمليات المستندات

تقدّم Cloud Firestore عدد عمليات القراءة والكتابة والحذف. يوفّر مقياس الكتابة تفصيلاً بين عمليتَي "إنشاء" و"تعديل". تتوافق هذه المقاييس مع عمليات CRUD.

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

• document/delete_ops_count: عدد عمليات حذف المستندات التي تمت بنجاح.
• document/read_ops_count: عدد عمليات قراءة المستندات الناجحة من طلبات البحث أو عمليات البحث.
• document/write_ops_count: عدد عمليات الكتابة الناجحة للمستندات

مقاييس الفوترة

استخدِم هذه المقاييس لفهم استخدام الفوترة. لا تتضمّن هذه المقاييس الفوترة الناتجة من عمليات المشرف (الفهرسة والاستيراد والتصدير والحذف المجمّع).

• api/billable_read_units: عدد وحدات القراءة القابلة للفوترة. يمكن تقسيم الاستخدام حسب اسم الخدمة وطريقة استخدام واجهة برمجة التطبيقات.
• ‫api/billable_realtime_read_units: عدد وحدات التحديث في الوقت الفعلي القابلة للفوترة من التحديثات في الوقت الفعلي ينطبق ذلك على Cloud Firestore في "الوضع الأصلي" فقط.
• api/billable_write_units: عدد وحدات الكتابة القابلة للفوترة يمكن تقسيم الاستخدام حسب اسم الخدمة وطريقة استخدام واجهة برمجة التطبيقات.
• document/billable_managed_delete_write_units: عدد وحدات الكتابة القابلة للفوترة من خدمات الحذف المُدارة، مثل TTL.

مقاييس الفهرسة

يمكن مقارنة معدّلات كتابة الفهرس بالمقياس document/write_ops_count لفهم مدى انتشار الفهرس.

• index/write_count: عدد عمليات كتابة الفهرس

مقاييس مدة البقاء (TTL)

تُستخدَم مقاييس TTL لمقاييس Cloud Firestore من أجل تتبُّع تأثير سياسة TTL المفروضة.

• document/ttl_deletion_count: إجمالي عدد المستندات التي حذفتها الخدمات التي تستخدم قيمة TTL.
• ‫document/ttl_expiration_to_deletion_delays: الوقت المنقضي بين انتهاء صلاحية مستند يتضمّن مدة بقاء (TTL) ووقت حذفه فعليًا.

عرض لوحات البيانات المحدّدة مسبقًا وإنشاء لوحات بيانات مخصّصة

تتيح Cloud Firestore لوحات بيانات محدَّدة مسبقًا تستخدم مقاييس Cloud Monitoring. يمكنك أيضًا إنشاء لوحات بيانات مخصّصة.

عرض مقاييس استخدام قاعدة البيانات

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

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

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

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

للاطّلاع على مقاييس الاستخدام لقاعدة بيانات Cloud Firestore، اتّبِع الخطوات التالية.

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

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

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

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

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

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

في جميع حالات التناقض، يكون لتقرير الفوترة الأولوية على لوحة بيانات الاستخدام.

تتسبّب عمليات الاستيراد والتصدير في حدوث اختلافات بين لوحة بيانات الاستخدام والاستخدام الذي تتم فوترته. لا تظهر عمليات القراءة والكتابة التي يتم تنفيذها من خلال هذه العمليات في لوحة بيانات الاستخدام.

عرض مقاييس أداء قاعدة البيانات

تتضمّن صفحة الرصد في القسم Cloud Firestore من وحدة تحكّم Google Cloud لوحات بيانات رصد محدّدة مسبقًا، مثل مدد الاستجابة للطلبات (P50 وP99) ورموز الاستجابة وإحصاءات طلب البحث (P50). يمكنك أيضًا إنشاء لوحة بيانات مخصّصة واحدة كحدّ أقصى. للوصول إلى صفحة المراقبة لقاعدة بيانات، اتّبِع الخطوات التالية:

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

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

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

3. في قائمة التنقّل، انقر على المراقبة لفتح لوحة بيانات.

إنشاء لوحات بيانات Cloud Monitoring مخصّصة

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

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

إنشاء سياسة تنبيه

في Cloud Monitoring، يمكنك إنشاء تنبيهات لإعلامك عند حدوث تغيير في حالة أحد المقاييس. يمكنك استخدام هذه التنبيهات لتلقّي إشعارات بشأن المشاكل المحتملة قبل أن تؤثر في تجربة المستخدمين.

لمزيد من المعلومات حول إنشاء التنبيهات، راجِع إنشاء سياسات تنبيه بشأن حدود المقاييس.

اطّلِع على المثال التالي الذي ننشئ فيه سياسة تنبيه بشأن وقت الاستجابة. تتحقّق سياسة التنبيه من وقت الاستجابة p99 خلال فترة زمنية متحرّكة مدتها 5 دقائق. إذا ظلّ وقت الاستجابة عند النسبة المئوية 99 أعلى من 250 ملي ثانية لمدة 5 دقائق، سيتم تشغيل التنبيه.

fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
    [value_request_latencies_percentile:
      percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'