أضف مراقبة مخصصة لرمز تطبيق محدد

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

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

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

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

نظرًا لأن المقياس الافتراضي الذي تم جمعه لهذه التتبعات هو "المدة"، فإنها تسمى أحيانًا "تتبعات المدة".

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

السمات الافتراضية والسمات المخصصة والمقاييس المخصصة

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

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

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

إضافة آثار تعليمات برمجية مخصصة

استخدم واجهة برمجة تطبيقات تتبع مراقبة الأداء لإضافة آثار تعليمات برمجية مخصصة لمراقبة تعليمات برمجية محددة للتطبيق.

لاحظ ما يلي:

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

لبدء تتبع تعليمات برمجية مخصصة وإيقافها، قم بتغليف التعليمات البرمجية التي تريد تتبعها بأسطر من التعليمات البرمجية المشابهة لما يلي (يستخدم هذا المثال اسم تتبع مخصص لـ test_trace ):

Kotlin+KTX

// 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()

Java

// 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();

(اختياري) مراقبة طرق محددة باستخدام @AddTrace

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

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

Kotlin+KTX

// 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)
}

Java

// 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);
}

أضف مقاييس مخصصة لتتبعات التعليمات البرمجية المخصصة

استخدم واجهة برمجة تطبيقات تتبع مراقبة الأداء لإضافة مقاييس مخصصة لتتبعات التعليمات البرمجية المخصصة.

لاحظ ما يلي:

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

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

Kotlin+KTX

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()

Java

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();

إنشاء سمات مخصصة لتتبعات التعليمات البرمجية المخصصة

استخدم واجهة برمجة تطبيقات تتبع مراقبة الأداء لإضافة سمات مخصصة لتتبعات التعليمات البرمجية المخصصة.

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

لاحظ ما يلي:

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

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

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

    تعرف على المزيد حول هذا المبدأ التوجيهي

Kotlin+KTX

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
}

Java

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();

تتبع وعرض وتصفية بيانات الأداء

تتبع مقاييس محددة في لوحة التحكم الخاصة بك

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

صورة للوحة المقاييس في لوحة معلومات مراقبة أداء Firebase

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

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

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

تعرف على المزيد حول استخدام لوحة المعلومات .

عرض الآثار وبياناتها

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

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

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

يمكنك الوصول إلى صفحة استكشاف الأخطاء وإصلاحها بالطرق التالية:

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

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

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

تعرف على المزيد حول عرض البيانات الخاصة بتتبعاتك .

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

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

  • تعرف على المزيد حول كيفية تتبع مشكلات الأداء في وحدة تحكم Firebase.

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

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