Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

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

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

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

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

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

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

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

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

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

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

استخدم واجهة برمجة تطبيقات تتبع مراقبة الأداء ( Swift | Obj-C ) لإضافة تتبعات تعليمات برمجية مخصصة لمراقبة كود تطبيق معين.

لاحظ ما يلي:

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

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

سويفت

ملاحظة: لا يتوفر منتج 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()

ج موضوعية

ملاحظة: لا يتوفر منتج 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];

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

استخدم واجهة برمجة تطبيقات تتبع مراقبة الأداء ( Swift | Obj-C ) لإضافة مقاييس مخصصة لتتبع التعليمات البرمجية المخصصة.

لاحظ ما يلي:

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

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

سويفت

ملاحظة: لا يتوفر منتج 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()

ج موضوعية

ملاحظة: لا يتوفر منتج 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];

إنشاء سمات مخصصة لتتبع التعليمات البرمجية المخصصة

استخدم واجهة برمجة تطبيقات تتبع مراقبة الأداء ( Swift | Obj-C ) لإضافة سمات مخصصة لتتبع التعليمات البرمجية المخصصة.

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

لاحظ ما يلي:

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

  • يمكن لكل تتبع رمز مخصص تسجيل ما يصل إلى 5 سمات مخصصة.

  • يجب ألا تستخدم السمات المخصصة التي تحتوي على معلومات تعرّف Google شخصيًا بالفرد.

    تعرف على المزيد حول هذا الدليل

سويفت

ملاحظة: لا يتوفر منتج 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;

ج موضوعية

ملاحظة: لا يتوفر منتج 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.

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

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