Performans İzleme sorun giderme ve SSS

Performans olayları için günlük mesajları nasıl görüntülenir?

1. Uygulamanızın AndroidManifest.xml dosyasına aşağıdaki gibi bir <meta-data> öğesi ekleyerek 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. Performans İzleme, 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üğünü görüntüleyebilirsiniz:

   adb logcat -s FirebasePerformance

4. Performans İzleme'nin 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. Firebase konsolunda verilerinizi 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 kaydedmiyorsa sorun giderme ipuçlarını gözden geçirin.

Uygulamaya SDK eklendi, ancak konsol hala SDK eklediğini söylüyor

Firebase, uygulamanızdan etkinlik bilgileri (ör. uygulama etkileşimleri) aldığında, Performans İzleme SDK'sını uygulamanıza başarıyla ekleyip eklemediğinizi algılayabilir. Genellikle uygulamanızı başlattıktan sonraki 10 dakika içinde, Firebase konsolunun Performans panosunda bir "SDK algılandı" mesajı görüntülenir. Ardından, 30 dakika içinde gösterge tablosu ilk işlenmiş verileri görüntüler.

Uygulamanıza SDK'nın en son sürümünü eklemenizin üzerinden 10 dakikadan fazla zaman geçtiyse ve hâlâ herhangi bir değişiklik görmüyorsanız, Performans İzleme'nin olayları günlüğe kaydettiğinden emin olmak için günlük mesajlarınızı kontrol edin . Gecikmeli bir SDK algılama mesajıyla ilgili sorunları gidermek için aşağıda açıklanan uygun sorun giderme adımlarını deneyin.

Konsol, SDK'nın algılandığını söylüyor, ancak hiçbir veri görüntülenmiyor

Performans İzleme, performans olay verilerini Performans panosunda görüntülemeden önce işler.

"SDK algılandı" mesajının görüntülenmesinin üzerinden 24 saatten fazla zaman geçtiyse ve hâlâ veri görmüyorsanız, bilinen bir kesinti olması ihtimaline karşı Firebase Status Dashboard'u kontrol edin. Kesinti yoksa Firebase Destek ile iletişime geçin .

Uygulama, performans olaylarını günlüğe kaydetmiyor

Performans olayları için günlük mesajları görmüyorsanız, aşağıdaki sorun giderme adımlarını deneyin:

1. Performance Monitoring Gradle eklentisinin kurulumunu aşağıdaki gibi kontrol edin:

   1. Eklentiyi doğru eklediğinizden emin olun. Özellikle, aşağıdakileri kontrol edin:

      • Eklentiyi ( apply plugin: 'com.google.firebase.firebase-perf' ) modülünüze (uygulama düzeyi) build.gradle dosyanıza eklediniz.
      • Eklenti için sınıf yolu bağımlılığını ( classpath 'com.google.firebase:perf-plugin:1.4.1' ) proje düzeyindeki build.gradle dosyanıza dahil ettiniz.

   2. Eklentinin aşağıdaki işaretlerden biri aracılığıyla devre dışı bırakılmadığından emin olun:

      • modülünüz (uygulama düzeyi) build.gradle dosyanızda instrumentationEnabled
      • firebasePerformanceInstrumentationEnabled dosyanızda gradle.properties

2. AndroidManifest.xml dosyanızdaki aşağıdaki işaretlerden herhangi biri aracılığıyla Performans İzleme SDK'sının devre dışı bırakılmadığını kontrol edin:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Çalışma zamanında Performans İzleme'nin devre dışı bırakılmadığından emin olun.

4. Uygulamanızda devre dışı bırakılmış hiçbir şey bulamazsanız Firebase Destek ile iletişime geçin .

Performans panosunda ekran izleme verileri eksik

Ekran işleme izleri için veriler eksikse, aşağıdaki sorun giderme adımlarını deneyin:

1. Android SDK'nın (v20.0.4) en son sürümünü kullandığınızdan emin olun. Ekran işleme izleri yalnızca v15.2.0 veya sonraki sürümlerde kullanılabilir.

2. Bir ekran için Donanım Hızlandırmasını manuel olarak devre dışı bırakmadığınızdan emin olun.

