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


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

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

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

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

  • حجم حمولة الطلب: حجم الحمولة بالبايت التي تم تحميلها من خلال التطبيق

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

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

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

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

بالإضافة إلى الأدوات الجاهزة وتجميع البيانات لطلبات الشبكة، تتيح 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 أيًا مما يلي:

على سبيل المثال: يمكن أن يتطابق أي من طلبات عناوين 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 المخصّصة في الأقسام التالية.

أنماط عناوين 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/** هو نمط طلب شائع لتطبيقك ويضيفه كنمط عنوان URL تلقائي في مشروعك.

    بالنسبة إلى أي طلبات مطابقة جديدة لنمط عنوان 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) لمراقبة الأداء يتوافق مع معالجة البيانات في الوقت الفعلي. مزيد من المعلومات عن بيانات الأداء في الوقت الفعلي

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

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

صورة للوحة المقاييس في <span class=لوحة بيانات "مراقبة الأداء في Firebase"" />

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

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

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

مزيد من المعلومات عن استخدام لوحة البيانات

عرض بيانات التتبُّع

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

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

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

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

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

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

صورة <span class=بيانات "مراقبة الأداء في Firebase" التي تتم فلترتها حسب السمة" />
  • الفلترة حسب إصدار التطبيق لعرض بيانات عن إصدار سابق أو أحدث إصدار
  • الفلترة حسب الجهاز لمعرفة كيفية تعامل الأجهزة القديمة مع تطبيقك
  • يمكنك الفلترة حسب البلد للتأكّد من أنّ موقع قاعدة البيانات لا يؤثر في منطقة معيّنة

مزيد من المعلومات حول عرض بيانات عمليات التتبُّع

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

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