توضّح هذه الصفحة كيفية استخدام إحصاءات الاستخدام لتحليل استخدامك القابل للفوترة لقواعد بيانات معيّنة. يمكنك تقسيم هذه البيانات حسب سمات، مثل المجموعات أو مجموعات المجموعات أو مساحات الأسماء (خاصة بوضع Datastore) خلال فترة زمنية مخصّصة. تختلف مقاييس إحصاءات الاستخدام المعروضة استنادًا إلى الإصدار أو الوضع:
| الإصدار | المقاييس |
| عادي |
|
| للمؤسسات |
|
نظرة عامة على إحصاءات الاستخدام
استخدِم لوحة بيانات إحصاءات الاستخدام لمراقبة استخدام قواعد بيانات معيّنة. تساعدك لوحة البيانات هذه في ما يلي:
- مراقبة الاستخدام التفصيلي: يمكنك تتبُّع عملياتك القابلة للفوترة مقسّمة حسب سمات، مثل
collectionأوcollectionGroupأوnamespace. - تحسين التكاليف: يمكنك تحديد الاستخدام الذي يتم تحصيل رسوم عالية مقابله لتحديد الأماكن التي يمكنك فيها تحسين بنى البيانات أو طلبات البحث وخفض فاتورتك الإجمالية.
- تتبُّع المؤشرات السابقة: يمكنك مراقبة كيفية تغيُّر إحصاءات استخدامك القابل للفوترة خلال أُطر زمنية معيّنة.
الأدوار المطلوبة
للحصول على الإذن اللازم لعرض لوحة بيانات إحصاءات الاستخدام، اطلب من المشرف منحك دور عارض Datastore
(roles/datastore.viewer) في إدارة الهوية وإمكانية الوصول في مشروعك.
يحتوي هذا الدور المُعدّ مسبقًا على الإذن datastore.insights.get، وهو مطلوب لعرض لوحة بيانات إحصاءات الاستخدام.
قد تتمكّن أيضًا من الحصول على هذا الإذن باستخدام أدوار مخصّصة أو أدوار أخرى مُعدّة مسبقًا.
لوحة بيانات إحصاءات الاستخدام
تم تنظيم لوحة بيانات إحصاءات الاستخدام في قسمَين أساسيَين:
- إجمالي الاستخدام: يعرض المقاييس المجمّعة (عمليات القراءة وعمليات الكتابة وعمليات الحذف بعد انتهاء مدة البقاء (TTL)) لقاعدة البيانات بأكملها.
- الاستخدام حسب المجموعة: يعرض المقاييس مقسّمة حسب أفضل 100 سمة ويتم تجميعها حسب المجموعة أو مجموعة المجموعات أو مساحات الأسماء.
إجمالي الاستخدام والمقاييس حسب المجموعة
من المهم ملاحظة أنّ مجموع المقاييس في قسم "حسب المجموعة" قد لا يتطابق مع المقياس المعروض في قسم "إجمالي الاستخدام". هذا التباين متوقّع بسبب العوامل التالية:
- حدود "حسب المجموعة" (أفضل 100): يقتصر قسم "حسب المجموعة" على تفصيل الاستخدام لأفضل 100 مجموعة أو مجموعة مجموعات أو مساحات أسماء فقط. يساهم الاستخدام الناتج عن السمات الأقل نشاطًا في رقم "إجمالي الاستخدام"، ولكن لا يتم إدراجه بشكل فردي في مقاييس الاستخدام "حسب المجموعة".
- أخذ عيّنات للعمليات الواسعة: بالنسبة إلى الطلبات التي تؤثّر في عدد كبير من المجموعات (على سبيل المثال، عمليات الربط بين مجموعات متعددة أو
ListCollectionIdsأوListDocumentsأو طلبات البحث بدون نوع)، قد تأخذ إحصاءات الاستخدام عيّنات من المجموعات، مع منح الأولوية لتلك التي تسجّل أعلى معدّل استخدام. نتيجةً لذلك، لا يتم تضمين جميع المجموعات المتأثّرة في مقاييس الاستخدام "حسب المجموعة". الأسماء المحجوزة: Cloud Firestore يحجز أسماء تبدأ بعلامتَي تسطير سفليتين (__*__) للبيانات الوصفية الداخلية. يساهم الاستخدام المرتبط بهذه الأسماء المحجوزة في إجمالي الاستخدام، ولكن لا يتم تضمينه في مقاييس الاستخدام "حسب المجموعة".
السمات حسب المجموعة
ينظّم قسم "حسب المجموعة" مقاييس الاستخدام استنادًا إلى السمات التي تحدّدها واجهات برمجة التطبيقات المفعّلة:
- المجموعة: تكون متاحة عند تفعيل Cloud Firestore API.
- مجموعة المجموعات: تكون متاحة بشكل عام في جميع إعدادات واجهة برمجة التطبيقات.
بيانات إحصاءات الاستخدام
تعرض إحصاءات الاستخدام في Google Cloud Console بيانات مستمدة من طرق واجهة برمجة التطبيقات التالية:
queryTopAggregatedInsightsDataqueryTopTimeseriesInsightsData
اسم الحقل التفاصيل اسم المجموعة
اسم مجموعة المجموعاتالقيمة المقابلة لسمة الاستخدام التي يتم تجميع بيانات الاستخدام لها. يمكن أن يكون اسم مجموعة أو اسم مجموعة مجموعات إجمالي عمليات القراءة إجمالي عدد عمليات القراءة. ينطبق ذلك على الإصدار العادي فقط. إجمالي عمليات الكتابة إجمالي عدد عمليات الكتابة. يشمل ذلك عمليات الحذف أيضًا. ينطبق ذلك على الإصدار العادي فقط. إجمالي عمليات الحذف بعد انتهاء مدة البقاء (TTL) إجمالي عدد عمليات الحذف بعد انتهاء مدة البقاء (TTL). ينطبق ذلك على الإصدار العادي فقط. إجمالي عمليات القراءة إجمالي عدد وحدات القراءة المقسّمة (وحدات 4KiB). ينطبق ذلك على إصدار المؤسسات فقط. إجمالي عمليات الكتابة إجمالي عدد وحدات الكتابة المقسّمة (وحدات 1KiB). يشمل ذلك وحدات الحذف أيضًا. ينطبق ذلك على إصدار المؤسسات فقط. إجمالي عمليات الحذف بعد انتهاء مدة البقاء (TTL) أو عمليات الحذف المُدارة إجمالي عدد وحدات الحذف بعد انتهاء مدة البقاء (TTL) أو عمليات الحذف المُدارة. ينطبق ذلك على إصدار المؤسسات فقط. إجمالي وحدات Eventarc إجمالي عدد وحدات Eventarc. ينطبق ذلك على إصدار المؤسسات فقط. إجمالي وحدات البايت المقروءة إجمالي عدد وحدات البايت التي تم فحصها. إجمالي عدد المستندات التي تم فحصها إجمالي عدد المستندات التي تم فحصها. إجمالي عدد إدخالات الفهرس التي تم فحصها إجمالي عدد إدخالات الفهرس التي تم فحصها. إجمالي عدد المستندات المكتوبة إجمالي عدد المستندات المكتوبة. إجمالي عدد إدخالات الفهرس المكتوبة إجمالي عدد إدخالات الفهرس المكتوبة. إجمالي حجم المستند المكتوب إجمالي حجم كتابة المستند بالبايت. القيود
- لا يتم تتبُّع طلبات البحث المستمرة التي تساهم في عمليات القراءة والكتابة القابلة للفوترة كجزء من استجابة واجهة برمجة التطبيقات.
- لا تتوفّر إحصاءات الاستخدام لعمليات المشرف (التي تساهم في عمليات القراءة والكتابة القابلة للفوترة)، مثل عمليات الاستيراد/التصدير والحذف المجمّع والاستعادة والاستنساخ وعمليات إنشاء الفهارس في إصدار المؤسسات.
- لا تتوفّر الفوترة الخاصة بنقل البيانات على الشبكة والتخزين.
الأسعار
لا يتم تحصيل أي تكلفة إضافية مقابل إحصاءات الاستخدام.
عرض إحصاءات الاستخدام
لعرض إحصاءات الاستخدام لقاعدة بيانات Cloud Firestore، افتح لوحة إحصاءات الاستخدام الخاصة بقاعدة البيانات في Google Cloud Console.
في Google Cloud Console، انتقِل إلى صفحة قواعد البيانات.
من قائمة قواعد البيانات، اختَر قاعدة بيانات.
في قائمة التنقّل، انقر على إحصاءات الاستخدام.
استخدِم القائمة المنسدلة حسب المجموعة لعرض إحصاءات الاستخدام لمجموعة أو مجموعة مجموعات أو مساحة أسماء. يمكنك عرض بيانات إحصاءات الاستخدام لمدة تصل إلى آخر 45 يومًا.