Android için Performance Monitoring'i kullanmaya başlayın

Başlamadan önce

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

1. adım: Uygulamanıza Performance Monitoring SDK'sını ekleyin

Performance Monitoring SDK'sını ekledikten sonra Firebase, uygulamanızın ekran oluşturma işlemiyle ilgili verileri ve uygulamanızın yaşam döngüsüyle ilgili verileri (ör. uygulama başlatma süresi) otomatik olarak toplamaya başlar. Firebase'in ağ isteklerini izlemesini sağlamak için ayrıca Performance Monitoring Gradle eklentisini (sonraki adım) eklemeniz gerekir.

  1. Modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), Android için Performance Monitoring kitaplığının bağımlılığını ekleyin. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM kullanmanızı öneririz. 

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

    // 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 kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

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

    Firebase BoM kullanmamayı tercih ederseniz her Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

    Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için BoM kullanmanızı önemle tavsiye ederiz. Bu sayede tüm sürümlerin uyumlu olması sağlanır. 

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

  2. Uygulamanızı yeniden derleyin.

2. adım: Uygulamanıza Performance Monitoring Gradle eklentisini ekleyin

Performance Monitoring Gradle eklentisini ekledikten sonra Firebase, HTTP/S ağ istekleri için otomatik olarak veri toplamaya başlar. Eklenti, @AddTrace ek açıklamasını kullanarak özel kod izlemeleri oluşturmanıza da olanak tanır.

  1. Kök düzeyindeki (proje düzeyindeki) 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.3.0" apply false

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

    // Add the dependency for the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf") version "2.0.0" 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.3.0' apply false

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

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

  2. Modül (uygulama düzeyi) 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 etkinlikleri oluşturun

SDK'yı uygulamanıza başarıyla eklediğinizde Firebase, etkinlikleri işlemeye başlar. Hâlâ yerel olarak geliştirme yapıyorsanız ilk veri toplama ve işleme için etkinlik oluşturmak üzere uygulamanızla etkileşimde bulunun.

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

  2. Firebase konsolunun Performans kontrol paneline gidin. İlk verilerinizin birkaç dakika içinde gösterilmesi gerekir.

    İlk verilerinizin gösterildiğini görmüyorsanız sorun giderme ipuçlarını inceleyin.

4. adım: (İsteğe bağlı) Performans etkinlikleriyle ilgili günlük mesajlarını görüntüleyin

  1. Uygulamanızın AndroidManifest.xml dosyasına <meta-data> öğesini aşağıdaki gibi ekleyerek derleme sırasında Performance Monitoring için hata ayıklama günlük kaydını etkinleştirin:

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

  2. Günlük mesajlarınızda hata mesajı olup olmadığını kontrol edin.

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

    adb logcat -s FirebasePerformance

  4. Performance Monitoring'nın performans etkinliklerini 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 etkinliklerini kaydetmiyorsa sorun giderme ipuçlarını inceleyin.

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

Uygulamanızdaki belirli kodlarla ilişkili performans verilerini izlemek için özel kod izleri oluşturabilirsiniz.

Özel kod izleme ile uygulamanızın belirli bir görevi veya görev grubunu (ör. bir grup resmi yükleme ya da veritabanınıza sorgu gönderme) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel kod izlemenin varsayılan metriği süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel metrikler de ekleyebilirsiniz.

Kodunuzda, Performance Monitoring SDK'sının sağladığı API'yi kullanarak özel kod izinin başlangıcını ve bitişini tanımlarsınız (ve istediğiniz özel metrikleri eklersiniz). Android uygulamalarında, @AddTrace notunu 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 başlıklı makaleyi inceleyin.

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

Bir veya daha fazla test cihazı kullanarak Performance Monitoring 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 panelinden izleyebilirsiniz.

Bilinen sorunlar

  • Performance Monitoring Gradle eklentisi v1.1.0, Guava bağımlılıklarında uyuşmazlığa neden olarak aşağıdaki hataya yol açabilir:

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

    Bu hatayı görürseniz şunlardan birini yapabilirsiniz:

    • Performance Monitoring eklentisini v1.1.1 veya sonraki bir sürüme (en son sürüm v2.0.0) yükseltin.

    • Performance Monitoring eklenti bağımlılığı satırını <project>/build.gradle.kts veya <project>/build.gradle) kök düzeyindeki (proje düzeyinde) Gradle dosyanızda 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 ağ isteklerinin toplam yük boyutunu HTTP content-length başlığında ayarlanan değere göre bildirir. Bu değer her zaman doğru olmayabilir.

  • Performance Monitoring yalnızca çok işlemli Android uygulamalarındaki ana işlemi destekler.

Sonraki adımlar