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

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

يجمع Performance Monitoring عمليات التتبُّع لمساعدتك في تتبُّع أداء تطبيقك. ويُعدّ التتبُّع تقريرًا لبيانات الأداء التي تم تسجيلها بين نقطتَين زمنيتَين في تطبيقك.

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

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

في الرمز البرمجي، يمكنك تحديد بداية ونهاية عملية تتبُّع الرمز المخصّص باستخدام واجهات برمجة التطبيقات التي توفِّرها حزمة تطوير البرامج (SDK) Performance Monitoring. بالنسبة إلى تطبيقات Android، يمكنك أيضًا مراقبة طرق معيّنة باستخدام تعليق توضيحي واحد (@AddTrace) يمكن بدء عمليات تتبُّع الرموز المخصّصة في أي وقت بعد إنشائها، تكون سلاسل المحادثات آمنة.

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

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

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

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

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

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

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

استخدام Performance Monitoring واجهة برمجة تطبيقات التتبع لإضافة عمليات تتبُّع رموز مخصّصة لرصد رمز تطبيق معيّن.

لاحظ ما يلي:

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

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

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()MainActivity.kt

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();MainActivity.java

(اختياري) تتبُّع طُرق معيّنة باستخدام @AddTrace

تتوافق تطبيقات Android أيضًا مع @AddTrace التعليق التوضيحي لقياس عمليات تتبُّع الرمز المخصّص. باستخدام هذه الميزة، يبدأ التتبع من بداية الطريقة المحددة ويتوقف عند اكتمال الطريقة، بما في ذلك أي شيء تم استدعاءه بهذه الطريقة.

على سبيل المثال، يمكنك إنشاء عملية تتبُّع رموز مخصّصة تُسمّى onCreateTrace، ويتم تشغيلها. عند استدعاء طريقة onCreate().

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
// the `enabled` argument is optional and defaults to true
@AddTrace(name = "onCreateTrace", enabled = true)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}MainActivity.kt

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}MainActivity.java

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

استخدام Performance Monitoring واجهة برمجة تطبيقات التتبع لإضافة مقاييس مخصّصة إلى عمليات تتبُّع الرموز المخصّصة.

لاحظ ما يلي:

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

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

Kotlin+KTX

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()MainActivity.kt

Java

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();MainActivity.java

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

استخدام Performance Monitoring واجهة برمجة تطبيقات التتبُّع لإضافة سمات مخصّصة إلى عمليات تتبُّع الرموز المخصّصة

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

لاحظ ما يلي:

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

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

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}MainActivity.kt

Java

Trace trace = FirebasePerformance.getInstance().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();MainActivity.java

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

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

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

لوحة بيانات مراقبة أداء Firebase" />

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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