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


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

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

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

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

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

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

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

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

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

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

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

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

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