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

تجمع أداة "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. اتّبِع التعليمات الظاهرة على الشاشة لاختيار رموز الاستجابة التي تريد احتسابها كرموز استجابة ناجحة.