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

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

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

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

في الرمز البرمجي، يمكنك تحديد بداية ونهاية عملية تتبُّع الرمز المخصّص باستخدام واجهات برمجة التطبيقات التي توفّرها حزمة "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.

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