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