Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

התחל בעבודה עם ניטור ביצועים לאנדרואיד

לפני שאתה מתחיל

אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך .

שלב 1 : הוסף את ה- SDK לניטור ביצועים לאפליקציה שלך

לאחר שהוספת את SDK לניטור ביצועים, Firebase מתחיל באופן אוטומטי לאסוף נתונים עבור עיבוד המסך של האפליקציה שלך ונתונים הקשורים למחזור החיים של האפליקציה שלך (כמו זמן התחלת היישום ). כדי לאפשר ל- Firebase לפקח על בקשות רשת, עליך להוסיף גם את התוסף Gradle Monitoring Performance (שלב הבא).

  1. באמצעות אנדרואיד BoM של Firebase , הצהיר על התלות בספריית אנדרואיד לניטור ביצועים בקובץ app/build.gradle (ברמת האפליקציה) שלך במודול (בדרך כלל app/build.gradle ).

    ג'אווה

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
        // Declare the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf'
    }
    

    על ידי שימוש ב- Firebase Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.

    (חלופי) הצהיר על תלות בספריית Firebase מבלי להשתמש ב- BoM

    אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

    שים לב שאם אתה משתמש במספר ספריות Firebase באפליקציה שלך, אנו ממליצים בחום להשתמש ב- BoM לניהול גרסאות ספרייה, מה שמבטיח שכל הגרסאות תואמות.

    dependencies {
        // Declare the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf:20.0.1'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
        // Declare the dependency for the Performance Monitoring library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx'
    }
    

    על ידי שימוש ב- Firebase Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.

    (חלופי) הצהיר על תלות בספריית Firebase מבלי להשתמש ב- BoM

    אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

    שים לב שאם אתה משתמש במספר ספריות Firebase באפליקציה שלך, אנו ממליצים בחום להשתמש ב- BoM לניהול גרסאות ספרייה, מה שמבטיח שכל הגרסאות תואמות.

    dependencies {
        // Declare the dependency for the Performance Monitoring library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-perf-ktx:20.0.1'
    }
    

  2. הידור מחדש את האפליקציה שלך.

שלב 2 : הוסף את התוסף ניטור ביצועים לאפליקציה שלך

לאחר שהוספת את התוסף Gradle ניטור ביצועים, Firebase מתחיל באופן אוטומטי לאסוף נתונים לבקשות רשת HTTP / S. התוסף גם מאפשר לך להכשיר עקבות קוד מותאמות אישית באמצעות הערת @AddTrace .

  1. במודול שלך (ברמת האפליקציה) קובץ Gradle (בדרך כלל app/build.gradle ), החל את התוסף ניטור ביצועים:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. בקובץ build.gradle ברמת השורש (ברמת הפרויקט) ( build.gradle ), הוסף את הכללים כדי לכלול את התוסף ניטור ביצועים.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.8'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.4.0'  // Performance Monitoring plugin
        }
    }
    
  3. הידור מחדש את האפליקציה שלך.

שלב 3 : צור אירועי ביצועים לתצוגת נתונים ראשונית

Firebase מתחיל לעבד את האירועים כאשר אתה מוסיף בהצלחה את ה- SDK לאפליקציה שלך. אם אתה עדיין מתפתח באופן מקומי, התקשר עם האפליקציה שלך כדי ליצור אירועים לאיסוף ועיבוד נתונים ראשוניים.

  1. צור אירועים על ידי החלפת האפליקציה שלך בין הרקע לחזית מספר פעמים, אינטראקציה עם האפליקציה שלך על ידי ניווט בין המסכים ו / או הפעלת בקשות רשת.

  2. עבור אל לוח המחוונים של הביצועים של קונסולת Firebase. אתה אמור להציג את הנתונים הראשוניים שלך תוך מספר דקות.

    אם אינך רואה תצוגה של הנתונים הראשוניים שלך, עיין בטיפים לפתרון בעיות .

