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

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

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

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

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

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

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

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

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

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

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

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

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

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

لاحظ ما يلي:

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

لبدء تتبع تعليمات برمجية مخصصة وإيقافها، قم بلف التعليمات البرمجية التي تريد تتبعها باستخدام تعليمات برمجية مشابهة لما يلي:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

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

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

لاحظ ما يلي:

  • يجب أن تستوفي أسماء المقاييس المخصصة المتطلبات التالية: عدم وجود مسافة بيضاء بادئة أو لاحقة، وعدم وجود حرف سفلي بادئ ( _ ) والحد الأقصى للطول هو 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.

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