سفارشی‌سازی کردن انبوهش داده‌های درخواست شبکه

Firebase Performance Monitoring به‌طور خودکار داده‌های درخواست‌های شبکه مشابه را تجمیع می‌کند تا به شما کمک کند روندهای عملکرد درخواست شبکه را درک کنید.

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

تجمیع داده‌ها تحت الگوهای نشانی وب سفارشی

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

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

Firebase همه الگوهای نشانی وب (ازجمله الگوهای نشانی وب سفارشی) و داده‌های تجمیعی آن‌ها را در زبانه فرعی درخواست‌های شبکه در جدول ردیابی‌ها نمایش می‌دهد که در پایین داشبورد عملکرد در کنسول Firebase قرار دارد.

تطبیق الگوی نشانی وب سفارشی چگونه کار می‌کند؟

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

اگر نشانی وب درخواستی با بیش‌از یک الگوی نشانی وب سفارشی مطابقت داشته باشد، Firebase درخواست را فقط به خاص‌ترین الگوی نشانی وب سفارشی، طبق ترتیب خاص بودن زیر، نگاشت می‌کند: نوشتار ساده > * > ** از چپ به راست در مسیر. برای مثال، درخواست example.com/books/dog با دو الگوی نشانی وب سفارشی مطابقت دارد:

• example.com/books/*
• example.com/*/dog

بااین‌حال، الگوی example.com/books/* خاص‌ترین الگوی نشانی وب منطبق است زیرا بخش سمت چپ books در example.com/books/* بر بخش سمت چپ * در example.com/*/dog اولویت دارد.

هنگام ایجاد الگوی نشانی وب سفارشی جدید، به موارد زیر توجه داشته باشید:

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

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

ایجاد الگوی نشانی وب سفارشی

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

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

می‌توانید درمجموع حداکثر ۴۰۰ الگوی نشانی وب سفارشی برای هر برنامه و حداکثر ۱۰۰ الگوی نشانی وب سفارشی برای هر دامنه آن برنامه ایجاد کنید.

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

• نوشتار ساده — با رشته دقیق مطابقت دارد
• * — با اولین بخش زیردامنه یا هر رشته‌ای در یک بخش مسیر مطابقت دارد
• ‫** — با پسوند مسیر قراردادی مطابقت دارد

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

