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