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


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

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

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

في الرمز البرمجي، يمكنك تحديد بداية تتبُّع الرمز المخصّص ونهايته باستخدام واجهات برمجة التطبيقات التي توفّرها حزمة تطوير البرامج (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، ثم انتقِل للأسفل إلى جدول عمليات التتبُّع، ثم انقر على علامة التبويب الفرعية المناسبة. يعرض الجدول بعض أهم المقاييس لكل تتبُّع، ويمكنك حتى ترتيب القائمة حسب النسبة المئوية للتغيير لمقياس معيّن.

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

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

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

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