التعرّف على بيانات أداء طلبات الشبكة HTTP/S (أي تطبيق)

iOS والإصدارات الأحدث Android الويب Flutter

يستخدم Performance Monitoring عمليات التتبُّع لجمع بيانات عن العمليات التي يتم تتبُّعها في تطبيقك. عملية التتبُّع هي تقرير يحتوي على بيانات تم تسجيلها بين نقطتَي وقت في تطبيقك.

بالنسبة إلى جميع أنواع التطبيقات، يجمع Performance Monitoring تلقائيًا معلومات تتبُّع لكل طلب على الشبكة يُصدره تطبيقك، ويُعرف ذلك باسم تتبُّع طلب شبكة HTTP/S. تجمع هذه التتبّعات مقاييس للوقت الذي يمضي بين وقت إرسال تطبيقك لطلب إلى نقطة نهاية الخدمة ووقت اكتمال الاستجابة من نقطة النهاية هذه. بالنسبة إلى أيّ نقطة نهاية يقدّم تطبيقك طلبًا إليها، يسجِّل Performance Monitoring عدة مقاييس:

• وقت الاستجابة: الوقت بين وقت تقديم الطلب ووقت استلام الاستجابة بالكامل

• حجم حمولة الاستجابة: حجم البايت لحمولة الشبكة التي نزّلها التطبيق

• حجم الحمولة في الطلب: حجم الحمولة على الشبكة بالبايت الذي يحمّله التطبيق

• معدّل النجاح: النسبة المئوية للاستجابات الناجحة (رموز الاستجابة في النطاق 100 - 399) مقارنةً بإجمالي الاستجابات

يمكنك الاطّلاع على البيانات من عمليات التتبّع هذه في علامة التبويب الفرعية طلبات الشبكة ضمن جدول ملفّات التتبّع، والذي يظهر في أسفل لوحة بيانات الأداء (اطّلِع على مزيد من المعلومات عن استخدام وحدة التحكّم في وقت لاحق من هذه الصفحة).

Performance Monitoring تجمع بشكل تلقائي مقاييس طلبات الشبكة التي تستخدِم مكتبات الشبكة التالية:

• OkHttp3، وتحديدًا إصدار عميل HTTP‏ 3.x.x

• URLConnection في Java، وتحديدًا HttpURLConnection وHttpsURLConnection

• Apache HttpClient

  احرص على الاطّلاع على مزيد من المعلومات حول إزالة مكتبة Apache HTTP Client وإيقاف مكتبة Apache HTTP Client نهائيًا إذا كنت تستخدم هذه المكتبة.

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

بالإضافة إلى الأدوات الجاهزة لتجميع البيانات وطلبات الشبكة، تتيح Performance Monitoring أيضًا الخيارات التالية:

• إعداد عمليات تتبُّع طلبات الشبكة يدويًا: تتضمّن ميزة المراقبة التلقائية معظم طلبات الشبكة لتطبيقك. ومع ذلك، قد لا يتم تسجيل بعض الطلبات أو قد تستخدم مكتبة مختلفة لتقديم طلبات الشبكة. في هذه الحالات، يمكنك استخدام واجهة برمجة التطبيقات Performance Monitoring لإعداد عمليات تتبُّع مخصّصة لطلبات الشبكة يدويًا.
• تجميع البيانات ضمن أنماط عناوين URL مخصّصة: إذا كانت هناك عناوين URL معيّنة لا تلتقطها Firebase من خلال مطابقة أنماط عناوين URL التلقائية المشتقة، يمكنك إنشاء أنماط عناوين URL مخصّصة لتتبُّع مجموعة معيّنة من عناوين URL بمرور الوقت.
• تخصيص طريقة احتساب نسبة النجاح: في بعض الأحيان، من المتوقّع ظهور رمز خطأ لنقاط نهاية معيّنة لواجهة برمجة التطبيقات أو أن يتم التعامل معها في تطبيقك. وفي هذه الحالات، يمكنك ضبط طريقة احتساب نسبة النجاح ومراقبة نسبة نجاح طلبات الاتصال بالشبكة في تطبيقك بدقة أكبر.

تجميع البيانات ضمن أنماط عناوين URL

Firebase Performance Monitoring تُجمِّع تلقائيًا بيانات طلبات الشبكة المشابهة لمساعدتك في فهم المؤشرات في أداء طلبات الشبكة.

