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

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

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

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

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

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

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

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

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

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

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

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

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

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

لاحظ ما يلي:

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

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

Web

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();perf_add_custom_trace.js

Web

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();index.js

إضافة عمليات تتبُّع الرموز البرمجية المخصّصة باستخدام User Timing API

بالإضافة إلى Performance Monitoring Trace API، يمكنك إضافة عمليات تتبُّع رموز مخصّصة باستخدام الأصلي للمتصفّح واجهة برمجة تطبيقات توقيت المستخدم. يتم تلقائيًا اختيار مدة التتبّع التي يتم قياسها باستخدام واجهة برمجة التطبيقات هذه من خلال حزمة تطوير البرامج (SDK) Performance Monitoring ويكون استخدام User Timing API مفيدًا بشكل خاص إذا كنت تفضّل لتحميل حزمة تطوير البرامج (SDK) "Performance Monitoring" بشكل غير متزامن بمجرد تهيئة حزمة SDK، تستخدم حزمة SDK سوف يسجل القياسات التي حدثت قبل تحميله.

لاستخدام هذه الميزة، عليك إحاطة الرمز الذي تريد تتبُّعه باستخدام علامات User Timing:

Web

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");perf_user_timing_marks.js

Web

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");index.js

يُرجى العلم أنّ العنصر performance في المثال أعلاه يشير إلى عنصر window.performance في المتصفّح.

عند استخدام User Timing API، لا يمكن إضافة المقاييس والسمات المخصّصة إلى بتتبُّع الرمز المخصّص. يمكنك استخدام Performance Monitoring Trace API إذا كنت تريد إضافة تلك العناصر المخصّصة العناصر إلى تتبُّع رمز مخصّص.

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

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

لاحظ ما يلي:

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

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

Web

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}perf_add_custom_metrics.js

Web

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}index.js

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

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

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

لاحظ ما يلي:

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

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

Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();perf_add_custom_attributes.js

Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

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

// Read attributes
const traceAttributes = trace.getAttributes();index.js

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك الفلترة حسب عنوان URL للصفحة لعرض بيانات صفحة محدّدة من موقعك الإلكتروني.
الفلترة حسب نوع الاتصال الفعّال لمعرفة مدى تأثير اتصال شبكة الجيل الثالث على تطبيق واحد
فلترة البيانات حسب البلد للتأكّد من أنّ موقع قاعدة البيانات لا يؤثّر في منطقة معيّنة

اطّلِع على مزيد من المعلومات عن عرض بيانات عمليات التتبّع.

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

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