שלב 4 : (אופציונלי) צפה בהודעות יומן עבור אירועי ביצוע

  1. הפעל רישום איתור באגים לצורך ניטור ביצועים בזמן הבנייה על ידי הוספת אלמנט <meta-data> לקובץ AndroidManifest.xml של האפליקציה שלך, כך:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. בדוק אם יש הודעות יומן לגבי הודעות שגיאה.

  3. ניטור ביצועים מתייג את הודעות היומן שלה עם FirebasePerformance . באמצעות סינון logcat, תוכל להציג באופן ספציפי מעקב אחר משך ורישום בקשות רשת HTTP / S על ידי הפעלת הפקודה הבאה:

    adb logcat -s FirebasePerformance
  4. בדוק אם ישנם סוגי יומנים הבאים המציינים כי ניטור ביצועים רושם אירועי ביצועים:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. לחץ על כתובת האתר כדי להציג את הנתונים שלך במסוף Firebase. ייתכן שיעברו מספר רגעים עד שהנתונים יתעדכנו בלוח המחוונים.

אם האפליקציה שלך לא רושמת אירועי ביצועים, עיין בטיפים לפתרון בעיות .

שלב 5 : (אופציונלי) הוסף ניטור מותאם אישית לקוד ספציפי

כדי לפקח על נתוני ביצועים המשויכים לקוד ספציפי באפליקציה שלך, אתה יכול לאתר עקבות קוד מותאמות אישית .

בעזרת מעקב אחר קוד מותאם אישית, תוכל למדוד כמה זמן לוקח לאפליקציה שלך להשלים משימה ספציפית או קבוצת משימות, כגון טעינת סט תמונות או שאילתת מסד הנתונים שלך. מדד ברירת המחדל עבור מעקב אחר קוד מותאם אישית הוא משך הזמן שלו, אך ניתן גם להוסיף מדדים מותאמים אישית, כגון התאמות מטמון ואזהרות זיכרון.

בקוד שלך, אתה מגדיר את ההתחלה ואת הסוף של מעקב אחר קוד מותאם אישית (ומוסיף את כל המדדים המותאמים אישית הרצויים) באמצעות ה- API שמספק SDK לניטור ביצועים. באפליקציות אנדרואיד, אתה יכול גם לפקח על משך השיטות הספציפיות באמצעות הערת @AddTrace .

בקר ב'הוסף ניטור 'עבור קוד ספציפי כדי ללמוד עוד על תכונות אלה וכיצד להוסיף אותם לאפליקציה שלך.

שלב 6 : פרוס את האפליקציה שלך ואז בדוק את התוצאות

לאחר שתאמת ניטור ביצועים באמצעות התקן בדיקה אחד או יותר, תוכל לפרוס את הגירסה המעודכנת של האפליקציה שלך למשתמשים שלך.

באפשרותך לפקח על נתוני ביצועים בלוח המחוונים של ביצועים במסוף Firebase.

בעיות ידועות

  • תוסף Gradle ניטור ביצועים v1.1.0 עלול לגרום לחוסר התאמה בתלות בגויאבה, וכתוצאה מכך השגיאה הבאה:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    אם אתה רואה שגיאה זו, תוכל:

    • שדרג את התוסף לניטור ביצועים ל- v1.1.1 ואילך (האחרון הוא v1.4.0).

    • החלף את קו התלות של תוסף ניטור ביצועים בקובץ build.gradle ברמת השורש (ברמת הפרויקט) ( build.gradle ), כדלקמן:

      buildscript {
        // ...
      
        dependencies {
          // ...
      
          // Replace the standard Performance Monitoring plugin dependency line, as follows:
          classpath ('com.google.firebase:perf-plugin:1.1.0') {
                      exclude group: 'com.google.guava', module: 'guava-jdk5'
          }
        }
      }
      
  • ניטור ביצועים מדווח על גודל המטען הכולל לבקשות רשת HTTP בהתבסס על הערך שנקבע בכותרת אורך התוכן של HTTP. לא תמיד ערך זה יכול להיות מדויק.

  • ניטור ביצועים תומך רק בתהליך העיקרי באפליקציות אנדרואיד מרובות תהליכים.

הצעדים הבאים