إضافة تتبُّع مخصّص لرمز تطبيق معيّن


تجمع ميزة "مراقبة الأداء" تتبُّع الأداء لمساعدتك في تتبُّع أداء تطبيقك. حاسمة trace هو تقرير لبيانات الأداء التي تم تسجيلها بين نقطتين زمنيتين في تطبيقك.

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

المقياس التلقائي لتتبُّع رمز مخصّص هو "المدة" (الوقت بين نقاط البدء والتوقف للتتبُّع)، ولكن يمكنك إضافة مقاييس مخصّصة أيضًا.

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

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

بما أن المقياس التلقائي الذي يتم جمعه لعمليات التتبّع هذه هو "المدة"، تكون تسمى أحيانًا "عمليات تتبع المدة".

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

السمات التلقائية والسمات المخصّصة والمقاييس المخصّصة

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

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

عرض السمات المخصّصة والمقاييس المخصَّصة في "وحدة تحكُّم Firebase" إلى جانب السمات التلقائية والمقياس التلقائي للتتبُّع.

إضافة عمليات تتبُّع رموز مخصّصة

استخدام Performance Monitoring Trace API لإضافة عمليات تتبُّع رموز مخصّصة لرصد رمز تطبيق معيّن.

لاحظ ما يلي:

  • يمكن أن يتضمّن التطبيق عدة عمليات تتبُّع رموز مخصّصة.
  • يمكن تشغيل أكثر من عملية تتبُّع رموز مخصّصة واحدة في الوقت نفسه.
  • يجب أن تستوفي أسماء عمليات تتبُّع الرموز المخصّصة المتطلبات التالية: بدون مسافة بيضاء بادئة أو لاحقة، وبدون شرطة سفلية (_) بادئة، والحدّ الأقصى هو 100 حرف.
  • تتيح عمليات تتبُّع الرموز المخصّصة إضافة مقاييس مخصَّصة السمات المخصصة.

لبدء تتبُّع رمز مخصّص وإيقافه، عليك إحاطة الرمز الذي تريد تتبُّعه برمز مماثل لما يلي:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

إضافة مقاييس مخصّصة إلى عمليات تتبُّع الرموز المخصّصة

استخدِم Performance Monitoring Trace API لإضافة مقاييس مخصّصة إلى عمليات تتبُّع الرموز المخصّصة.

لاحظ ما يلي:

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

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

إنشاء سمات مخصّصة لعمليات تتبُّع الرموز المخصّصة

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

لاحظ ما يلي:

  • يجب أن تستوفي أسماء السمات المخصّصة المتطلبات التالية: بدون مسافة بيضاء بادئة أو لاحقة، وبدون شرطة سفلية (_) بادئة، والحد الأقصى للطول هو 32 حرفًا.

  • يمكن أن يسجِّل كلّ تتبُّع رمز مخصّص ما يصل إلى 5 سمات مخصّصة.

  • يجب عدم استخدام سمات مخصّصة تحتوي على معلومات تحدّد هوية شخص معيّن بشكل شخصي لـ Google.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

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

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

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

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

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

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

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

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

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

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

تعرَّف على المزيد من المعلومات عن عرض بيانات عمليات التتبُّع.

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

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

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

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