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

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

ما هي أداة Key Visualizer؟

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

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

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

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

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

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

يغطي كل فحص باستخدام "أداة تحليل الأداء الرئيسية" فترة ساعتين. يتوفّر فحص لفترة زمنية محدّدة لقواعد البيانات التي تتجاوز عدد عمليات المستندات فيها 3,000 عملية في أي دقيقة خلال تلك الفترة.

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

عمليات فحص Key Visualizer

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

مثال على عملية فحص باستخدام أداة Key Visualizer

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

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

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

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

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

يغطي كل فحص باستخدام "أداة تحليل المفاتيح المرئية" لمدة 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 يومًا.

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