تجزیه‌وتحلیل آمار عملکرد پُرسمان

این صفحه نحوه استفاده از داشبورد «اطلاعات آماری پُرسمان» برای شناسایی و تجزیه‌وتحلیل عملکرد پُرسمان را شرح می‌دهد.

نمای کلی بینش‌های تحلیلی پُرسمان

از داشبورد «اطلاعات آماری پُرسمان» برای پایش پُرسمان‌های مربوط به سنجه‌ها استفاده کنید. براساس سنجه‌ها، می‌توانید پُرکاربردترین پُرسمان‌ها و پُرسمان‌های با تأخیر بالا را که ممکن است نیاز به بهینه‌سازی داشته باشند شناسایی کنید. از داشبورد اطلاعات آماری «پُرسمان» برای کمک به موارد زیر استفاده کنید:

  • بهینه‌سازی عملکرد پُرسمان: پُرسمان‌های دارای تأخیر بالا را که ممکن است نیاز به بهینه‌سازی داشته باشند شناسایی کنید.
  • مدیریت هزینه پُرسمان: پُرسمان‌های پرهزینه را کشف کنید و آن‌ها را برای کاهش هزینه‌ها بهینه‌سازی کنید.
  • پایش آمار پُرسمان: آمار پُرسمان را درطول زمان ردیابی کنید.
  • توصیه‌های نمایه: نمایه‌های ترکیبی مفقود یا غیربهینه را شناسایی کنید و نمایه‌های توصیه‌شده را مستقیماً از داشبورد ایجاد کنید (نسخه Enterprise).

داده‌های اطلاعات آماری پُرسمان

اطلاعات آماری پُرسمان شامل داده‌های روش‌های میانای برنامه‌سازی کاربردی زیر است:

  • find
  • aggregate

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

اطلاعات آماری پُرسمان اطلاعات زیر را درباره پُرسمان برمی‌گرداند:

نوشتار پُرسمان عادی‌شده ساختار پُرسمان که به‌صورت نوشتار نشان داده شده است.
تعداد اجرا تعداد اجراها در پنجره زمانی انتخاب‌شده.
تعداد خطا تعداد خطاها در پنجره زمانی انتخاب‌شده.
میانگین مدت اجرا (میلی‌ثانیه) میانگین زمان برحسب میلی‌ثانیه که طول کشیده است تا پایگاه داده پُرسمان را پردازش کند.
میانگین تعداد نتایج برگردانده‌شده تعداد نتایج برگردانده‌شده توسط پُرسمان. نتایج شامل اسناد، شناسه‌های مجموعه، و باکت‌های انبوهشی است.
میانگین تعداد اسناد اسکن‌شده تعداد اسناد اسکن‌شده در پُرسمان.
میانگین تعداد ورودی‌های نمایه اسکن‌شده تعداد ورودی‌های نمایه که برای اجرای پُرسمان بررسی شده‌اند.
بار کردن براساس میانگین زمان داده‌هایی برای کمک به فیلتر کردن پرسمان‌های برتر براساس میانگین تأخیر.
بارگیری براساس مجموع عملیات خواندن (قابل‌صورت‌حساب) داده‌هایی برای کمک به فیلتر کردن پُرسمان‌های برتر براساس کل عملیات خواندن قابل‌صورت‌حساب.
توصیه‌های نمایه نمایه‌های ترکیبی توصیه‌شده، نمایه‌های استفاده‌شده، و تأثیر تخمینی حجم کاری برای پُرسمان‌ها در پایگاه‌های داده نسخه Enterprise.

دقت و نگهداری داده‌ها

جزئیات داده‌ها به مدت مشخص‌شده بستگی دارد:

  • دانه‌بندی ۱۰ دقیقه‌ای برای فاصله‌های زمانی تا ۴ روز قبل
  • دانه‌بندی ۱ ساعته برای فاصله‌های زمانی تا ۳۰ روز قبل

حداکثر مدت حفظ داده‌ها برای «اطلاعات آماری پُرسمان» ۳۰ روز است. داده‌های ۱۰ دقیقه‌ای به‌مدت ۴ روز و داده‌های ساعتی به‌مدت ۳۰ روز ذخیره می‌شوند.

مشاهده اطلاعات آماری پُرسمان

کنسول Firebase
  1. برای مشاهده اطلاعات آماری پُرسمان برای پایگاه داده Cloud Firestore، پانل اطلاعات آماری پُرسمان پایگاه داده را در کنسول Google Cloud باز کنید.
  2. در کنسول Firebase، به صفحه Firestore Database بروید.

    رفتن به Firestore Database

  3. از فهرست پایگاه‌های داده، پایگاه داده‌ای را انتخاب کنید.
  4. از فهرست برگه‌ها، روی اطلاعات آماری پُرسمان کلیک کنید.

    برای پیدا کردن پُرسمان‌های برتر براساس تأخیر یا تعداد عملیات خواندن، روی تأخیر یا عملیات خواندن کلیک کنید.

توصیه‌های نمایه

