توضّح هذه الصفحة كيفية استخدام لوحة بيانات "إحصاءات طلبات البحث" لرصد أداء طلبات البحث وتحليله.
نظرة عامة على إحصاءات طلبات البحث
استخدِم لوحة بيانات "إحصاءات طلبات البحث" لتتبُّع طلبات البحث ذات الصلة بالمقاييس. استنادًا إلى المقاييس، يمكنك تحديد طلبات البحث الأكثر استخدامًا وطلبات البحث التي تتسم بزمن استجابة طويل والتي قد تتطلّب تحسينًا. استخدِم لوحة بيانات "إحصاءات طلبات البحث" للمساعدة في ما يلي:
- تحسين أداء طلبات البحث: تحديد طلبات البحث التي تتسم بزمن استجابة طويل وقد تحتاج إلى تحسين
- إدارة تكلفة طلبات البحث: يمكنك اكتشاف طلبات البحث العالية التكلفة وتحسينها لخفض التكاليف.
- مراقبة إحصاءات طلبات البحث: تتبَّع إحصاءات طلبات البحث بمرور الوقت.
- اقتراحات الفهرسة: يمكنك تحديد الفهارس المركّبة غير المتوفّرة أو غير المثالية وإنشاء الفهارس المقترَحة مباشرةً من لوحة البيانات (إصدار Enterprise).
بيانات "إحصاءات طلبات البحث"
تتضمّن إحصاءات طلبات البحث بيانات من طرق واجهة برمجة التطبيقات التالية:
findaggregate
يمكنك عرض بيانات عن طلبات البحث التي تستخدم هذه الطرق لمشروع وقاعدة بيانات ومدة زمنية معيّنة تتراوح بين 10 دقائق و30 يومًا. يتم تسجيل بيانات طلبات البحث ذات البُنى المتكافئة ضمن طلب بحث واحد تمت تسويته.
تعرض ميزة "إحصاءات طلبات البحث" المعلومات التالية حول طلب البحث:
| نص طلب البحث الذي تم توحيده | بنية طلب البحث الممثَّلة في النص |
| عدد عمليات التنفيذ | عدد عمليات التنفيذ في الفترة الزمنية المحدّدة |
| تعداد الأخطاء | عدد الأخطاء في الفترة الزمنية المحدّدة |
| متوسط مدة التنفيذ (بالملي ثانية) | متوسط الوقت بالملي ثانية الذي استغرقته قاعدة البيانات لمعالجة طلب البحث |
| متوسط عدد النتائج المعروضة | عدد النتائج التي يعرضها طلب البحث تتضمّن النتائج المستندات ومعرّفات المجموعات والحِزم المجمّعة. |
| متوسط عدد المستندات التي تم مسحها ضوئيًا | عدد المستندات التي تم فحصها في طلب بحث |
| متوسط عدد إدخالات الفهرس التي تم فحصها | عدد إدخالات الفهرس التي تم فحصها لتنفيذ طلب البحث |
| التحميل حسب متوسط الوقت | بيانات للمساعدة في فلترة أهم طلبات البحث استنادًا إلى متوسط وقت الاستجابة |
| التحميل حسب إجمالي عمليات القراءة (القابلة للفوترة) | بيانات للمساعدة في فلترة أهم طلبات البحث استنادًا إلى إجمالي عمليات القراءة التي يتم تحصيل رسوم مقابلها |
| اقتراحات الفهرسة | الفهارس المركّبة المقترَحة والفهارس المستخدَمة والتأثير المقدَّر في أعباء العمل لطلبات البحث في قواعد بيانات Enterprise edition |
دقة البيانات والاحتفاظ بها
تعتمد دقة البيانات على المدة المحدّدة:
- مستوى التفاصيل 10 دقائق للفترات التي تصل إلى 4 أيام مضت
- دقة ساعة واحدة للفترات التي تصل إلى 30 يومًا مضت
الحد الأقصى للاحتفاظ بالبيانات في "إحصاءات طلبات البحث" هو 30 يومًا. يتم تخزين البيانات التي يتم تسجيلها كل 10 دقائق لمدة 4 أيام، والبيانات التي يتم تسجيلها كل ساعة لمدة 30 يومًا.
عرض "إحصاءات طلبات البحث"
وحدة تحكُّم Firebase
- لعرض إحصاءات طلبات البحث لقاعدة بيانات Cloud Firestore، افتح قاعدة البيانات إحصاءات طلبات البحث في وحدة تحكّم Google Cloud.
في وحدة تحكُّم Firebase، انتقِل إلى صفحة قاعدة بيانات Firestore.
- من قائمة قواعد البيانات، اختَر قاعدة بيانات.
- من قائمة علامات التبويب، انقر على إحصاءات طلبات البحث.
للعثور على أهم طلبات البحث استنادًا إلى وقت الاستجابة أو عدد عمليات القراءة، انقر على وقت الاستجابة أو عمليات القراءة.
اقتراحات الفهرسة
تحدّد اقتراحات الفهرسة في ميزة "إحصاءات طلبات البحث" تلقائيًا إعدادات الفهرس المركّب المفقودة أو غير المثالية لأشكال طلبات البحث التي يتم تنفيذها بشكل متكرّر في قواعد بيانات إصدار Firestore Enterprise.
في إصدار Firestore Enterprise، يمكن تنفيذ طلبات البحث حتى بدون مطابقة الفهارس المركّبة، ما قد يؤدي إلى بطء عمليات فحص المجموعة الكاملة أو عمليات الفرز في الذاكرة. تحلّل لوحة بيانات "إحصاءات طلبات البحث" إحصاءات تنفيذ طلبات البحث السابقة وتقترح فهارس مركّبة مستهدَفة لتحسين وقت استجابة طلبات البحث وتقليل المستندات الممسوحة ضوئيًا التي تتم فوترتها.
طريقة عمل اقتراحات الفهرسة
يقيّم مسار معالجة الدفعات بلا إنترنت بشكل دوري أهم طلبات البحث السابقة:
- تحليل بنية طلب البحث: يستخرج دالات المساواة والترتيب والنطاق من طلبات البحث التي يتم تنفيذها بشكل متكرر.
- إنشاء الفهارس المرشحة: يتم إنشاء تعريفات الفهارس المركّبة المحتملة باستخدام أساليب ترتيب الفهارس (المساواة > الترتيب > النطاق).
- تقييم المحسِّن: يتم إدخال الفهارس المرشحة في نموذج التكلفة الخاص بمحرك طلبات البحث لمقارنة تكاليف تنفيذ طلبات البحث الأساسية بخطط التنفيذ المفترضة التي تمت فهرستها.
- ترتيب تأثير أعباء العمل: يرتّب الفهارس المقترَحة في فئات التأثير
استنادًا إلى إجمالي التوفير المقدَّر في تكلفة أعباء العمل:
- عالية: تحوّل عمليات فحص المجموعات الكاملة إلى عمليات بحث انتقائية في الفهرس، ما يقلّل بشكل كبير من عمليات قراءة المستندات ووقت استجابة التنفيذ.
- MEDIUM: تلغي العمليات المكلفة، مثل الترتيب في الذاكرة، من خلال توفير نتائج فهرسة مرتبة مسبقًا.
- منخفض: يقدّم تحسينات بسيطة في البحث.
عرض الفهارس المقترَحة وإنشاؤها
لعرض الفهارس المقترَحة وإنشائها من وحدة تحكُّم Firebase، اتّبِع الخطوات التالية:في وحدة تحكُّم Firebase، انتقِل إلى صفحة قاعدة بيانات Firestore.
من قائمة قواعد البيانات، اختَر قاعدة بيانات إصدار Enterprise.
انقر على علامة التبويب إحصاءات طلبات البحث.
في جدول طلبات البحث، ابحث عن شكل طلب بحث يتضمّن اقتراحات وانقر على مراجعة الاقتراحات في الصف أو النافذة المنبثقة.
في مربّع حوار اقتراح الفهرس، راجِع تعريف الفهرس المركّب وترتيب الحقول وفئة التأثير المقدَّر في عبء العمل (مرتفع أو متوسط أو منخفض).
انقر على حفظ. يتم فتح لوحة العمليات الطويلة (LRO) لتتبُّع مستوى تقدّم عملية إنشاء الفهرس.
بعد اكتمال عملية الإنشاء، يتم إدراج الفهرس ضمن علامة التبويب الفهارس، ويختفي مؤشر الاقتراح من صف طلب البحث.
الإصدارات المتوافقة
لا تتوفّر اقتراحات الفهرسة إلا لقواعد بيانات Firestore Enterprise. قواعد بيانات الإصدار العادي غير متوافقة.
القيود
- تتأخر بيانات إحصاءات طلبات البحث لمدة تتراوح بين ساعة وساعتين.
- يتم إنشاء اقتراحات الفهرسة بشكل دوري استنادًا إلى بيانات طلبات البحث السابقة، وليس في الوقت الفعلي.
- تقترح اقتراحات الفهرسة فهارس مركّبة جديدة، ولا تقترح تعديل الفهارس الحالية أو حذفها.
- لا يتوفّر إنشاء الفهارس تلقائيًا، لذا يجب إنشاء الفهارس المقترَحة يدويًا.
- تستبدل عملية تسوية طلبات البحث القيم الحرفية بعناصر نائبة. تستند اقتراحات الفهرس إلى نماذج طلبات البحث التي تمّت تسويتها بدلاً من قيم وقت التشغيل المحدّدة.
- يستخدم تقييم التكلفة أساليب إرشادية بدلاً من تحليل عينات البيانات المباشرة. قد لا تؤدي الفهارس المقترَحة إلى تحسين الأداء في كل سيناريو، ويؤدي إنشاء فهرس إلى زيادة أعباء الكتابة والتخزين.
الأسعار
لا تترتب أي تكلفة إضافية على استخدام ميزة "إحصاءات طلبات البحث" أو اقتراحات الفهرسة.
الأدوار المطلوبة
للحصول على الأذونات التي تحتاج إليها لعرض لوحة بيانات "إحصاءات طلبات البحث" وإنشاء الفهارس المقترَحة، اطلب من المشرف منحك أدوار "إدارة الهوية وإمكانية الوصول" التالية في مشروعك:
- لعرض "إحصاءات طلبات البحث":
Datastore Viewer
(
roles/datastore.viewer) - لإنشاء الفهارس المقترَحة:
مشرف فهرس مخزن البيانات
(
roles/datastore.indexAdmin) أو مالك Cloud Datastore (roles/datastore.owner)
تتضمّن هذه الأدوار المحدّدة مسبقًا الإذنَين datastore.insights.get وdatastore.indexes.create.
قد تتمكّن أيضًا من الحصول على هذه الأذونات من خلال الأدوار المخصّصة أو الأدوار الأخرى المحدّدة مسبقًا.