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

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

قبل البدء

لاستخدام Key Visualizer مع Cloud Firestore، عليك تفعيل Firestore Key Visualizer API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

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

  • مالك Cloud Datastore
  • عارِض Key Visualizer في Cloud Datastore
  • محرِّر
  • المالك

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

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

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

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

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

لبدء Key Visualizer، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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