ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

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

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

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

يمكن أيضًا بدء عمليات التتبع بعد إنشائها ، وتكون خيطًا آمنًا.

لاحظ ما يلي:

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

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

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

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

إضافة آثار مخصصة ومقاييس مخصصة

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

  1. أضف وحدة مراقبة الأداء إلى العنوان الخاص بك:

    سويفت

    import FirebasePerformance
    

    ج موضوعية

    @import FirebasePerformance;
    
  2. لبدء تتبع مخصص وإيقافه ، قم بلف التعليمات البرمجية التي تريد تتبعها بأسطر التعليمات البرمجية المشابهة لما يلي:

    سويفت

    let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")
    
    // code that you want to trace
    
    trace.stop()
    

    تعرف على المزيد حول واجهة برمجة التطبيقات للتتبعات المخصصة .

    ج موضوعية

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];
    
    // code that you want to trace
    
    [trace stop];
    

    تعرف على المزيد حول API للتتبعات المخصصة .

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

    سويفت

    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()
    

    ج موضوعية

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];
    
    [trace incrementMetric:@"EVENT_NAME" by:1];
    // code that you want to trace (and log custom metrics)
    
    [trace stop];
    

مراقبة الآثار والمقاييس المخصصة في وحدة التحكم

  1. في وحدة تحكم Firebase ، انتقل إلى لوحة معلومات الأداء .

  2. انقر فوق علامة التبويب على الجهاز ، ثم يمكنك:

    • عرض تقرير سريع عن البيانات التي تم جمعها لجميع آثارك.

    • انقر فوق تتبع محدد لمراجعة بيانات التتبع بمزيد من التفاصيل.

    • استخدم الزر تصفية في الجزء العلوي الأيسر من لوحة المعلومات لإجراء تصفية أساسية للبيانات حسب السمة.

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

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

    • استخدم الزر تصفية في الجزء العلوي الأيسر من لوحة المعلومات لإجراء تصفية أساسية للبيانات حسب السمة.

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

    يصف القسم التالي الميزات المتوفرة لتقرير التتبع المتعمق.

عرض مزيد من التفاصيل حول عينات التتبع

يمكنك الغوص بعمق في أجزاء من عمليات التتبع المحددة أو طلبات الشبكة في وحدة تحكم Firebase . تظهر العينات العشوائية للجلسات المسجلة المعلومات التالية:

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

  • وحدة المعالجة المركزية: مقدار وقت المستخدم ووقت النظام الذي يستهلكه تطبيقك.

  • الذاكرة: مقدار الذاكرة التي يستخدمها تطبيقك. ذاكرة الكومة هي الذاكرة المستخدمة للتخصيصات الديناميكية ، بما في ذلك الكائنات التي تم إنشاؤها ، والكائنات التي تم إلغاء تخصيصها ، والكائنات التي يستخدمها التطبيق بنشاط.

  • المعلومات الفردية: معلومات تفصيلية حول مثيل واحد من طلبات التتبع أو الشبكة ، بما في ذلك وقت البدء ووقت الانتهاء والمدة وحجم الطلب وحجم الاستجابة.

  • المثيلات المتزامنة: معلومات حول عمليات التتبع أو طلبات الشبكة التي حدثت في نفس الوقت.

  • سمات الجهاز: معلومات حول الجهاز ، بما في ذلك إصدار التطبيق والطراز وإصدار نظام التشغيل والراديو والسمات المخصصة.

لمشاهدة هذه النماذج التفصيلية في وحدة تحكم Firebase ، يمكنك إما:

  • افتح أحد تتبعات تطبيقك أو طلبات الشبكة ، ثم انقر على الاطلاع على الجلسات .

  • انقر على رابط جلسات السمة من السمة المحددة.

صورة لتتبع مراقبة أداء Firebase مع رابط إلى الجلسات

تصفية الجلسات حسب النسبة المئوية

يتم توزيع الجلسات التي تجمعها مراقبة الأداء إلى نسب مئوية لكل مقياس. الجلسات في النطاقات المئوية الأقل لها قيمة أقل للمقياس من الجلسات في نطاقات النسبة المئوية الأعلى.

لتصفية الجلسات المتاحة حسب النسبة المئوية ، استخدم القائمة المنسدلة المئوية أعلى تفاصيل الجلسات.

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

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