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

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