شروع به کار با Key Visualizer

این صفحه نحوه استفاده از Key Visualizer را برای بررسی مشکلات عملکردی که به الگوهای استفاده Cloud Firestore مربوط است شرح می‌دهد.

قبل از شروع

برای استفاده از Key Visualizer برای Cloud Firestore، باید Firestore Key Visualizer API را فعال کنید.

نقش‌های لازم برای فعال کردن میاناهای برنامه‌سازی کاربردی

برای فعال کردن میاناهای برنامه‌سازی کاربردی، به اجازه serviceusage.services.enable نیاز دارید. اگر پروژه را ایجاد کرده‌اید، احتمالاً ازقبل این اجازه را ازطریق نقش «مالک» (roles/owner) دارید. درغیراین‌صورت، می‌توانید این اجازه را ازطریق نقش «سرپرست استفاده از سرویس» (roles/serviceusage.serviceUsageAdmin) دریافت کنید. با نحوه اعطای نقش‌ها آشنا شوید.

فعال کردن میانای برنامه‌سازی کاربردی

نقش‌های الزامی

مطمئن شوید که یکی از نقش‌های IAM زیر به حسابتان اعطا شده باشد:

  • Cloud Datastore Owner
  • نمایشگر کلید مصورساز Cloud Datastore
  • ویرایشگر
  • مالک

این نقش‌ها شامل اجازه‌های IAM زیر است که برای دسترسی به Key Visualizer لازم است:

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

همچنین می‌توانید نقش سفارشی با اجازه‌های لازم تعریف کنید.

مشاهده اسکن برای یک دوره زمانی

هر اسکن Key Visualizer یک دوره دو ساعته را پوشش می‌دهد. اسکن برای یک دوره معین برای پایگاه‌های داده‌ای دردسترس است که ترافیک آن‌ها از ۳۰۰۰ عملیات سند در هر دقیقه معین در آن دوره فراتر می‌رود.

برای راه‌اندازی Key Visualizer:

  1. در کنسول Google Cloud، به صفحه پایگاه‌های داده بروید.

    رفتن به پایگاه‌های داده

  2. پایگاه داده موردنیاز را از فهرست پایگاه‌های داده انتخاب کنید.

  3. در منو پیمایش، روی Key Visualizer کلیک کنید.

  4. بازه زمانی و سنجه‌ای را از اسکن‌های Key Visualizer دردسترس انتخاب کنید:

    1. روی نماد مداد در بالا سمت چپ کلیک کنید. تاریخ و بازه زمانی را انتخاب کنید.

      اسکن‌ها براساس واجدشرایط بودن اسکن دردسترس هستند. نمی‌توانید بازه‌های زمانی‌ای را انتخاب کنید که واجدشرایط اسکن نبوده‌اند یا هنوز درحال پردازش هستند. پردازش دو اسکن آخر روز کمی طول می‌کشد تا دردسترس قرار بگیرند.

    2. همه داده‌های سند یا همه داده‌های نمایه را به‌عنوان منبع انتخاب کنید.

    3. روی به‌روزرسانی کلیک کنید.

  5. سنجه‌ای را برای تحلیل انتخاب کنید:

    روی منو کرکره‌ای سنجه‌ها در بالا سمت راست کلیک کنید و سنجه‌ای را برای مشاهده انتخاب کنید. Key Visualizer به‌طور پیش‌فرض در سنجه عملیات در ثانیه برای کلیدهای سند و سنجه عملیات نوشتن نمایه در ثانیه برای کلیدهای نمایه باز می‌شود.

برای مقایسه سنجه‌ها یا جستجوی همبستگی‌های داده، می‌توانید چند سنجه Key Visualizer را باهم نمایش دهید. پیدا کردن ارتباط بین سنجه‌های مختلف را ببینید.

مشاهده نمای کلی فعالیت

برای دریافت نمای کلی فعالیت درطول دوره زمانی دو ساعته انتخاب‌شده، نقشه حرارتی را برای سنجه پیش‌فرض مرور کنید.

مثال زیر نقشه حرارتی‌ای را نشان می‌دهد که در آن تفاوت‌های عمده‌ای در الگوی استفاده برای محدوده‌های کلیدی مختلف وجود دارد:

  • محدوده‌هایی که با رنگ‌های تیره نشان داده شده‌اند فعالیت کم دارند یا اصلاً فعالیت ندارند.
  • محدوده‌هایی که رنگ روشن دارند فعالیت بسیار بیشتری دارند.
  • محدوده سفید درخشان در وسط فعالیت بسیار بالایی دارد.

نمونه‌ای از اسکن «کلید مصورساز»

اسکن کلیدهای سند

سنجه عملیات در ثانیه تعداد درخواست‌ها در ثانیه را برای هر محدوده کلید اندازه‌گیری می‌کند. این سنجه مجموع درخواست‌های نوشتن، جستجو، و پرسمان است. Key Visualizer وقتی نقشه حرارتی را باز می‌کنید، این سنجه را به‌طور پیش‌فرض نشان می‌دهد.

پس‌از اینکه ایده کلی از فعالیت در پایگاه داده‌تان به‌دست آوردید، می‌توانید با نگاه کردن به سنجه‌های دیگر و تمرکز بر محدوده‌های کلیدی که ممکن است باعث مشکل شوند، به بررسی‌تان ادامه دهید. بیشتر بدانید.

اسکن کلیدهای نمایه

سنجه Index Write Ops/s در سلول موردنظر، میانگین نوشتن نمایه در ثانیه را در بازه زمانی ۱۰ ثانیه‌ای و محدوده کلید مربوطه اندازه‌گیری می‌کند.

حالا چه می‌شود