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

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

ومع ذلك، تحتاج في بعض الأحيان إلى تخصيص طريقة 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 ساعة حتى يتم جمع بيانات تجميع البيانات ضمن نمط عنوان 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. انتقِل إلى لوحة البيانات الخاصة بمراقبة الأداء مفتاح التبويب (Tab) في "وحدة تحكُّم Firebase"، ثم اختَر التطبيق تكوين حساب معدل النجاح.
  2. انتقِل للأسفل إلى جدول التتبُّع في أسفل الشاشة واختَر علامة التبويب طلبات الشبكة.
  3. البحث عن نمط عنوان URL الذي تريد ضبط معدّل نجاحه عملية حسابية.
  4. في أقصى يسار الصف، افتح القائمة الكاملة () واختَر إعداد النتائج الناجحة. .
  5. اتّبِع التعليمات الظاهرة على الشاشة لاختيار رموز الاستجابة المطلوبة. ويتم احتسابها كرموز استجابة ناجحة.