3. DexGuard veya Jack kullanmadığınızdan emin olun. Performans İzleme, bu araç zincirleriyle uyumlu değildir.

   • DexGuard, uygulama başlatma, ön planda uygulama ve arka planda uygulama izlerinin otomatik olarak toplanmasını devre dışı bırakır. Ancak, uygulamanız DexGuard'ı kullanıyorsa, herhangi bir özel kod izlemesi normal şekilde davranmalıdır.

   • Jack kullanımdan kaldırılmıştır ve genellikle uygulamanızda kullanılmamalıdır.

Performans panosunda özel izleme verileri eksik

Otomatik olarak toplanan izler için performans verilerini görüyor musunuz, ancak özel kod izleri için görmüyor musunuz? Aşağıdaki sorun giderme adımlarını deneyin:

1. İzleme API'si aracılığıyla özel kod izlemeleri uyguladıysanız, özellikle aşağıdakiler olmak üzere izlemelerin kurulumunu kontrol edin:

   • Özel kod izleri ve özel metrikler için adlar aşağıdaki gereksinimleri karşılamalıdır: Başında veya sonunda boşluk yok, baştaki alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 32 karakterdir.
   • Tüm izler başlatılmalı ve durdurulmalıdır. Başlatılmamış, durdurulmamış veya başlatılmadan önce durdurulmuş hiçbir izleme kaydedilmeyecektir.

2. @AddTrace notasyonu aracılığıyla özel kod izlemeleri uyguladıysanız, Performance Monitoring Gradle eklentisinin kurulumunu kontrol edin:

   1. Eklentiyi doğru eklediğinizden emin olun. Özellikle, aşağıdakileri kontrol edin:

      • Eklentiyi ( apply plugin: 'com.google.firebase.firebase-perf' ) modülünüze (uygulama düzeyi) build.gradle dosyanıza eklediniz.
      • Eklenti için sınıf yolu bağımlılığını ( classpath 'com.google.firebase:perf-plugin:1.4.1' ) proje düzeyindeki build.gradle dosyanıza dahil ettiniz.

   2. Eklentinin aşağıdaki işaretlerden biri aracılığıyla devre dışı bırakılmadığından emin olun:

      • modülünüz (uygulama düzeyi) build.gradle dosyanızda instrumentationEnabled
      • firebasePerformanceInstrumentationEnabled dosyanızda gradle.properties

3. Performans İzleme'nin beklenen özel kod izlerini günlüğe kaydettiğinden emin olmak için günlük iletilerinizi kontrol edin .

4. Performans İzleme, olayları günlüğe kaydediyorsa ancak 24 saat sonra hiçbir veri görüntülenmiyorsa, Firebase Desteği ile iletişime geçin .

Performans panosunda ağ isteği verileri eksik

Ağ isteği verileriniz eksikse aşağıdaki sorun giderme adımlarını deneyin:

1. Android uygulamaları için Performance Monitoring Gradle eklentisi, HTTP/S ağ isteklerinin otomatik olarak izlenmesini sağlayan enstrümantasyon sağlar. Aşağıdakileri kontrol et:

   1. Eklentiyi doğru eklediğinizden emin olun. Özellikle, aşağıdakileri kontrol edin:

      • Eklentiyi ( apply plugin: 'com.google.firebase.firebase-perf' ) modülünüze (uygulama düzeyi) build.gradle dosyanıza eklediniz.
      • Eklenti için sınıf yolu bağımlılığını ( classpath 'com.google.firebase:perf-plugin:1.4.1' ) proje düzeyindeki build.gradle dosyanıza dahil ettiniz.

   2. Eklentinin aşağıdaki işaretlerden biri aracılığıyla devre dışı bırakılmadığından emin olun:

      • modülünüz (uygulama düzeyi) build.gradle dosyanızda instrumentationEnabled
      • firebasePerformanceInstrumentationEnabled dosyanızda gradle.properties

2. Ağ kitaplığı uyumsuzluğunu kontrol edin. Performans İzleme, aşağıdaki ağ kitaplıklarını kullanan ağ istekleri için otomatik olarak ölçümler toplar: OkHttp 3.xx, Java'nın URLConnection ve Apache HttpClient.

   Ağ istekleri için özel izleme ekleyebileceğinizi unutmayın.

