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

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

قبل البدء

لاستخدام Key Visualizer في Cloud Firestore، يجب تفعيل واجهة Firestore Key Visualizer API.

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

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

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

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

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

  • مالك Cloud Datastore
  • مُشاهد أداة التمثيل البصري للمفاتيح في Cloud Datastore
  • محرِّر
  • المالك

تتضمّن هذه الأدوار أذونات "إدارة الهوية وإمكانية الوصول" التالية المطلوبة للوصول إلى Key Visualizer:

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

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

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

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

لتشغيل Key Visualizer:

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

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

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

  3. في قائمة التنقّل، انقر على Key Visualizer.

  4. اختَر فترة زمنية ومقياسًا من عمليات فحص Key Visualizer المتاحة:

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

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

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

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

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

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

لمقارنة المقاييس أو البحث عن ارتباطات البيانات، يمكنك عرض مقاييس Key Visualizer متعددة معًا. يُرجى الاطّلاع على العثور على روابط بين المقاييس المختلفة.

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

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

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

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

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

المسح الضوئي لمفاتيح المستندات

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

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

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

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

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