بدء استخدام Key Visualizer

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

قبل البدء

لاستخدام أداة إنشاء التقارير المرئية للمفاتيح في Cloud Firestore، عليك تفعيل Firestore Key Visualizer API.

الأدوار المطلوبة لتفعيل واجهات برمجة التطبيقات

لتفعيل واجهات برمجة التطبيقات، تحتاج إلى دور مشرف استخدام الخدمة في إدارة الهوية وإمكانية الوصول (roles/serviceusage.serviceUsageAdmin)، الذي يتضمّن إذن serviceusage.services.enable تعرّف على كيفية منح الأدوار.

تفعيل واجهة برمجة التطبيقات

الأدوار المطلوبة

تأكَّد من منح حسابك أحد أدوار إدارة الهوية وإمكانية الوصول التالية:

  • مالك Cloud Datastore
  • مُشاهد أداة إنشاء التقارير المرئية للمفاتيح في Cloud Datastore
  • محرِّر
  • المالك

تتضمّن هذه الأدوار أذونات إدارة الهوية وإمكانية الوصول التالية المطلوبة للوصول إلى أداة إنشاء التقارير المرئية للمفاتيح:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

يمكنك أيضًا تحديد دور مخصّص يتضمّن الأذونات المطلوبة.

عرض عملية فحص لفترة زمنية

تغطّي كل عملية فحص في أداة إنشاء التقارير المرئية للمفاتيح فترة زمنية مدتها ساعتان. تتوفّر عملية فحص لفترة معيّنة لقواعد البيانات التي تتجاوز عمليات نقل البيانات فيها 3000 عملية على المستندات في أي دقيقة خلال تلك الفترة.

لتشغيل أداة إنشاء التقارير المرئية للمفاتيح:

  1. في Google Cloud Console، انتقِل إلى صفحة قواعد البيانات.

    الانتقال إلى "قواعد البيانات"

  2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

  3. في قائمة التنقّل، انقر على أداة إنشاء التقارير المرئية للمفاتيح.

  4. اختَر نطاقًا زمنيًا ومقياسًا من عمليات الفحص المتاحة في أداة إنشاء التقارير المرئية للمفاتيح:

    1. انقر على رمز القلم الرصاص في أعلى يسار الشاشة. اختَر تاريخًا ونطاقًا زمنيًا.

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

    2. اختَر جميع بيانات المستندات أو جميع بيانات الفهرس كمصدر.

    3. انقر على تحديث.

  5. اختَر مقياسًا لتحليله:

    انقر على القائمة المنسدلة للمقاييس في أعلى يسار الشاشة واختَر مقياسًا لعرضه. تفتح أداة إنشاء التقارير المرئية للمفاتيح تلقائيًا في المقياس العمليات في الثانية لمفاتيح المستندات والمقياس عمليات كتابة الفهرس في الثانية لمفاتيح الفهرس.

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

عرض نظرة عامة على النشاط

للحصول على نظرة عامة على النشاط خلال الفترة الزمنية المحدّدة التي تبلغ ساعتين، راجِع الخريطة الحرارية للمقياس التلقائي.

يعرِض المثال التالي خريطة حرارية تتضمّن اختلافات كبيرة في نمط الاستخدام لنطاقات مفاتيح مختلفة:

  • لا تتضمّن النطاقات المعروضة بألوان داكنة أي نشاط أو تتضمّن نشاطًا ضئيلاً.
  • تتضمّن النطاقات المعروضة بألوان زاهية نشاطًا أكبر بكثير.
  • يتضمّن النطاق الأبيض المتوهّج في المنتصف نشاطًا كبيرًا جدًا.

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

فحص مفاتيح المستندات

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

بعد الحصول على فكرة عن النشاط العام في قاعدة البيانات، يمكنك مواصلة التحقيق من خلال الاطّلاع على المقاييس الأخرى والتركيز على نطاقات المفاتيح التي قد تسبّب مشاكل. مزيد من المعلومات.

فحص مفاتيح الفهرس

يقيس المقياس عمليات كتابة الفهرس في الثانية في خلية معيّنة متوسّط عمليات كتابة الفهرس في الثانية ضمن النطاق الزمني الذي يبلغ 10 ثوانٍ ونطاق المفاتيح المقابلَين.

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