3. Aşağıdakilerin farkında olun:

   • Kodunuzun davranışına ve kodunuz tarafından kullanılan ağ kitaplıklarına bağlı olarak, Performans İzleme yalnızca tamamlanan ağ isteklerini rapor edebilir. Bu, açık bırakılan HTTP/S bağlantılarının raporlanmayabileceği anlamına gelir.

   • Performans İzleme, DexGuard ve Jack ile uyumlu değildir.

     • DexGuard, HTTP/S ağ isteklerinin izlenmesini devre dışı bırakır.
     • Jack kullanımdan kaldırılmıştır ve genellikle uygulamanızda kullanılmamalıdır.

   • Performans İzleme, geçersiz Content-Type başlıklarına sahip ağ istekleri hakkında rapor oluşturmaz. Ancak, Content-Type başlıkları olmayan ağ istekleri yine de kabul edilecektir.

Ağ isteği verileri beklendiği gibi toplanmıyor

Performans İzleme'nin ağ isteği verilerini URL kalıpları altında nasıl topladığı hakkında daha fazla bilgi edinin.

Ayrıca özel URL kalıplarını da deneyebilirsiniz!

Konsoldaki Cihazda ve Ağ sekmelerine ne oldu? Bu sayfalardaki izleri nasıl görebilirim?

Firebase konsolunun Performans İzleme bölümünü yeniden tasarladık, böylece Pano sekmesi temel metriklerinizi ve tüm izlerinizi tek bir alanda gösterir. Yeniden tasarımın bir parçası olarak Cihazda ve Ağ sayfalarını kaldırdık.

Gösterge Tablosu sekmesinin altındaki izleme tablosu, Cihazda ve Ağ sekmelerinde görüntülenen bilgilerin tümüne sahiptir, ancak izlemelerinizi belirli bir ölçüm için yüzde değişikliğine göre sıralama yeteneği de dahil olmak üzere bazı ek özellikler içerir. Belirli bir izleme için tüm metrikleri ve verileri görüntülemek için izleme tablosundaki izleme adını tıklayın.

İzlerinizi, izleme tablosunun aşağıdaki alt sekmelerinde görüntüleyin:

• Ağ isteği izleri (hem kullanıma hazır hem de özel) - Ağ istekleri alt sekmesi
• Özel kod izleri — Özel izler alt sekmesi
• Uygulama başlangıcı, ön planda uygulama, arka planda uygulama izleri — Özel izlemeler alt sekmesi
• Ekran işleme izleri — Ekran işleme alt sekmesi
• Sayfa yükleme izleri — Sayfa yükleme alt sekmesi

İzler tablosu ve metrikleri ve verileri görüntüleme hakkında ayrıntılar için konsola genel bakış sayfasını ziyaret edin ( iOS+ | Android | Web ).

Konsoldaki sorunlar için eşik belirleme yeteneğine ne oldu?

Performans İzleme, tanımlanan eşikleri aşan ölçümler için uyarıları destekler. Performans metrikleri için bu yapılandırılabilir eşiklerle karışıklığı önlemek için, sorunlar için eşikleri yapılandırma özelliğini kaldırdık.

Performans İzleme Gradle eklentisini etkinleştirdikten sonra derleme sürelerim yüksek. Bunu nasıl iyileştirebilirim?

Android için Performans İzleme, HTTP/S ağ isteklerini izleme gibi kullanıma hazır bazı özellikler sağlamak için bayt kodu araçlarını kullanır. Derlemenin bir parçası olarak süreç, uygulamanızın ağ isteği performansını ölçmek için çok önemli olan kodun enstrümantasyonu için uygulamanızın tüm sınıfları (bağımlılıklar dahil) boyunca yineleme gerektirir.

Yapım süresindeki artışa katkıda bulunan bazı önemli faktörler şunlardır:

• Sınıf veya dosya sayısı
• Bu sınıfların her birinin boyutu (kod satırları)
• Makine yapılandırmanız
• İlk derlemeye karşı sonraki derleme (sonraki derlemeler genellikle ilk derlemeden daha hızlıdır)

Oluşturma sürenizi optimize etmek için kodunuzu modülerleştirmeyi düşünün.

Performance Monitoring eklentisinin 1.3.3 sürümünden başlayarak, artımlı derleme işleme ve kitaplık girdilerinin önbelleğe alınmasında önemli iyileştirmeler yapmaya odaklandık. En son derleme süresi iyileştirmelerini almak için eklentinin en son sürümünü (v1.4.1) kullandığınızdan emin olun .