برای مطابقت دادن…	الگوی نشانی وب سفارشی ایجاد کنید، مثل…	نمونه‌های منطبق با این الگوی نشانی وب
نشانی وب دقیق	example.com/foo/baz	example.com/foo/baz
هر بخش مسیر تکی (*)	example.com/*/baz	example.com/foo/baz example.com/bar/baz
	example.com/*/*/baz	example.com/foo/bar/baz example.com/bah/qux/baz
	example.com/foo/*	example.com/foo/baz example.com/foo/bar توجه: این الگو با example.com/foo مطابقت نخواهد داشت.
پسوند مسیر دلخواه (**)	example.com/foo/**	example.com/foo example.com/foo/baz example.com/foo/baz/more/segments
	subdomain.example.com/foo.bar/**	subdomain.example.com/foo.bar subdomain.example.com/foo.bar/baz subdomain.example.com/foo.bar/baz/more/segments
اولین بخش زیردامنه (*)	*.example.com/foo	bar.example.com/foo baz.example.com/foo

توجه: برای الگوهای نشانی وب سفارشی، Firebase از نحو *.file-extension، مثل *.png یا *.css پشتیبانی نمی‌کند.

مشاهده الگوهای نشانی وب سفارشی و داده‌های آن‌ها

Firebase همه الگوهای نشانی وب (ازجمله الگوهای نشانی وب سفارشی) و داده‌های تجمیعی آن‌ها را در زبانه فرعی درخواست‌های شبکه در جدول ردیابی‌ها نمایش می‌دهد که در پایین داشبورد عملکرد در کنسول Firebase قرار دارد.

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

وقتی دوره حفظ داده برای داده‌های جمع‌آوری‌شده تحت الگوی نشانی وب به‌پایان می‌رسد، Firebase آن داده‌ها را از الگوی نشانی وب حذف می‌کند. اگر همه داده‌های جمع‌آوری‌شده تحت یک الگوی نشانی وب سفارشی منقضی شوند، Firebase الگوی نشانی وب سفارشی را از کنسول Firebase حذف نمی‌کند. درعوض، Firebase همچنان الگوهای نشانی وب سفارشی «خالی» را در فهرست الگوهای سفارشی در زبانه فرعی درخواست‌های شبکه در جدول ردیابی‌ها فهرست می‌کند.

برداشتن الگوی نشانی وب سفارشی

می‌توانید الگوهای نشانی وب سفارشی را از پروژه‌تان بردارید. توجه داشته باشید که نمی‌توانید الگوی نشانی وب خودکار را بردارید.

1. از داشبورد عملکرد، به جدول ردپاها پیمایش کنید، سپس زیربرگه درخواست‌های شبکه را انتخاب کنید.

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

3. نشانگر را روی ردیف الگوی نشانی وب سفارشی که می‌خواهید بردارید نگه دارید.

4. روی در منتهی‌الیه سمت چپ ردیف کلیک کنید، برداشتن الگوی سفارشی را انتخاب کنید، سپس برداشتن را در کادر گفتگو تأیید کنید.

وقتی الگوی نشانی وب سفارشی را برمی‌دارید، به موارد زیر توجه داشته باشید:

• هرگونه درخواست آتی به مورد بعدی که بیشترین مطابقت را دارد با الگوی نشانی وب سفارشی نگاشت می‌شود. اگر Firebase هیچ الگوی نشانی وب سفارشی منطبقی پیدا نکند، به تطبیق خودکار الگوی نشانی وب برمی‌گردد.

• مطابقت‌ها و داده‌های انبوهشی از درخواست‌های قبلی تحت‌تأثیر برداشتن الگوی نشانی وب سفارشی قرار نمی‌گیرند.

  تا پایان دوره حفظ داده‌های مربوطه، همچنان می‌توانید به الگوی نشانی وب سفارشی برداشته‌شده و داده‌های تجمیعی آن در فرعی‌برگه درخواست‌های شبکه (با انتخاب همه درخواست‌های شبکه) دسترسی داشته باشید. وقتی همه داده‌های تجمیعی تحت الگوی نشانی وب سفارشی برداشته‌شده منقضی شود، Firebase الگوی نشانی وب سفارشی را حذف می‌کند.

• زیربرگه درخواست‌های شبکه (با انتخاب الگوهای سفارشی) هیچ الگوی نشانی وب سفارشی برداشته‌شده‌ای را فهرست نمی‌کند.

مراحل بعدی

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

سفارشی‌سازی نحوه محاسبه نرخ موفقیت

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

به‌طور خاص، Firebase به‌طور خودکار درخواست‌های شبکه با کد پاسخ در محدوده ۱۰۰ تا ۳۹۹ را به‌عنوان پاسخ‌های موفقیت‌آمیز درنظر می‌گیرد.

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

برای مثال، اگر برنامه‌تان میانای برنامه کاربردی نقطه پایانی جستجو دارد، می‌توانید پاسخ‌های ۴۰۴ را به‌عنوان «موفق» بشمارید چون پاسخ‌های ۴۰۴ برای نقطه پایانی جستجو موردانتظار است. فرض کنید هر ساعت ۱۰۰ نمونه برای این نقطه پایانی جستجو وجود دارد و ۶۰ مورد از آن‌ها پاسخ ۲۰۰ و ۴۰ مورد از آن‌ها پاسخ ۴۰۴ هستند. قبل‌از اینکه نرخ موفقیت را پیکربندی کنید، نرخ موفقیت ۶۰٪ خواهد بود. پس‌از اینکه محاسبه نرخ موفقیت را به‌گونه‌ای پیکربندی کردید که پاسخ‌های ۴۰۴ را به‌عنوان موفقیت‌آمیز حساب کند، نرخ موفقیت ۱۰۰٪ خواهد بود.

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

پیکربندی محاسبه نرخ موفقیت

برای پیکربندی محاسبه نرخ موفقیت برای الگوی نشانی وب شبکه، باید اجازه firebaseperformance.config.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این اجازه لازم هستند: سرپرست عملکرد Firebase، سرپرست کیفیت Firebase، سرپرست Firebase، و مالک یا ویرایشگر پروژه.

1. به برگه Performance Monitoring داشبورد در کنسول Firebase بروید، سپس برنامه‌ای را که می‌خواهید محاسبه نرخ موفقیت را برای آن پیکربندی کنید انتخاب کنید.
2. به جدول ردگیری‌ها در پایین صفحه پیمایش کنید و زبانه درخواست‌های شبکه را انتخاب کنید.
3. الگوی نشانی وبی را که می‌خواهید محاسبه نرخ موفقیت را برای آن پیکربندی کنید پیدا کنید.
4. در منتهی‌الیه سمت چپ ردیف، منوِ سرریز () را باز کنید و پیکربندی نرخ موفقیت را انتخاب کنید.
5. دستورالعمل‌های روی صفحه را دنبال کنید تا کدهای پاسخی را که می‌خواهید به‌عنوان کدهای پاسخ موفقیت‌آمیز شمرده شوند انتخاب کنید.

توجه: می‌توانید نرخ موفقیت را برای الگوهای نشانی وب خودکار و سفارشی پیکربندی کنید. توصیه می‌شود نرخ موفقیت را فقط برای الگوهای نشانی وب سفارشی پیکربندی کنید زیرا الگوهای نشانی وب خودکار می‌توانند با تغییر داده‌های شما درطول زمان تغییر کنند.