Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

تخصيص تجميع بيانات طلبات الشبكة

Firebase Performance Monitoring تجمع تلقائيًا بيانات طلبات الشبكة المتشابهة لمساعدتك في فهم مؤشرات أداء طلبات الشبكة.

في بعض الأحيان، عليك تخصيص طريقة تجميع Firebase لبيانات طلبات شبكة معيّنة من أجل تحسين دعم حالات استخدام تطبيقك. نقدّم طريقتَين لتخصيص تجميع البيانات لطلبات الشبكة: تجميع البيانات ضمن أنماط عناوين URL مخصّصة و تخصيص طريقة احتساب معدّل النجاح.

تجميع البيانات ضمن أنماط عناوين URL مخصّصة

بالنسبة إلى كل طلب، يتحقّق Firebase مما إذا كان عنوان URL لطلب الشبكة يطابق نمط عنوان URL . إذا كان عنوان URL للطلب يطابق نمط عنوان URL، يجمع Firebase تلقائيًا بيانات الطلب ضمن نمط عنوان URL.

يمكنك إنشاء أنماط عناوين URL مخصّصة لمراقبة أنماط عناوين URL معيّنة لا يسجّلها Firebase من خلال المطابقة التلقائية لأنماط عناوين URL المستنبطة. على سبيل المثال، يمكنك استخدام نمط عنوان URL مخصّص لتحديد المشاكل وحلّها في عنوان URL معيّن أو لمراقبة مجموعة معيّنة من عناوين URL بمرور الوقت.

يعرض Firebase جميع أنماط عناوين URL (بما في ذلك أنماط عناوين URL المخصّصة) وبياناتها المجمّعة في علامة التبويب الفرعية طلبات الشبكة في جدول التتبُّعات، والذي يظهر في أسفل لوحة بيانات الأداء في Firebase Console.

كيف تتم عملية مطابقة أنماط عناوين URL المخصّصة؟

يحاول Firebase مطابقة عناوين URL للطلبات مع أي أنماط عناوين URL مخصّصة تم ضبطها قبل الرجوع إلى المطابقة التلقائية لأنماط عناوين URL. بالنسبة إلى أي طلبات مطابقة لنمط عنوان URL مخصّص، يجمع Firebase بيانات الطلبات ضمن نمط عنوان URL المخصّص.

إذا كان عنوان URL لطلب معيّن يطابق أكثر من نمط عنوان URL مخصّص، يربط Firebase الطلب بنمط عنوان URL المخصّص الأكثر تحديدًا فقط، وفقًا لترتيب التحديد التالي: نص عادي > * > ** من اليسار إلى اليمين في المسار. على سبيل المثال، يطابق طلب إلى example.com/books/dog نمطَي عنوان URL مخصّصَين:

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

ومع ذلك، فإنّ النمط example.com/books/* هو نمط عنوان URL المطابق الأكثر تحديدًا لأنّ المقطع الأيسر books في example.com/books/* له الأولوية على المقطع الأيسر * في example.com/*/dog.

عند إنشاء نمط عنوان URL مخصّص جديد، يُرجى مراعاة ما يلي:

لا تتأثر المطابقات والبيانات المجمّعة من الطلبات السابقة بإنشاء نمط عنوان URL مخصّص جديد. لا يعيد Firebase تجميع بيانات الطلبات بأثر رجعي.
لا يتأثر بإنشاء نمط عنوان URL مخصّص جديد سوى الطلبات المستقبلية. قد تحتاج إلى الانتظار لمدة تصل إلى 12 ساعة حتى تجمع Performance Monitoring البيانات وتجمّعها ضمن نمط عنوان URL مخصّص جديد.

إنشاء نمط عنوان URL مخصّص

يمكنك إنشاء نمط عنوان URL مخصّص من علامة التبويب الفرعية طلبات الشبكة في جدول التتبُّعات، والذي يظهر في أسفل لوحة بيانات الأداء في Firebase Console.

يجب أن يكون أحد أعضاء المشروع مالكًا أو محرِّرًا لـ إنشاء نمط عنوان URL مخصّص جديد، ولكن يمكن لجميع أعضاء المشروع الاطّلاع على أنماط عناوين URL المخصّصة وبياناتها المجمّعة.

يمكنك إنشاء ما يصل إلى 400 نمط عنوان URL مخصّص إجمالي لكل تطبيق وما يصل إلى 100 نمط عنوان 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 مخصّص أي بيانات مجمّعة، فلن يظهر إلا في هذه القائمة.

عند انتهاء فترة التخزين للبيانات المجمّعة ضمن نمط عنوان URL، يحذف Firebase هذه البيانات من نمط عنوان URL. إذا انتهت صلاحية جميع البيانات المجمّعة ضمن نمط عنوان URL مخصّص ، لا يحذف Firebase نمط عنوان URL المخصّص من الـ Firebase Console. بدلاً من ذلك، يواصل Firebase إدراج أنماط عناوين URL المخصّصة "الفارغة" في قائمة الأنماط المخصّصة في علامة التبويب الفرعية طلبات الشبكة في جدول التتبُّعات.

