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

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