نمای کلی از Key Visualizer

این صفحه مروری بر ابزار تشخیصی Key Visualizer برای Cloud Firestore ارائه می‌دهد.

کی ویژوالایزر چیست؟

Key Visualizer ابزاری است که به شما در تجزیه و تحلیل الگوهای استفاده از Cloud Firestore کمک می‌کند. این ابزار گزارش‌های بصری تولید می‌کند که میزان استفاده شما را بر اساس اسنادی که به آنها دسترسی دارید یا ورودی‌هایی که هنگام تغییر اسناد نوشته یا حذف می‌شوند، تفکیک می‌کند.

Key Visualizer می‌تواند بینش‌هایی در مورد الگوهای استفاده در مقیاس بزرگ ارائه دهد. موارد استفاده از Key Visualizer عبارتند از:

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

برای دستیابی به این اهداف، Key Visualizer می‌تواند به شما در انجام وظایف زیر کمک کند:

  • بررسی کنید که آیا خواندن‌ها یا نوشتن‌های شما نقاط حساسی را در محدوده‌های خاصی از سند ایجاد می‌کند یا خیر.
  • ببینید که چگونه افزایش ناگهانی ترافیک بر تأخیر تأثیر می‌گذارد.
  • بررسی کنید که آیا الگوهای دسترسی شما در پایگاه داده‌تان متعادل هستند یا خیر.
  • ساختار کلیدهای ایندکس را بررسی کنید تا تعاریف ایندکس که باعث مشکلات بارگذاری ایندکس می‌شوند را شناسایی کنید.
  • از تجسم کلیدهای شاخص برای پیش‌بینی بهتر الگوی حجم کار استفاده کنید.

واجد شرایط بودن اسکن

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

واجد شرایط بودن اسکن کاملاً به فعالیت پایگاه داده بستگی دارد. این موضوع به مقدار یا نوع داده موجود در پایگاه داده شما بستگی ندارد.

اسکن‌های کی ویژوالایزر

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

نمونه‌ای از اسکن Key Visualizer

اشتراک‌گذاری URLهای اسکن

شما می‌توانید URL یک اسکن Key Visualizer را به اشتراک بگذارید یا نشانه‌گذاری کنید. این URL همان اسکن Key Visualizer را باز می‌کند و همان معیار را انتخاب می‌کند. این URL تا زمان انقضای مدت زمان داده‌های اسکن معتبر است.

نقشه‌های حرارتی

هسته اصلی اسکن Key Visualizer، نقشه حرارتی است که مقدار یک معیار را در طول زمان نشان می‌دهد و آن را به حداکثر ۱۰۰۰ بخش کلیدی پیوسته تقسیم می‌کند.

برای یک نقشه حرارتی کلیدهای سند، محور x نقشه حرارتی نشان دهنده زمان و محور y نشان دهنده کلیدهای سند است، در حالی که برای یک نقشه حرارتی کلیدهای اندیس، محور x نقشه حرارتی نشان دهنده زمان و محور y نشان دهنده کلیدهای اندیس است.

هر اسکن Key Visualizer برای Cloud Firestore دو ساعت فعالیت را که به بخش‌های ۱۰ ثانیه‌ای تقسیم شده است، پوشش می‌دهد.

مقدار پایین برای یک معیار، «سرد» در نظر گرفته می‌شود و به صورت رنگ تیره ظاهر می‌شود. مقدار بالا، «گرم» است و به صورت رنگ روشن ظاهر می‌شود. بالاترین مقادیر به رنگ سفید ظاهر می‌شوند.

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

Key Visualizer ابزارهایی را برای کمک به شما در درک داده‌های هر اسکن ارائه می‌دهد. به بخش شروع به کار با Key Visualizer و کاوش در نقشه‌های حرارتی مراجعه کنید.

سطل‌های کلید

ابزار تجسم کلید، تمام کلیدهای موجود در پایگاه داده شما را به حداکثر ۱۰۰۰ محدوده پیوسته تقسیم می‌کند، که تقریباً تعداد کلیدها و عملیات‌ها در هر محدوده یکسان است. این محدوده‌ها به عنوان سطل‌های کلید شناخته می‌شوند.

ابزار تجسم کلید از کل عملیات/های یک پایگاه داده برای تقسیم سطل‌های کلید استفاده می‌کند تا هر سطل تقریباً تعداد عملیات/های یکسانی را با حداقل اندازه در نظر گرفته شده ۵۰ عملیات/ثانیه برای هر سطل کلید ثبت کند. برای پایگاه‌های داده با کل عملیات/ثانیه بالاتر، سطل‌های کلید می‌توانند هر کدام بیش از ۵۰ عملیات/ثانیه را ثبت کنند. پایگاه‌های داده با کمتر از ۵۰ عملیات/ثانیه منجر به اسکن با یک سطل کلید واحد می‌شوند.

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

معیارها

معیارهای زیر برای کلیدهای سند در اسکن‌های Key Visualizer در دسترس هستند:

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

معیار زیر برای کلیدهای فهرست در اسکن‌های Key Visualizer در دسترس است:

معیارها توضیحات
عملیات نوشتن فهرست میانگین تعداد نوشتن‌های ایندکس در ثانیه.

میانگین عملکرد

معیارهای میانگین تأخیر، میانگینی از کلیدهای موجود در سطل کلید را در نظر می‌گیرند. از آنجایی که این اندازه‌گیری در لایه ذخیره‌سازی انجام می‌شود، تأخیر گزارش‌شده در اینجا ممکن است کمتر از کل تأخیری باشد که یک فراخوانی API تجربه می‌کند.

محدودیت‌ها

اگرچه Key Visualizer معیارهای متنوعی را نشان می‌دهد، اما تک تک معیارهایی را که می‌توانند بر عملکرد Cloud Firestore تأثیر بگذارند، نمایش نمی‌دهد. به عنوان مثال:

  • مشکلات شبکه بین برنامه شما و Google Cloud ممکن است قابل مشاهده نباشند. آنها ممکن است به صورت نوارهای عمودی در تمام کلیدها در Key Visualizer ظاهر شوند که فقط به شما در مورد زمان وقوع مشکلات اشاره می‌کند.

مدت زمان داده

داده‌های جمع‌آوری‌شده توسط Key Visualizer برای Cloud Firestore پس از ۱۴ روز حذف می‌شوند.

داده‌های Key Visualizer برای ۱۴ روز گذشته در دسترس است. برای مثال، اگر Key Visualizer را در ۱۹ دسامبر ساعت ۱۲:۴۵ بعد از ظهر راه‌اندازی کنید، زودترین زمان شروعی که می‌توانید برای یک بازه زمانی ۲ ساعته انتخاب کنید، ۵ دسامبر ساعت ۱:۰۰ بعد از ظهر است.

این محدودیت همچنین به این معنی است که اگر URL را برای اسکن Key Visualizer نشانه‌گذاری یا به اشتراک بگذارید، URL حداکثر ۱۴ روز اعتبار دارد.

قدم بعدی چیست؟