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