إزالة نمط عنوان URL مخصّص

يمكنك إزالة أنماط عناوين URL المخصّصة من مشروعك. يُرجى العِلم أنّه لا يمكنك إزالة نمط عنوان URL تلقائي.

من لوحة بيانات الأداء ، انتقِل للأسفل إلى جدول التتبُّعات، ثم اختَر علامة التبويب الفرعية طلبات الشبكة.
اختَر الأنماط المخصّصة من القائمة المنسدلة في علامة التبويب الفرعية طلبات الشبكة.
مرِّر مؤشر الماوس فوق صف نمط عنوان URL المخصّص الذي تريد إزالته.
انقر على رمز في أقصى يسار الصف ، ثم اختَر إزالة النمط المخصّص، وأكِّد الإزالة في مربّع الحوار.

عند إزالة نمط عنوان URL مخصّص، يُرجى مراعاة ما يلي:

يتم ربط أي طلبات مستقبلية بنمط عنوان URL المخصّص المطابق الأكثر تحديدًا التالي. إذا لم يعثر Firebase على أي أنماط عناوين URL مخصّصة مطابقة، فسيرجع إلى المطابقة التلقائية لأنماط عناوين URL.
لا تتأثر المطابقات والبيانات المجمّعة من الطلبات السابقة بإزالة نمط عنوان URL مخصّص.

سيظل بإمكانك الوصول إلى نمط عنوان URL مخصّص تمت إزالته وبياناته المجمّعة في علامة التبويب الفرعية طلبات الشبكة (مع اختيار جميع طلبات الشبكة) حتى نهاية فترة التخزين السارية. عند انتهاء صلاحية جميع البيانات المجمّعة ضمن نمط عنوان URL المخصّص الذي تمت إزالته، يحذف Firebase نمط عنوان URL المخصّص.
لا تُدرِج علامة التبويب الفرعية طلبات الشبكة (مع اختيار الأنماط المخصّصة) أي أنماط عناوين URL مخصّصة تمت إزالتها.

الخطوات التالية

إعداد تنبيهات لطلبات الشبكة التي تؤدي إلى تدهور أداء تطبيقك. على سبيل المثال، يمكنك إعداد تنبيه عبر البريد الإلكتروني لـ فريقك إذا تجاوز وقت الاستجابة لنمط عنوان URL معيّن حدًا معيّنًا.

تخصيص طريقة احتساب معدّل النجاح

أحد المقاييس التي يراقبها Firebase لكل طلب شبكة هو معدّل نجاح الطلب. معدّل النجاح هو النسبة المئوية للاستجابات الناجحة مقارنةً بإجمالي الاستجابات. يساعدك هذا المقياس في قياس حالات تعذُّر الشبكة والخادم.

على وجه التحديد، يحسب Firebase تلقائيًا طلبات الشبكة التي تتضمّن رمز استجابة في النطاق من 100 إلى 399 على أنّها استجابات ناجحة.

يمكنك تخصيص عملية احتساب معدّل النجاح من خلال احتساب رموز خطأ معيّنة على أنّها "استجابات ناجحة" بالإضافة إلى رموز الاستجابة التي يحسبها Firebase تلقائيًا على أنّها ناجحة.

على سبيل المثال، إذا كان تطبيقك يتضمّن واجهة برمجة تطبيقات لنقطة نهاية البحث، يمكنك احتساب الاستجابات التي تحمل الرمز 404 على أنّها "ناجحة" لأنّ من المتوقّع أن تكون الاستجابات لنقطة نهاية البحث هي 404. لنفترض أنّ هناك 100 نموذج لنقطة نهاية البحث هذه كل ساعة، و60 منها هي استجابات تحمل الرمز 200 و40 منها هي استجابات تحمل الرمز 404. قبل ضبط معدّل النجاح، سيكون 60%. بعد ضبط عملية احتساب معدّل النجاح لاحتساب الاستجابات التي تحمل الرمز 404 على أنّها ناجحة، سيكون معدّل النجاح 100%.

ضبط عملية احتساب معدّل النجاح

لضبط عملية احتساب معدّل النجاح لنمط عنوان URL للشبكة، يجب أن يكون لديك الإذن firebaseperformance.config.update. تتضمّن الأدوار التالية هذا الإذن المطلوب تلقائيًا: مشرف أداء Firebase، مشرف جودة Firebase، مشرف Firebase، ومالك المشروع أو محرِّره.

انتقِل إلى علامة التبويب Performance Monitoring لوحة البيانات في Firebase Console، ثم اختَر التطبيق الذي تريد ضبط عملية احتساب معدّل النجاح له.
انتقِل للأسفل إلى جدول التتبُّعات في أسفل الشاشة وانقر على علامة التبويب طلبات الشبكة.
ابحث عن نمط عنوان URL الذي تريد ضبط عملية احتساب معدّل النجاح له.
في أقصى يسار الصف، افتح القائمة الكاملة () وانقر على ضبط معدّل النجاح.
اتّبِع التعليمات التي تظهر على الشاشة لاختيار رموز الاستجابة التي تريد احتسابها على أنّها رموز استجابة ناجحة.