Android için Performans İzlemeyi kullanmaya başlayın

Sen başlamadan önce

Henüz yapmadıysanız, Firebase'i Android projenize ekleyin .

1. Adım : Performans İzleme SDK'sını uygulamanıza ekleyin

Performance Monitoring SDK'yı ekledikten sonra Firebase, uygulamanızın ekran oluşturması için verileri ve uygulamanızın yaşam döngüsüyle ilgili verileri ( uygulama başlangıç ​​zamanı gibi) otomatik olarak toplamaya başlar. Firebase'in ağ isteklerini izlemesini sağlamak için Performance Monitoring Gradle eklentisini de eklemelisiniz (sonraki adım).

  1. Modül (uygulama düzeyi) Gradle dosyanızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle ), Performans İzleme için bağımlılığı ekleyin Android kitaplığı. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

    Kotlin+KTX

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.3.1"))

    // Add 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'yi kullandığınızda, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

    (Alternatif) BoM kullanmadan Firebase kitaplığı bağımlılıkları ekleyin

    Firebase BoM'yi kullanmamayı seçerseniz, her bir Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.

    Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi kullanmanızı kesinlikle öneririz.

    dependencies {
    // Add 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.4.1")
}

    Java

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.3.1"))

    // Add 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'yi kullandığınızda, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

    (Alternatif) BoM kullanmadan Firebase kitaplığı bağımlılıkları ekleyin

    Firebase BoM'yi kullanmamayı seçerseniz, her bir Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.

    Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi kullanmanızı kesinlikle öneririz.

    dependencies {
    // Add 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.4.1")
}

  2. Uygulamanızı yeniden derleyin.

Adım 2 : Performans İzleme Gradle eklentisini uygulamanıza ekleyin

Performance Monitoring Gradle eklentisini ekledikten sonra Firebase, HTTP/S ağ istekleri için otomatik olarak veri toplamaya başlar. Eklenti ayrıca, @AddTrace ek açıklamasını kullanarak özel kod izlemeleri yapmanızı sağlar.

  1. Kök düzeyinde (proje düzeyinde) Gradle dosyanıza ( <project>/build.gradle.kts veya <project>/build.gradle ), Performance Monitoring Gradle eklentisini ekleyin:

    Kotlin

    plugins {
    // To benefit from the latest Performance Monitoring plugin features,
    // update your Android Gradle plugin dependency to at least v3.4.0
    id("com.android.application") version "7.2.0" apply false

    // Make sure that you have the Google services Gradle plugin dependency
    id("com.google.gms.google-services") version "4.3.15" apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf") version "1.4.2" apply false
}

    Groovy

    plugins {
    // To benefit from the latest Performance Monitoring plugin features,
    // update your Android Gradle plugin dependency to at least v3.4.0
    id 'com.android.application' version '7.2.0' apply false

    // Make sure that you have the Google services Gradle plugin dependency
    id 'com.google.gms.google-services' version '4.3.15' apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf' version '1.4.2' apply false
}

  2. Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle ), Performance Monitoring Gradle eklentisini ekleyin:

    Kotlin

    plugins {
    id("com.android.application")

    // Make sure that you have the Google services Gradle plugin
    id("com.google.gms.google-services")

    // Add the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf")
    ...
}

    Groovy

    plugins {
    id 'com.android.application'

    // Make sure that you have the Google services Gradle plugin
    id 'com.google.gms.google-services'

    // Add the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf'
    ...
}

  3. Uygulamanızı yeniden derleyin.

3. Adım : İlk veri gösterimi için performans olayları oluşturun

SDK'yı uygulamanıza başarıyla eklediğinizde Firebase olayları işlemeye başlar. Hâlâ yerel olarak geliştiriyorsanız, ilk veri toplama ve işlemeye yönelik etkinlikler oluşturmak için uygulamanızla etkileşime geçin.

  1. Uygulamanızı birkaç kez arka plan ve ön plan arasında değiştirerek, ekranlar arasında gezinerek ve/veya ağ isteklerini tetikleyerek uygulamanızla etkileşim kurarak olaylar oluşturun.

  2. Firebase konsolunun Performans panosuna gidin. İlk veri ekranınızı birkaç dakika içinde görmelisiniz.

    İlk verilerinizin bir görüntüsünü görmüyorsanız, sorun giderme ipuçlarını gözden geçirin.

