تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إضافة تتبُّع مخصّص لرمز تطبيق معيّن

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

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

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

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

بما أن المقياس التلقائي الذي يتم جمعه لعمليات التتبّع هذه هو "المدة"، تكون تسمى أحيانًا "عمليات تتبع المدة".

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

السمات التلقائية والسمات المخصّصة والمقاييس المخصّصة

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

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

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

إضافة عمليات تتبُّع رموز مخصّصة

استخدام Performance Monitoring Trace API (سويفت | Obj-C) لإضافة عمليات تتبُّع رموز مخصّصة لرصد رمز تطبيق معيّن.

لاحظ ما يلي:

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

لبدء عملية تتبُّع رموز مخصّصة وإيقافها، عليك إرفاق الرمز الذي تريد تتبُّعه. سطورًا من التعليمات البرمجية تشبه ما يلي:

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

إضافة مقاييس مخصّصة إلى عمليات تتبُّع الرموز المخصّصة

استخدام Performance Monitoring Trace API (سويفت | Obj-C) لإضافة مقاييس مخصّصة إلى عمليات تتبُّع الرموز المخصّصة.

لاحظ ما يلي:

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

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

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

إنشاء سمات مخصّصة لعمليات تتبُّع الرموز المخصّصة

استخدام Performance Monitoring Trace API (سويفت | Obj-C) لإضافة سمات مخصّصة إلى عمليات تتبُّع الرموز المخصّصة

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

لاحظ ما يلي:

يجب أن تستوفي أسماء السمات المخصّصة المتطلبات التالية:
- بدون مسافة بيضاء بادئة أو لاحقة، وبدون شرطة سفلية (_)
- ما مِن مساحات
- يجب أن يتألّف من 32 حرفًا كحدّ أقصى.
- إنّ الأحرف المسموح بها للاسم هي A-Z وa-z و_.
يمكن لكل عملية تتبُّع رموز مخصّصة تسجيل ما يصل إلى 5 سمات مخصّصة.
يُرجى التأكّد من أنّ السمات المخصّصة لا تتضمّن أي معلومات تحدد هوية أي شخص في Google.
مزيد من المعلومات حول هذه الإرشادات
جمع بيانات المستخدمين: لا تجمع ميزة "مراقبة الأداء" بحد ذاتها أي معلومات لتحديد الهوية الشخصية (PII)، مثل الأسماء أو عناوين البريد الإلكتروني أو العناوين أو أرقام الهواتف. يمكن للمطوّرين جمع بيانات إضافية باستخدام مراقبة الأداء من خلال إنشاء سمات مخصّصة في عمليات تتبُّع الرموز المخصّصة مثل هذه البيانات التي تم جمعها من خلال يجب ألا تحتوي مراقبة الأداء على معلومات تحدد بشكل شخصي بشكل فردي إلى Google.

في ما يلي مثال لرسالة سجلّ لا تحتوي على معلومات التعريف الشخصية:
```
trace.putAttribute("experiment", "A");
```
إليك مثال يتضمن تتضمن معلومات شخصية معلومات تحديد الهوية الشخصية (لا تستخدم هذا النوع من سمة مخصصة في تطبيقك):
```
trace.putAttribute("email", user.getEmailAddress());
```
تخضع البيانات التي تكشف أي معلومات تحديد الهوية الشخصية إلى حذفها دون إشعار.

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على أنظمة التشغيل macOS وMac Catalyst وwatchOS.

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

تتبُّع بيانات الأداء وعرضها وتصفيتها

تتبُّع مقاييس محددة في لوحة البيانات

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

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

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

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

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

اطّلِع على مزيد من المعلومات حول استخدام لوحة البيانات.

عرض عمليات التتبُّع وبياناتها

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

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

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

يمكنك الوصول إلى صفحة تحديد المشاكل وحلّها بالطرق التالية:

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

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

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

الفلترة حسب إصدار التطبيق للاطّلاع على بيانات عن إصدار سابق أو أحدث إصدار
يمكنك الفلترة حسب الجهاز لمعرفة طريقة تعامل الأجهزة القديمة مع تطبيقك.
الفلترة حسب البلد للتأكد من أنّ الموقع الجغرافي لقاعدة البيانات لا يؤثِّر في بلد معيّن منطقة

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

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

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

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