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

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

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

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

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

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

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

كيف تعمل مطابقة أنماط عناوين 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.

يجب أن يكون أحد أعضاء المشروع مالكًا أو محرِّرًا لإنشاء نمط عنوان 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 المخصّصة وبياناتها

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

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

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

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

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

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

  2. اختَر الأنماط المخصّصة من القائمة المنسدلة في علامة التبويب الفرعية طلبات الشبكة.

  3. مرِّر مؤشر الماوس فوق صف نمط عنوان URL المخصّص الذي تريد إزالته.

  4. انقر على في أقصى يسار الصف، ثم انقر على إزالة النمط المخصّص، ثم أكِّد الإزالة في مربّع الحوار.

عند إزالة نمط عنوان 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 ومالك المشروع أو محرّره.

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