4. Adım : (İsteğe bağlı) Performans etkinlikleri için günlük mesajlarını görüntüleyin

  1. Uygulamanızın AndroidManifest.xml dosyasına aşağıdaki gibi bir <meta-data> öğesi ekleyerek oluşturma zamanında Performans İzleme için hata ayıklama günlüğünü etkinleştirin:

    <application>
    <meta-data
      android:name="firebase_performance_logcat_enabled"
      android:value="true" />
</application>

  2. Herhangi bir hata mesajı için günlük mesajlarınızı kontrol edin.

  3. Performance Monitoring, günlük mesajlarını FirebasePerformance ile etiketler. Logcat filtrelemeyi kullanarak, aşağıdaki komutu çalıştırarak süre izlemeyi ve HTTP/S ağ isteği günlüğünü özel olarak görüntüleyebilirsiniz:

    adb logcat -s FirebasePerformance

  4. Performance Monitoring'in performans olaylarını günlüğe kaydettiğini gösteren aşağıdaki günlük türlerini kontrol edin:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  5. Verilerinizi Firebase konsolunda görüntülemek için URL'yi tıklayın. Verilerin kontrol panelinde güncellenmesi birkaç dakika sürebilir.

Uygulamanız performans olaylarını günlüğe kaydetmiyorsa sorun giderme ipuçlarını inceleyin.

5. Adım : (İsteğe bağlı) Belirli kod için özel izleme ekleyin

Uygulamanızdaki belirli kodla ilişkili performans verilerini izlemek için özel kod izlemeleri kullanabilirsiniz.

Özel bir kod izleme ile, uygulamanızın belirli bir görevi veya bir dizi görüntüyü yükleme veya veritabanınızı sorgulama gibi bir dizi görevi tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel bir kod izleme için varsayılan ölçüm süresidir, ancak önbellek isabetleri ve bellek uyarıları gibi özel ölçümler de ekleyebilirsiniz.

Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'yi kullanarak özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız (ve istediğiniz özel ölçümleri eklersiniz). Android uygulamaları için, @AddTrace ek açıklamasını kullanarak belirli yöntemlerin süresini de izleyebilirsiniz.

Bu özellikler ve bunları uygulamanıza nasıl ekleyeceğiniz hakkında daha fazla bilgi edinmek için Belirli kod için izleme ekleme sayfasını ziyaret edin.

6. Adım : Uygulamanızı dağıtın ve ardından sonuçları inceleyin

Bir veya daha fazla test cihazı kullanarak Performance Monitoring'i doğruladıktan sonra, uygulamanızın güncellenmiş sürümünü kullanıcılarınıza dağıtabilirsiniz.

Performans verilerini, Firebase konsolunun Performans kontrol panelinde izleyebilirsiniz.

Bilinen Sorunlar

  • Performance Monitoring Gradle eklentisi v1.1.0, Guava bağımlılıklarında uyumsuzluğa neden olarak aşağıdaki hataya neden olabilir:

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

    Bu hatayı görürseniz, şunları yapabilirsiniz:

    • Performance Monitoring eklentisini v1.1.1 veya sonraki bir sürüme yükseltin (en yeni sürüm v1.4.2'dir).

    • Kök düzeyi (proje düzeyi) Gradle dosyanızdaki ( <project>/build.gradle.kts veya <project>/build.gradle ) Performance Monitoring eklentisi bağımlılık satırını aşağıdaki gibi değiştirin:

      Kotlin

      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")
    }
  }
}

      Groovy

      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'
    }
  }
}

  • Performance Monitoring, HTTP içerik uzunluğu başlığında ayarlanan değere dayalı olarak HTTP ağ istekleri için toplam yük boyutunu bildirir. Bu değer her zaman doğru olmayabilir.

  • Performans İzleme yalnızca çok işlemli Android uygulamalarında ana işlemi destekler.

Sonraki adımlar