Uzun derleme sürelerinden kaçınmak istiyorsanız, hata ayıklama derlemeleriniz için Performans İzleme eklentisini yerel olarak devre dışı bırakabileceğinizi unutmayın. Ancak, uygulamanızdaki ağ istekleri için performans ölçümlerinin kaçırılmasına neden olabileceğinden, bu yaklaşım üretim yapıları için önerilmez.

Performans İzleme verilerimin BigQuery'ye dışa aktarılması beklenenden uzun sürüyor. gerçek zaman değil mi

Firebase Performance Monitoring için BigQuery entegrasyonunu etkinleştirdiyseniz verileriniz günün sonundan (Pasifik Saati) 12 ila 24 saat sonra BigQuery'ye aktarılır.

Örneğin, 19 Nisan'a ait veriler 20 Nisan'da saat 12.00 ile gece yarısı arasında BigQuery'de kullanılabilir (tüm tarihler ve saatler Pasifik Saati'dir).

"Gerçek zamanlıya yakın" performans verileri ne anlama geliyor?

Firebase Performance Monitoring, toplanan performans verilerini geldiği anda işler ve bu da Firebase konsolunda neredeyse gerçek zamanlı veri görüntülemesiyle sonuçlanır. İşlenen veriler, toplandıktan sonra birkaç dakika içinde konsolda görüntülenir, bu nedenle "neredeyse gerçek zamanlı" terimi.

Neredeyse gerçek zamanlı veri işlemeden yararlanmak için uygulamanızın gerçek zamanlı uyumlu bir SDK sürümü kullandığından emin olun.

Uygulamam için neredeyse gerçek zamanlı performans verilerini nasıl alabilirim?

Gerçek zamanlıya yakın veri işlemeden yararlanmak için uygulamanızın gerçek zamanlı veri işlemeyle uyumlu bir Performance Monitoring SDK sürümü kullandığından emin olmanız yeterlidir.

Bunlar gerçek zamanlı uyumlu SDK sürümleridir:

• iOS — v7.3.0 veya üstü
• tvOS — v8.9.0 veya üstü
• Android — v19.0.10 veya üzeri (veya Firebase Android BoM v26.1.0 veya üzeri)
• Web — v7.14.0 veya üstü

Her zaman SDK'nın en son sürümünü kullanmanızı önerdiğimizi unutmayın, ancak yukarıda listelenen herhangi bir sürüm, Performans İzleme'nin verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlayacaktır.

Performance Monitoring SDK'nın hangi sürümleri gerçek zamanlı uyumlu olarak kabul edilir?

Bunlar, gerçek zamanlı veri işleme ile uyumlu SDK sürümleridir:

• iOS — v7.3.0 veya üstü
• tvOS — v8.9.0 veya üstü
• Android — v19.0.10 veya üzeri (veya Firebase Android BoM v26.1.0 veya üzeri)
• Web — v7.14.0 veya üstü

Her zaman SDK'nın en son sürümünü kullanmanızı önerdiğimizi unutmayın, ancak yukarıda listelenen herhangi bir sürüm, Performans İzleme'nin verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlayacaktır.

Uygulamamı gerçek zamanlı uyumlu bir SDK sürümü kullanacak şekilde güncellemezsem ne olur?

Uygulamanız gerçek zamanlı uyumlu bir SDK sürümü kullanmıyorsa uygulamanızın tüm performans verilerini Firebase konsolunda görmeye devam edeceksiniz. Bununla birlikte, performans verilerinin görüntülenmesi, toplandığı andan itibaren yaklaşık 36 saat gecikecektir.

Gerçek zamanlı uyumlu bir SDK sürümüne güncelledim, ancak bazı kullanıcılarım hala uygulamamın eski sürümlerini kullanıyor. Firebase konsolunda performans verilerini görmeye devam edecek miyim?

Evet! Bir uygulama örneğinin kullandığı SDK sürümü ne olursa olsun, tüm kullanıcılarınızdan gelen performans verilerini görürsünüz.

Ancak, yakın tarihli verilere bakıyorsanız (yaklaşık 36 saatten daha eski), bu durumda görüntülenen veriler, gerçek zamanlı uyumlu bir SDK sürümü kullanan uygulama örneklerinin kullanıcılarına aittir. Ancak yakın zamana ait olmayan veriler, uygulamanızın tüm sürümlerine ait performans verilerini içerir.