نظرة عامة على Key Visualizer

تقدّم هذه الصفحة نظرة عامة حول أداة "محلّل الأداء الرئيسي" لتشخيص المشاكل في Cloud Firestore.

ما هي أداة Key Visualizer؟

‫Key Visualizer هي أداة تساعدك في تحليل أنماط الاستخدام Cloud Firestore. تنشئ هذه الميزة تقارير مرئية تحلّل استخدامك استنادًا إلى المستندات التي تصل إليها أو إدخالات الفهرس التي تتم كتابتها أو حذفها عند تعديل المستندات.

يمكن أن يقدّم Key Visualizer إحصاءات حول أنماط الاستخدام على نطاق واسع. تشمل استخدامات Key Visualizer ما يلي:

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

لتحقيق هذه الأهداف، يمكن أن يساعدك Key Visualizer في إكمال المهام التالية:

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

أهلية استخدام ميزة "المسح الضوئي"

تغطي كل عملية فحص في Key Visualizer فترة ساعتين. يتوفّر فحص لفترة زمنية محدّدة لقواعد البيانات التي تتضمّن عددًا من عمليات المستندات يتجاوز 3,000 عملية في أي دقيقة خلال تلك الفترة.

تعتمد أهلية الفحص بشكل كامل على نشاط قاعدة البيانات. ولا يعتمد ذلك على مقدار البيانات أو نوع البيانات في قاعدة البيانات.

عمليات فحص Key Visualizer

تعرض الصورة التالية عملية فحص باستخدام أداة Key Visualizer. يتضمّن كل فحص خريطة حرارية تعرض أنماط الوصول أو مقاييس الأداء لمجموعة من مفاتيح المستندات أو مفاتيح الفهرس بمرور الوقت.

مثال على عملية فحص Key Visualizer

مشاركة عناوين URL التي تم فحصها

يمكنك مشاركة عنوان URL لعملية فحص Key Visualizer أو وضع إشارة مرجعية عليه. سيفتح عنوان URL عملية الفحص نفسها في Key Visualizer ويختار المقياس نفسه. يكون عنوان URL هذا صالحًا إلى أن تنتهي صلاحية مدة بيانات الفحص.

خرائط التمثيل اللوني

إنّ أساس عملية فحص Key Visualizer هو خريطة الحرارة التي تعرض قيمة مقياس معيّن بمرور الوقت، مقسّمة إلى ما يصل إلى 1,000 حزمة رئيسية متجاورة.

في خريطة التمثيل اللوني لمفاتيح المستندات، يمثّل المحور س الوقت، بينما يمثّل المحور ص مفاتيح المستندات. أما في خريطة التمثيل اللوني لمفاتيح الفهرس، فيمثّل المحور س الوقت، بينما يمثّل المحور ص مفاتيح الفهرس.

يغطّي كل فحص باستخدام أداة Key Visualizer لمدة Cloud Firestore ساعتين من النشاط مقسّمة إلى مقاطع مدة كل منها 10 ثوانٍ.

تُعدّ القيمة المنخفضة لمقياس ما "باردة" وتظهر بلون داكن. تشير القيمة المرتفعة إلى أنّ المقياس "ساخن"، ويظهر بلون ساطع. تظهر أعلى القيم باللون الأبيض.

تؤدي الأنواع المختلفة من الاستخدام إلى أنماط مرئية مختلفة ضمن خريطة التمثيل اللوني، ما يتيح تشخيص المشاكل بنظرة سريعة. اطّلِع على أنماط الخريطة الحرارية لمفاتيح المستندات أو أنماط الخريطة الحرارية لمفاتيح الفهرس للاطّلاع على أمثلة على بعض الأنماط الشائعة.

توفّر أداة Key Visualizer أدوات لمساعدتك في فهم البيانات في كل عملية فحص. راجِع بدء استخدام Key Visualizer واستكشاف الخرائط الحرارية.

مجموعات البيانات الرئيسية

يقسّم Key Visualizer جميع المفاتيح في قاعدة البيانات إلى ما يصل إلى 1,000 نطاق متجاور، مع عدد متساوٍ تقريبًا من المفاتيح وعمليات الإدخال/الإخراج في الثانية في كل نطاق. تُعرف هذه النطاقات باسم المجموعات الرئيسية.

تستخدم أداة Key Visualizer إجمالي عدد العمليات في الثانية لقاعدة بيانات من أجل تقسيم مجموعات المفاتيح، بحيث تسجّل كل مجموعة عددًا مماثلاً تقريبًا من العمليات في الثانية، مع تحديد حجم مستهدف لا يقل عن 50 عملية في الثانية لكل مجموعة مفاتيح. بالنسبة إلى قواعد البيانات التي يبلغ إجمالي عدد العمليات في الثانية فيها أكثر من 50 عملية، يمكن أن تستوعب حِزم المفاتيح أكثر من 50 عملية في الثانية لكل منها. تؤدي قواعد البيانات التي تقلّ فيها العمليات في الثانية عن 50 عملية إلى إجراء عمليات فحص باستخدام مجموعة مفاتيح واحدة.

تعرض أداة Key Visualizer معظم المقاييس كمتوسطات لكل مجموعة مفاتيح، أو كقيم قصوى ضمن كل مجموعة مفاتيح.

المقاييس

تتوفّر المقاييس التالية لمفاتيح المستندات في عمليات فحص Key Visualizer:

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

يتوفّر المقياس التالي لمفاتيح الفهرس في عمليات فحص Key Visualizer:

المقاييس الوصف
عمليات الكتابة في الفهرس في الثانية متوسط عدد عمليات كتابة الفهرس في الثانية

متوسطات الأداء

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

الحدود

على الرغم من أنّ أداة Key Visualizer تعرض مجموعة متنوعة من المقاييس، إلا أنّها لا تعرض كل مقياس فردي يمكن أن يؤثر في أداء Cloud Firestore. على سبيل المثال:

  • قد لا تظهر مشاكل الشبكة بين تطبيقك وGoogle Cloud. قد تظهر هذه المشاكل على شكل نطاقات عمودية في جميع المفاتيح في أداة Key Visualizer، ما يقدّم لك تلميحات فقط حول وقت حدوث المشاكل.

مدة البيانات

يتم حذف البيانات التي يجمعها Key Visualizer عن Cloud Firestore بعد 14 يومًا.

تتوفّر بيانات "أداة العرض المرئي للمقاييس الأساسية" لآخر 14 يومًا. على سبيل المثال، إذا شغّلت Key Visualizer في 19 كانون الأول (ديسمبر) الساعة 12:45 ظهرًا، سيكون أقرب وقت بدء يمكنك اختياره لفترة زمنية مدتها ساعتان هو 5 كانون الأول (ديسمبر) الساعة 1:00 ظهرًا.

يعني هذا الحدّ أيضًا أنّه في حال أضفت إشارة مرجعية إلى عنوان URL لعملية فحص باستخدام Key Visualizer أو شاركته، سيكون الحدّ الأقصى لمدة صلاحية عنوان URL هو 14 يومًا.

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