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

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

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

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

في الرمز البرمجي، يمكنك تحديد بداية تتبُّع الرمز المخصّص ونهايته باستخدام واجهات برمجة التطبيقات التي توفّرها حزمة تطوير البرامج (SDK) لخدمة "Performance Monitoring". بالنسبة إلى تطبيقات Android، يمكنك أيضًا تتبُّع طرق معيّنة باستخدام التعليق التوضيحي @AddTrace. يمكن بدء عمليات تتبُّع الرموز المخصّصة في أي وقت بعد إنشائها، وهي آمنة من حيث سلاسل التعليمات.

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

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

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

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

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

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

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

لاحظ ما يلي:

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

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

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()
MainActivity.kt

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();
MainActivity.java

(اختياري) تتبُّع طرق معيّنة باستخدام @AddTrace

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

على سبيل المثال، يمكنك إنشاء تتبُّع مخصّص للرمز البرمجي باسم onCreateTrace يتم تشغيله عند استدعاء الطريقة onCreate().

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
// the `enabled` argument is optional and defaults to true
@AddTrace(name = "onCreateTrace", enabled = true)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}
MainActivity.kt

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}
MainActivity.java

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

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

لاحظ ما يلي:

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

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

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()
MainActivity.kt

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();
MainActivity.java

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

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

لاحظ ما يلي:

• يجب أن تستوفي أسماء السمات المخصّصة المتطلبات التالية:

  • يجب ألا يحتوي على مسافة بيضاء بادئة أو لاحقة، وألا يحتوي على حرف شرطة سفلية (_) بادئ
  • ما مِن مساحات
  • الحد الأقصى للطول هو 32 حرفًا
  • الأحرف المسموح بها للاسم هي A-Z وa-z و_.

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

• يُرجى التأكّد من أنّ السمات المخصّصة لا تحتوي على أي معلومات تكشف الهوية الشخصية لأي فرد لشركة Google.

  مزيد من المعلومات حول هذه الإرشادات

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}
MainActivity.kt

Trace trace = FirebasePerformance.getInstance().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();
MainActivity.java

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• مزيد من المعلومات حول استخدام السمات لفحص بيانات الأداء

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

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

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