توصیه‌های نمایه برای «اطلاعات آماری پُرسمان» به‌طور خودکار پیکربندی‌های نمایه مرکب مفقود یا نامطلوب را برای شکل‌های پُرسمان مکرراً اجراشده در پایگاه‌های داده نسخه Firestore Enterprise شناسایی می‌کند.

در نسخه Firestore Enterprise، پُرسمان‌ها می‌توانند حتی بدون نمایه‌های ترکیبی منطبق اجرا شوند، که می‌تواند منجر به اسکن‌های کامل مجموعه یا عملیات مرتب‌سازی در حافظه شود. داشبورد «اطلاعات آماری پُرسمان» آمار اجرای پُرسمان‌های گذشته را تحلیل می‌کند و نمایه‌های ترکیبی هدفمندی را برای بهینه‌سازی تأخیر پُرسمان و کاهش اسناد اسکن‌شده قابل‌صورت‌حساب پیشنهاد می‌دهد.

نحوه عملکرد توصیه‌های نمایه

یک خط لوله دسته‌ای آفلاین به‌طور دوره‌ای پُرسمان‌های برتر گذشته را ارزیابی می‌کند:

  • تحلیل ساختار پُرسمان: گزاره‌های برابری، مرتب‌سازی، و محدوده را از پُرسمان‌های مکرراً اجراشده استخراج می‌کند.
  • تولید نمایه نامزد: تعاریف نمایه ترکیبی احتمالی را بااستفاده از اکتشافات ترتیب نمایه (برابری > مرتب‌سازی > محدوده) تولید می‌کند.
  • ارزیابی بهینه‌ساز: نمایه‌های نامزد را به مدل هزینه موتور پُرسمان تزریق می‌کند تا هزینه‌های اجرای پُرسمان پایه را با طرح‌های اجرای نمایه‌شده فرضی مقایسه کند.
  • رتبه‌بندی تأثیر حجم کاری: نمایه‌های توصیه‌شده را براساس کل صرفه‌جویی تخمینی در هزینه حجم کاری در ردیف‌های تأثیر رتبه‌بندی می‌کند:
    • بالا: اسکن‌های کامل مجموعه را به جستجوهای نمایه‌ای انتخابی تبدیل می‌کند، که به‌طور قابل‌توجهی خواندن سند و تأخیر اجرا را کاهش می‌دهد.
    • متوسط: عملیات‌های پرهزینه مانند مرتب‌سازی در حافظه را با ارائه نتایج نمایه ازپیش مرتب‌شده حذف می‌کند.
    • کم: بهبودهای جزئی در جستجو ارائه می‌دهد.
برای مشاهده نمایه‌های توصیه‌شده و ایجاد نمایه‌های پیشنهادی از کنسول Firebase:

  1. در کنسول Firebase، به صفحه Firestore Database بروید.

    رفتن به Firestore Database

  2. از فهرست پایگاه‌های داده، پایگاه داده Enterprise edition را انتخاب کنید.

  3. روی برگه اطلاعات آماری پُرسمان کلیک کنید.

  4. در جدول پُرسمان‌ها، شکل پُرسمانی را که توصیه دارد پیدا کنید و روی مرور توصیه‌ها در ردیف یا بالاپر کلیک کنید.

  5. در کادر گفتگوی توصیه نمایه، تعریف نمایه مرکب، ترتیب فیلد، و سطح تأثیر تخمینی حجم کاری (بالا، متوسط، یا پایین) را مرور کنید.

  6. روی ذخیره کردن کلیک کنید. کشوی عملیات طولانی‌مدت (LRO) برای پیگیری پیشرفت ساخت نمایه باز می‌شود.

  7. وقتی ساختن کامل شد، نمایه در برگه نمایه‌ها فهرست می‌شود و نشانگر توصیه از ردیف پُرسمان ناپدید می‌شود.

نسخه‌های پشتیبانی‌شده

توصیه‌های نمایه فقط برای پایگاه‌های داده نسخه Firestore Enterprise پشتیبانی می‌شود. پایگاه‌های داده نسخه استاندارد پشتیبانی نمی‌شود.

محدودیت‌ها

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

قیمت‌گذاری

برای «اطلاعات آماری پُرسمان» یا توصیه‌های نمایه هزینه اضافی دریافت نمی‌شود.

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

برای دریافت اجازه‌های لازم برای مشاهده داشبورد «اطلاعات آماری پُرسمان» و ایجاد نمایه‌های توصیه‌شده، از سرپرستتان بخواهید نقش‌های IAM زیر را در پروژه‌تان به شما اعطا کند:

  • برای مشاهده «اطلاعات آماری پُرسمان»: Datastore Viewer (roles/datastore.viewer)
  • برای ایجاد نمایه‌های توصیه‌شده: Datastore Index Admin (roles/datastore.indexAdmin) یا Cloud Datastore Owner (roles/datastore.owner)

این نقش‌های ازپیش تعریف‌شده حاوی اجازه‌های datastore.insights.get و datastore.indexes.create هستند.

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

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