توضّح هذه الصفحة كيفية استخدام مقاييس Cloud Monitoring في Cloud Firestore لمراقبة قاعدة البيانات.
مقاييس Cloud Monitoring في Cloud Firestore
تقدّم الأقسام التالية نظرة عامة على المقاييس المتاحة في Cloud Firestore.
الموارد التي تتم مراقبتها
يمثّل المورد المراقَب في Cloud Monitoring كيانًا منطقيًا أو ماديًا، مثل آلة افتراضية أو قاعدة بيانات أو تطبيق. تحتوي الموارد التي تتم مراقبتها على مجموعة فريدة من المقاييس التي يمكن استكشافها أو الإبلاغ عنها من خلال لوحة بيانات أو استخدامها لإنشاء تنبيهات. يحتوي كل مورد أيضًا على مجموعة من تصنيفات الموارد، وهي أزواج من المفاتيح والقيم تحتوي على معلومات إضافية عن المورد. تتوفّر تصنيفات الموارد لجميع المقاييس المرتبطة بالمورد.
باستخدام الـ Cloud Monitoring API، يتم رصد الأداء Cloud Firestore باستخدام المورد التالي:
| Resources | الوصف |
firestore.googleapis.com/Database | نوع المورد الذي تتم مراقبته والذي يقدّم تفاصيل عن project وlocation وdatabase_id. |
المقاييس
للاطّلاع على قائمة كاملة بالمقاييس في Cloud Firestore، يُرجى الرجوع إلى مقالة Cloud Firestore metrics. يصف القسم التالي بعض المقاييس المتاحة.
مقاييس وقت تشغيل الخدمة
تقدّم 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 الخدمة. تشمل مقاييس وقت الاستجابة الوقت الذي تتلقّى فيه Cloud Firestore الطلب إلى الوقت الذي تنتهي فيه Cloud Firestore من إرسال الرد، بما في ذلك التفاعلات مع طبقة التخزين. نتيجةً لذلك، لا يتم تضمين وقت الاستجابة للرحلة الكاملة بين العميل وخدمة 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: عدد وحدات الكتابة القابلة للفوترة من خدمات الحذف المُدارة، مثل مدة البقاء.
مقاييس الفهرس
يمكن مقارنة معدّلات كتابة الفهرس بمقياس document/write_ops_count لفهم عدد عمليات الكتابة في الفهرس.
index/write_count: عدد عمليات كتابة الفهرس
مقاييس مدة البقاء (TTL)
تُستخدم مقاييس مدة البقاء لمقاييس Cloud Firestore لمراقبة تأثير سياسة مدة البقاء المفروضة.
document/ttl_deletion_count: إجمالي عدد المستندات التي حذفتها خدمات مدة البقاءdocument/ttl_expiration_to_deletion_delays: الوقت المنقضي بين انتهاء صلاحية مستند يتضمّن مدة بقاء ووقت حذفه فعليًا
عرض لوحات البيانات المحدّدة مسبقًا وإنشاء لوحات بيانات مخصّصة
Cloud Firestore تتيح لوحات بيانات محدّدة مسبقًا تستخدم مقاييس Cloud Monitoring. يمكنك أيضًا إنشاء لوحات بيانات مخصّصة.
عرض مقاييس استخدام قاعدة البيانات
افتح لوحات بيانات الاستخدام في Google Cloud Console للاطّلاع على عمليات قراءة المستندات وكتابتها وحذفها بمرور الوقت.
التحكم في الدخول
تتطلّب لوحات بيانات الاستخدام إذن "إدارة الهوية وإمكانية الوصول" (IAM) monitoring.timeSeries.list.
تمنح أدوار "مالك المشروع" و"محرِّر" و"مُشاهد" هذا الإذن. يمكنك أيضًا منح هذا الإذن
من خلال دور Cloud Monitoring
أو دور مخصّص.
لوحة بيانات استخدام قاعدة البيانات
للاطّلاع على مقاييس استخدام قاعدة بيانات Cloud Firestore، اتّبِع الخطوات التالية.
في Google Cloud Console، انتقِل إلى صفحة قواعد البيانات.
اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.
في قائمة التنقّل، انقر على الاستخدام.
لوحة بيانات الاستخدام وتقارير الفوترة
تقدّم لوحات بيانات الاستخدام في وحدة التحكّم تقديرًا للاستخدام.Cloud Firestore يمكن أن تساعدك في تحديد الارتفاعات المفاجئة في الاستخدام. ومع ذلك، لا تمثّل لوحة البيانات عرضًا دقيقًا للعمليات التي تم تحصيل رسومها. من المرجّح أن يكون الاستخدام الذي تم تحصيل رسومه أعلى. لمراقبة الفوترة، يُرجى الرجوع إلى مقالة مقاييس الفوترة.
في جميع حالات التناقض، يكون لتقرير الفوترة الأولوية على لوحة بيانات الاستخدام.
تؤدي عمليات الاستيراد والتصدير إلى حدوث تناقضات بين لوحة بيانات الاستخدام والاستخدام الذي تم تحصيل رسومه. لا تظهر عمليات القراءة والكتابة التي يتم إجراؤها من خلال هذه العمليات في لوحة بيانات الاستخدام.
عرض مقاييس أداء قاعدة البيانات
تتضمّن صفحة الرصد في قسم Cloud Firestore في Google Cloud Console لوحات بيانات رصد محدّدة مسبقًا، مثل أوقات استجابة الطلبات (النسبة المئوية 50 والنسبة المئوية 99) ورموز الاستجابة وإحصاءات طلبات البحث (النسبة المئوية 50). يمكنك أيضًا إنشاء لوحة بيانات مخصّصة واحدة كحد أقصى. للوصول إلى صفحة المراقبة لقاعدة بيانات، اتّبِع الخطوات التالية:
في Google Cloud Console، افتح صفحة Cloud Firestore قواعد البيانات.
اختَر قاعدة بيانات من القائمة.
في قائمة التنقّل، انقر على المراقبة لفتح لوحة بيانات.
إنشاء لوحات بيانات مخصّصة Cloud Monitoring
في Cloud Monitoring، تتيح لك لوحات البيانات المخصّصة عرض المعلومات ذات الصلة بطريقة منظَّمة. على سبيل المثال، يمكنك إنشاء لوحة بيانات لعرض مقاييس الأداء وسياسات التنبيه لمشروعك في بيئة التشغيل الفعلي.
لمزيد من المعلومات عن إعداد لوحة بيانات مخصّصة، يُرجى الرجوع إلى مقالتَي إدارة لوحة بيانات مخصّصة وإضافة أدوات لوحة البيانات.
إنشاء سياسة تنبيه
في Cloud Monitoring، يمكنك إنشاء تنبيهات لإعلامك عند حدوث تغيير في حالة المقياس. يمكنك استخدام هذه التنبيهات لإعلامك بالمشاكل المحتمَلة قبل أن تؤثر في المستخدمين.
لمزيد من المعلومات عن إنشاء التنبيهات، يُرجى الرجوع إلى مقالة إنشاء سياسات التنبيه المستندة إلى عتبة المقياس.
انظر المثال التالي الذي ننشئ فيه سياسة تنبيه بشأن وقت الاستجابة. تتحقّق سياسة التنبيه من وقت الاستجابة للنسبة المئوية 99 على مدى فترة زمنية متجدّدة مدتها 5 دقائق. إذا ظلّ وقت الاستجابة للنسبة المئوية 99 أعلى من 250 مللي ثانية لمدة 5 دقائق، يتم تفعيل التنبيه.
وحدة التحكم
في Google Cloud Console، انتقِل إلى صفحة المراقبة ، ثم انقر على notifications التنبيهات.
انقر على إنشاء سياسة.
اختَر مقياس أوقات استجابة الطلبات من مورد واجهة برمجة التطبيقات المستخدَمة.
أضِف فلتر خدمة لـ
firestore.googleapis.comلقواعد بيانات Firestore في الوضع الأصلي.انقر على التالي لضبط المشغِّل.
اختَر أنواع الشروط على أنّها العتبة.
يتم ضبط شرط العتبة على قيمة عتبة تبلغ 250 مللي ثانية. يتم تفعيل تنبيه عندما تظل قيمة وقت الاستجابة للنسبة المئوية 99 كما هي طوال فترة النافذة المتجدّدة (5 دقائق).
اضبط قيمة العتبة على 250.
انقر على التالي لضبط الإشعارات.
اضبط اسم سياسة التنبيه وانقر على التالي.
راجِع إعدادات التنبيه وانقر على إنشاء سياسة.
لغة طلبات البحث في Monitoring (MQL)
يمكنك تنفيذ سياسة التنبيه نفسها بشأن وقت الاستجابة باستخدام طلب بحث بلغة طلبات البحث في Monitoring (MQL). لمزيد من الأمثلة عن استخدام MQL، يُرجى الرجوع إلى مقالة أمثلة على طلبات بحث بلغة MQL.
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'