Check out what’s new from Firebase at Google I/O 2022. Learn more

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

تعمل ميزة مراقبة أداء 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 Performance Admin ، و Firebase Quality Admin ، و Firebase Admin ، ومالك المشروع أو المحرر .

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