سفارشی کردن تجمیع داده های درخواست شبکه

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

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

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

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

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

فایربیس تمام الگوهای URL (از جمله الگوهای URL سفارشی) و داده‌های تجمیع‌شده‌ی آن‌ها را در زیربرگه‌ی Network requests از جدول traces نمایش می‌دهد، که در پایین داشبورد Performance کنسول Firebase قرار دارد.

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

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

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

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

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

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

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

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

ایجاد الگوی URL سفارشی

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

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

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

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

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

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

برای تطابق ...	یک الگوی URL سفارشی مانند ... ایجاد کنید	مثال‌هایی که با این الگوی URL مطابقت دارند
یک URL دقیق	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

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

فایربیس تمام الگوهای URL (از جمله الگوهای URL سفارشی) و داده‌های تجمیع‌شده‌ی آن‌ها را در زیربرگه‌ی Network requests از جدول traces نمایش می‌دهد، که در پایین داشبورد Performance کنسول Firebase قرار دارد.

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

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

حذف الگوی URL سفارشی

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

1. از داشبورد Performance ، به پایین اسکرول کنید تا به جدول traces برسید، سپس زیربرگه Network requests را انتخاب کنید.

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

3. نشانگر ماوس را روی ردیف الگوی URL سفارشی که می‌خواهید حذف کنید، نگه دارید.

4. روی more_vert در منتهی‌الیه سمت راست ردیف کلیک کنید، گزینه‌ی Remove custom pattern را انتخاب کنید، سپس حذف را در کادر محاوره‌ای تأیید کنید.

هنگام حذف الگوی URL سفارشی، موارد زیر را در نظر داشته باشید:

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

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

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

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

مراحل بعدی

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

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

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

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

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

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

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

برای پیکربندی محاسبه نرخ موفقیت برای الگوی URL شبکه، باید مجوز firebaseperformance.config.update را داشته باشید. نقش‌های زیر به طور پیش‌فرض شامل این مجوز مورد نیاز هستند: Firebase Performance Admin ، Firebase Quality Admin ، Firebase Admin ، و Project Owner یا Editor .

1. به برگه داشبورد Performance Monitoring در کنسول Firebase بروید، سپس برنامه‌ای را که می‌خواهید محاسبه نرخ موفقیت را برای آن پیکربندی کنید، انتخاب کنید.
2. به پایین صفحه و جدول ردیابی‌ها بروید و برگه درخواست‌های شبکه را انتخاب کنید.
3. الگوی URL ای را که می خواهید محاسبه نرخ موفقیت را برای آن پیکربندی کنید، پیدا کنید.
4. در منتهی‌الیه سمت راست ردیف، منوی سرریز ( more_vert ) را باز کنید و گزینه‌ی «پیکربندی میزان موفقیت» (Configure success rate ) را انتخاب کنید.
5. برای انتخاب کدهای پاسخی که می‌خواهید به عنوان کدهای پاسخ موفق در نظر گرفته شوند، دستورالعمل‌های روی صفحه را دنبال کنید.