این صفحه نحوه نظارت بر استفاده Cloud Firestore و شناسایی مشکلات احتمالی در برنامه شما را شرح می‌دهد.
داشبورد استفاده
از داشبوردهای میزان استفاده در کنسول Google Cloud و کنسول Firebase برای مشاهده‌ی خواندن، نوشتن و حذف اسناد در طول زمان استفاده کنید.
کنترل دسترسی
داشبوردهای استفاده به مجوز monitoring.timeSeries.list Cloud IAM نیاز دارند. نقش‌های مالک پروژه، ویرایشگر و بیننده این مجوز را اعطا می‌کنند. شما همچنین می‌توانید این مجوز را از طریق نقش Cloud Monitoring یا یک نقش سفارشی اعطا کنید.
داشبورد استفاده از پایگاه داده
برای مشاهده معیارهای استفاده از پایگاه داده Cloud Firestore ، صفحه استفاده از پایگاه داده را در کنسول Google Cloud باز کنید.
در کنسول گوگل کلود، به صفحه پایگاه‌های داده بروید.
از لیست پایگاه‌های داده، پایگاه داده مورد نظر را انتخاب کنید.
در منوی پیمایش، روی «استفاده» کلیک کنید.
برای مشاهده میزان استفاده از پایگاه داده خود، روی پیوند موجود در پیامی که در صفحه ظاهر می‌شود، کلیک کنید.
داشبورد استفاده از پایگاه داده Cloud Firestore در کنسول Google Cloud.
داشبورد استفاده تجمیعی
اگر پروژه شما چندین پایگاه داده Cloud Firestore دارد، می‌توانید معیارهای استفاده تجمیعی را در کنسول Google Cloud یا کنسول Firebase مشاهده کنید.
کنسول گوگل کلود
در کنسول گوگل کلود، به صفحه‌ی استفاده از پروژه بروید.
به میزان استفاده از پروژه Google Cloud بروید
داشبورد استفاده از پروژه، عملیات سند را در طول زمان به شرح زیر نشان می‌دهد:
داشبورد استفاده از پروژه Cloud Firestore در کنسول Google Cloud.
کنسول Firebase
به صفحه استفاده از Cloud Firestore بروید (کنسول Firebase )
داشبورد استفاده از Cloud Firestore در کنسول Firebase ."/>
داشبورد استفاده و گزارش‌های صورتحساب
داشبوردهای مصرف Cloud Firestore در کنسول‌های Firebase و Cloud تخمینی از مصرف ارائه می‌دهند. آنها می‌توانند به شما در شناسایی افزایش ناگهانی مصرف کمک کنند. با این حال، این داشبورد نمای دقیقی از عملیات صورتحساب‌شده ارائه نمی‌دهد. مصرف صورتحساب‌شده احتمالاً بیشتر است. در تمام موارد اختلاف، گزارش صورتحساب بر داشبورد مصرف اولویت دارد.
عملیاتی که باعث اختلاف بین داشبورد مصرف و مصرف صورتحساب می‌شوند عبارتند از:
- عملیات واردات و صادرات. خواندن‌ها و نوشتن‌های انجام شده توسط این عملیات در داشبورد استفاده نمایش داده نمی‌شوند.
- نوشتن‌های فقط تأیید بدون عملیات. نوشتن‌هایی که فقط وجود یا عدم وجود یک سند را تأیید می‌کنند، در عملیات خواندن دارای صورتحساب نقش دارند، اما به ترتیب به صورت `UPDATE_NOOP` و `DELETE_NOOP` در داشبورد استفاده از نوشتن نشان داده می‌شوند.
- نوشتن‌های بدون عملیات. عملیاتی که منجر به تغییر در پایگاه داده نمی‌شوند، مانند به‌روزرسانی که مقادیر فیلد را تغییر نمی‌دهد یا نوشتن در یک سند حذف شده، ممکن است در داشبورد استفاده به صورت `UPDATE_NOOP` یا `DELETE_NOOP` نشان داده شوند. اگرچه آنها به صورت `NOOP` نشان داده می‌شوند، اما همچنان در عملیات دارای صورتحساب مشارکت دارند.
نوشتن‌های فشرده. در مواردی که چندین نوشتن پشت سر هم در یک سند انجام می‌شود، داشبورد استفاده ممکن است چندین نوشتن را با هم فشرده کرده و آنها را به عنوان یک نوشتن حساب کند. هنگام محاسبه‌ی میزان استفاده، هر نوشتن همچنان جداگانه محاسبه می‌شود.
داشبورد استفاده همچنین نوشتن برای تبدیل‌های فیلد مانند مهرهای زمانی سرور، افزایش‌های عددی و عملیات اتحاد آرایه را از بین می‌برد. برای تبدیل‌های فیلد، داشبورد استفاده ممکن است چندین عملیات را به عنوان یک عملیات واحد شمارش کند.
- پرس‌وجوهایی که هیچ نتیجه‌ای نمی‌دهند. پرس‌وجوهایی با نتیجه صفر، هزینه یک عملیات خواندن را متحمل می‌شوند. این میزان استفاده محاسبه می‌شود اما در داشبورد استفاده نمایش داده نمی‌شود.
- عملیات خواندن از ورودی‌های شاخص خوانده شده . این میزان مصرف ثبت شده اما در داشبورد استفاده نمایش داده نمی‌شود. برای مثال، درخواست‌های تجمیع، صورتحساب ورودی‌های شاخص خوانده شده را ثبت می‌کنند اما این میزان مصرف در داشبورد استفاده نمایش داده نمی‌شود.
داشبورد استفاده برای حذف‌ها، عملیات انقضای خودکار انجام شده توسط سیاست‌های زمان ماندگاری (TTL) را ثبت نمی‌کند. لطفاً به معیارهای TTL از Cloud Monitoring مراجعه کنید.
استفاده از قانون امنیتی
علاوه بر این، کنسول Firebase یک داشبورد ارزیابی Firebase Security Rules ارائه می‌دهد که نمایی مفید و اجمالی از فراخوانی قوانین ارائه می‌دهد. همچنین می‌توانید از طریق Cloud Monitoring بر استفاده از Firebase Security Rules نظارت کنید. این ابزار همان معیارهای ارزیابی قوانین را به همراه امکان ساخت داشبوردهای سفارشی، تجزیه و تحلیل روندها و پیکربندی هشدارها (به عنوان مثال، هنگامی که درخواست‌های رد شده افزایش می‌یابند) ارائه می‌دهد. برای لیست کامل معیارهای موجود ، به مرجع معیارهای Cloud Monitoring مراجعه کنید.
داشبورد نظارت بر قوانین Cloud Firestore در کنسول Firebase .
معیارهای Cloud Monitoring
Cloud Monitoring معیارها، رویدادها و فراداده‌ها را از محصولات Google Cloud جمع‌آوری می‌کند. داشبورد استفاده در کنسول Cloud Firestore نیز داده‌های معیار مشابهی را گزارش می‌دهد. برای تنظیم داشبوردهای سفارشی و هشدارهای استفاده، از Cloud Monitoring استفاده کنید.
Cloud Monitoring شامل معیارهای Cloud Firestore زیر است:
| نام متریک | توضیحات |
|---|---|
| خواندن سند | تعداد دفعات خواندن موفق سند. می‌توانید این معیار را بر اساس نوع خواندن تقسیم کنید: جستجو (LOOKUP) یا پرس‌وجو (QUERY). این معیار شامل خواندن از عملیات صادرات مدیریت‌شده یا حذف انبوه نمی‌شود. |
| نوشتن سند | تعداد نوشتن‌های موفق سند. می‌توانید این معیار را بر اساس نوع نوشتن تقسیم کنید: ایجاد (CREATE) یا به‌روزرسانی (UPDATE). این معیار شامل نوشتن‌های حاصل از عملیات واردات مدیریت‌شده نمی‌شود. |
| حذف سند | تعداد حذف‌های موفق سند. |
| اتصالات فعال | تعداد اتصالات فعال به پایگاه داده شما. هر SDK فعال موبایل و وب ، یک اتصال واحد را حفظ می‌کند که می‌تواند بین چندین شنونده‌ی اسنپ‌شات به اشتراک گذاشته شود. کتابخانه‌های کلاینت سرور، به ازای هر شنونده‌ی اسنپ‌شات، یک اتصال ایجاد می‌کنند. |
| شنوندگان عکس فوری | تعداد شنودکنندگان اسنپ‌شات در تمام اتصالات فعال. |
| تعداد حذف بر اساس زمان زنده ماندن | تعداد کل اسناد حذف شده توسط سیاست‌های زمان ماندگاری (TTL) . |
| انقضای زمان حیات تا تأخیر در حذف | مدت زمان سپری شده بین زمانی که یک سند تحت سیاست زمان ماندگاری (TTL) منقضی می‌شود و زمانی که واقعاً حذف می‌شود. |
- استفاده از به‌روزرسانی‌های بی‌درنگ
از معیارهای اتصالات فعال و شنوندگان اسنپ‌شات برای اندازه‌گیری میزان استفاده از به‌روزرسانی‌های بلادرنگ استفاده کنید.
فرض کنید کاربری برنامه شما را روی گوشی خود باز می‌کند. سپس برنامه به Cloud Firestore متصل می‌شود و در 10 کوئری مشترک می‌شود. این کار معیارهای شما را به میزان 1 اتصال فعال و 10 شنونده اسنپ‌شات افزایش می‌دهد.
- نرخ نمونه‌برداری
معیارهای Cloud Firestore هر دقیقه نمونه‌برداری می‌شوند، اما ممکن است به‌روزرسانی‌ها تا ۴ دقیقه طول بکشد تا در داشبوردهای شما نمایش داده شوند.
معیارهای تأخیر
معیارهای تأخیر در بک‌اند از طریق معیارهای رایج Google Cloud فایراستور در دسترس هستند.
برای مثال، نمودار تأخیر p50 را می‌توان در نمای کاوشگر معیارهای کنسول ابری (Cloud Console) یافت.
یک داشبورد Cloud Monitoring راه‌اندازی کنید
برای مشاهده یک داشبورد از پیش تعریف شده یا تنظیم یک داشبورد، به بخش «استفاده از داشبورد نظارت» مراجعه کنید.