يتحقّق Firebase من كل طلب لمعرفة ما إذا كان عنوان URL لطلب الشبكة يتطابق مع ملف عناوين URL. إذا كان عنوان URL للطلب يتطابق مع نمط عنوان URL، تجمع Firebase تلقائيًا بيانات الطلب ضمن نمط عنوان URL. يعرض Firebase أنماط عناوين URL وبياناتها المجمّعة في علامة التبويب الشبكة ضمن لوحة بيانات الأداء لوحة تحكّم Firebase.

ما هو نمط عنوان URL؟

يحتوي نمط عنوان URL على نطاق بالإضافة إلى نمط يمكن أن يتطابق مع مسار عنوان URL، على سبيل المثال: example.com/*/animals/**.

• يمكن أن تحتوي أنماط عناوين URL على أقسام المسار التالية:

  • نص عادي: يتطابق مع سلسلة محددة
  • *: تتطابق مع أي سلسلة في جزء مسار واحد
  • ‫**: تطابق إضافة مسار عشوائية

• يمكن أن تكون أنماط عناوين URL:

  • الأنماط المستندة إلى Firebase، والتي تُعرف باسم أنماط عناوين URL التلقائية
  • الأنماط التي يحدّدها المستخدم، والتي تُعرف باسم أنماط عناوين URL المخصّصة

على سبيل المثال: يمكن أن يتطابق أيّ من طلبات عناوين URL التالية مع نمط عنوان URL example.com/*/animals/**.

• example.com/singapore/animals
• example.com/australia/animals/spiders
• example.com/australia/animals/marsupials/koala.png

يمكن أن يحتوي نطاق نمط عنوان URL أيضًا على * كقسمه الأول، على سبيل المثال: *.example.com/*/fruits/**.

تربط Firebase كل طلب بنمط عنوان URL واحد فقط. إذا كنت قد أعددت أي أنماط عناوين URL مخصّصة، يحاول Firebase مطابقة عناوين URL للطلبات مع هذه الأنماط أولاً. إذا لم تعثر Firebase على أي نمط عنوان URL مخصّص مطابق، تتم مطابقة عنوان URL للطلب مع نمط عنوان URL التلقائي الأكثر تمثيلاً. اطّلِع على مزيد من المعلومات عن أنماط عناوين URL التلقائية والمخصّصة في الأقسام التالية.

أنماط عناوين URL التلقائية

بدون أيّ إعداد من جانبك، يحاول Performance Monitoring عرض سلوك الاستخدام الأخير لتطبيقك من خلال مطابقة طلبات تطبيقك مع أنماط عناوين URL التلقائية.

كيف تعمل ميزة مطابقة أنماط عناوين URL تلقائيًا؟

تطابق Firebase كل طلب مع نمط عنوان URL التلقائي الأكثر تمثيلاً الذي تم استخراجه من الطلبات التي أرسلها تطبيقك. يُرجى العلم أنّ Firebaseمحاولة مطابقة عناوين URL للطلبات مع أي أنماط عناوين URL مخصّصة تم ضبطها أولاً.

في ما يلي مثال أساسي على كيفية محاولة Firebase مطابقة الطلبات مع نمط عنوان URL التلقائي الأكثر تمثيلاً لتطبيقك.

1. يرسل تطبيقك العديد من الطلبات إلى عناوين URL مثل:

   • example.com/germany/animals/bears
   • example.com/germany/animals/birds
   • example.com/germany/cars

   يحدِّد Firebase أنّ example.com/germany/** هو example.com/germany/**نمط طلب example.com/germany/** شائع لتطبيقك ويضيفه example.com/germany/**كنمط عنوان URL تلقائي فيexample.com/germany/** مشروعك.

   بالنسبة إلى أي طلبات جديدة تتطابق مع نمط عنوان URL هذا، يجمع Firebase بيانات الطلبات ضمن نمط عنوان URL التلقائي example.com/germany/**.

2. بعد أسبوع واحد، تُرسَل معظم طلبات تطبيقك إلى example.com/germany/animals/bears و example.com/germany/animals/birds. وبالتالي، تستخرج Firebase نمط عنوان URL example.com/germany/animals/** الذي يمثّل الصفحة بشكلٍ أفضل.

   بالنسبة إلى أي طلبات جديدة تتطابق مع نمط عنوان URL الجديد هذا، تجمع Firebase بيانات الطلبات فقط ضمن نمط عنوان URL الجديد. يواصل Firebase تجميع البيانات للطلبات المرسَلة إلى example.com/germany/cars بموجب example.com/germany/**.

3. ومع ذلك، خلال الأسابيع القليلة المقبلة، سينخفض عدد طلبات تطبيقك التي تؤدي إلى example.com/germany/animals/bears وexample.com/germany/animals/birds بشكل كبير. تحدِّد Firebase أنّ example.com/germany/animals/** لا تمثّل أحدث سلوك استخدام تطبيقك، لذا تبدأ Firebase في مطابقة هذين الطلبَين مرة أخرى مع example.com/germany/**.

   لا تُجمِّع Firebase أي بيانات أخرى للطلبات ضمن example.com/germany/animals/** لأنّه لم يعُد هو نمط عنوان URL التلقائي الأكثر تمثيلاً.

بما أنّ مطابقة أنماط عناوين URL التلقائية ديناميكية، يُرجى الانتباه إلى ما يلي:

• لا تتأثّر المطابقات والبيانات المجمّعة من الطلبات السابقة بأنماط عناوين URL الجديدة. لا تعيد Firebase تجميع بيانات الطلبات بأثر رجعي.

• لا تتأثر سوى الطلبات المستقبلية بأنماط عناوين URL الجديدة. تربط Firebase كل طلب جديد بنمط عنوان URL التلقائي الأكثر تمثيلاً. يُرجى العلم، مع ذلك، أنّ Firebase تحاول مطابقة عناوين URL للطلبات مع أي أنماط عناوين URL مخصّصة تم ضبطها أولاً.

عرض أنماط عناوين URL التلقائية وبياناتها

تعرِض Firebase جميع أنماط عناوين URL وبياناتها المجمّعة في علامة التبويب الفرعية طلبات الشبكة ضمن جدول عمليات التتبّع، والذي يظهر في أسفل لوحة بيانات الأداء لوحدة تحكّم Firebase.

قد تظهر لك أنماط عناوين URL تحمل التصنيف بلا فئة. هذه هي أنماط عناوين URL "الواسعة النطاق" التلقائية التي يمكن أن تُجمِّع Firebase بموجبها بيانات الطلبات التي لا تتطابق مع أي نمط عنوان URL أكثر تحديدًا.

عند انتهاء فترة الاحتفاظ بالبيانات للبيانات المجمّعة ضمن نمط عنوان URL، تحذف Firebase تلك البيانات من نمط عنوان URL. إذا انتهت صلاحية كل البيانات المجمَّعة ضمن نمط عنوان URL تلقائي، تحذف Firebase نمط عنوان URL هذا من وحدة تحكّم Firebase.

أنماط عناوين URL المخصّصة

يمكنك إنشاء أنماط عناوين URL مخصّصة لتتبُّع أنماط عناوين URL معيّنة لا تلتقطها Firebase باستخدام مطابقة أنماط عناوين URL التلقائية المشتقة. على سبيل المثال، يمكنك استخدام نمط عنوان URL مخصّص لتحديد المشاكل وحلّها في عنوان URL معيّن أو لمراقبة مجموعة معيّنة من عناوين URL بمرور الوقت.

يُرجى الانتقال إلى مقالة إنشاء أنماط عناوين URL مخصّصة للاطّلاع على مزيد من المعلومات.

تتبُّع بيانات الأداء وعرضها وتصفيتها

لعرض بيانات الأداء في الوقت الفعلي، تأكَّد من أنّ تطبيقك يستخدم إصدارًا من حزمة SDK لمراقبة الأداء متوافقًا مع معالجة البيانات في الوقت الفعلي. مزيد من المعلومات عن بيانات الأداء في الوقت الفعلي

تتبُّع مقاييس محدّدة في لوحة البيانات

لمعرفة مؤشرات المقاييس الرئيسية، أضِفها إلى لوحة المقاييس في أعلى لوحة بيانات الأداء. يمكنك تحديد التراجعات بسرعة من خلال الاطّلاع على التغيُّرات الأسبوعية أو التأكّد من أنّ التغييرات الأخيرة في الرمز البرمجي تحسِّن الأداء.

لوحة بيانات "مراقبة أداء Firebase" />

لإضافة مقياس إلى لوحة المقاييس، اتّبِع الخطوات التالية:

1. انتقِل إلى لوحة بيانات الأداء في وحدة تحكّم Firebase.
2. انقر على بطاقة مقياس فارغة، ثم اختَر مقياسًا حاليًا لإضافته إلى لوحة البيانات.
3. انقر على في بطاقة مقياس مملوءة للحصول على مزيد من الخيارات، على سبيل المثال، لاستبدال مقياس أو إزالته.

تعرِض لوحة المقاييس بيانات المقاييس التي تم جمعها بمرور الوقت، سواء في شكل بياني أو كنسبة مئوية تغيُّر عددية.

اطّلِع على مزيد من المعلومات عن استخدام لوحة البيانات.

عرض عمليات التتبّع وبياناتها

للاطّلاع على عمليات التتبّع، انتقِل إلى لوحة بيانات الأداء في وحدة تحكّم Firebase، ثم انتقِل إلى أسفل جدول عمليات التتبّع وانقر على علامة التبويب الفرعية المناسبة. يعرض الجدول بعض أهم المقاييس لكلّ عملية تتبُّع، ويمكنك أيضًا ترتيب القائمة حسب النسبة المئوية للتغيير لمقياس معيّن.

يوفّر Performance Monitoring صفحة لتحديد المشاكل وحلّها في وحدة تحكّم Firebase التي تُبرز التغيُّرات في المقاييس، ما يسهّل معالجة مشاكل الأداء بسرعة والحدّ من تأثيرها على تطبيقاتك ومستخدميك. يمكنك استخدام صفحة تحديد المشاكل وحلّها عند التعرّف على احتمالية حدوث مشاكل في الأداء، على سبيل المثال، في الحالات التالية:

• اختَرت المقاييس ذات الصلة في لوحة البيانات ولاحظت اختلافًا كبيرًا.
• في جدول عمليات التتبُّع، يمكنك الترتيب لعرض أكبر قيم دلتا في أعلى الصفحة، وستلاحظ تغييرًا كبيرًا في النسبة المئوية.
• تلقّي تنبيه عبر البريد الإلكتروني لإعلامك بمشكلة في الأداء

يمكنك الوصول إلى صفحة تحديد المشاكل وحلّها بالطرق التالية:

• في لوحة بيانات المقياس، انقر على الزر عرض تفاصيل المقياس.
• في أي بطاقة مقياس، انقر على => عرض التفاصيل. تعرض صفحة تحديد المشاكل وحلّها معلومات عن المقياس الذي اخترته.
• في جدول عمليات التتبّع، انقر على اسم عملية تتبّع أو أي قيمة مقياس في الصف المرتبط بهذه العملية.
• في تنبيه عبر البريد الإلكتروني، انقر على التحقيق الآن.

عند النقر على اسم تتبع في جدول عمليات التتبّع، يمكنك بعد ذلك التوغّل في المقاييس التي تهمّك. انقر على الزر فلترة لفلترة البيانات حسب السمة، على سبيل المثال:

يتم فلترة بيانات "مراقبة أداء Firebase" حسب السمة" />

• الفلترة حسب إصدار التطبيق لعرض بيانات عن إصدار سابق أو أحدث إصدار
• الفلترة حسب الجهاز لمعرفة كيفية تعامل الأجهزة القديمة مع تطبيقك
• الفلترة حسب البلد للتأكّد من أنّ موقع قاعدة البيانات لا يؤثّر في منطقة معيّنة

اطّلِع على مزيد من المعلومات عن عرض بيانات عمليات التتبّع.

الخطوات التالية

• اطّلِع على مزيد من المعلومات حول استخدام السمات لفحص بيانات الأداء.

• اطّلِع على مزيد من المعلومات حول كيفية تتبُّع مشاكل الأداء في وحدة تحكّم Firebase.

• إعداد تنبيهات لطلبات الشبكة التي تؤدي إلى خفض أداء تطبيقك: على سبيل المثال، يمكنك ضبط تنبيه عبر البريد الإلكتروني ل فريقك إذا تجاوز وقت الاستجابة لنمط عنوان URL معيّن الحدّ القصوى الذي تحدّده.

• عرض تقارير تفصيلية عن جلسات المستخدِمين التي يمكنك فيها الاطّلاع على تتبُّع محدّد في سياق مخطط زمني للتتبُّعات الأخرى التي تم جمعها أثناء الجلسة نفسها