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

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

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

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

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

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

يعرض Firebase جميع أنماط عناوين URL (بما في ذلك أنماط عناوين URL المخصّصة) و data المجمّعة لها في علامة التبويب الفرعية طلبات الشبكة ضمن جدول عمليات التتبّع، والذي يقع في قاع لوحة بيانات الأداء لوحدة تحكّم 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 المخصّصة) و data المجمّعة لها في علامة التبويب الفرعية طلبات الشبكة ضمن جدول عمليات التتبّع، والذي يقع في قاع لوحة بيانات الأداء لوحة تحكّم 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. اتّبِع التعليمات الظاهرة على الشاشة لاختيار رموز الاستجابة التي تريد احتسابها كرموز استجابة ناجحة.