Performans İzleme sorun giderme ve SSS

iOS + Android Web

Bu sayfa, Performans İzlemeye başlamak veya Performans İzleme özelliklerini ve araçlarını kullanmak için sorun giderme ipuçları sağlar.

Sorun giderme için ilk kontroller

Aşağıdaki iki kontrol, daha fazla sorun gidermeden önce herkes için önerilen genel en iyi uygulamalardır.

1. Performans olayları için günlük mesajlarını kontrol edin

Performans İzleme SDK'sının performans olaylarını yakaladığından emin olmak için günlük mesajlarınızı kontrol edin.

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

1. Tarayıcınızın geliştirici araçları açın (örneğin, Ağ Chrome Dev Tools sekmesi veya Firefox için ağ izleyicisi ).

2. Web uygulamanızı tarayıcıda yenileyin.

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

4. Birkaç saniye sonra, bir ağ çağrısı aramaya firebaselogging.googleapis.com tarayıcınızın geliştirici araçları. Bu ağ aramasının varlığı, tarayıcının Firebase'e performans verileri gönderdiğini gösterir.

Uygulama performansı olaylarını günlüğe değilse, gözden giderme ipuçları .

2. Firebase Durum Kontrol Panelini Kontrol Edin

Kontrol Firebase Status Dashboard Firebase için veya Performans İzleme bilinen kesintisi olduğu durumda.

Performans İzlemeye Başlarken

Performans İzleme ile başladıysanız ( iOS + | Android | Web ), aşağıdaki sorun giderme ipuçları Firebase SDK tespit veya Firebase konsolunda İlk performans verileri görüntülemeye içeren sorunlarında yardımcı olabilir.

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şlangıç 10 dakika içinde, Performans pano Firebase konsol ekranların bir mesaj "SDK algılandı". Ardından, 30 dakika içinde gösterge panosu ilk işlenmiş verileri görüntüler.

Uygulamanıza SDK'nın en son sürümünü eklendi beri 10'dan fazla dakika oldu ve hala herhangi bir değişiklik görmüyorsanız, sizin günlük mesajlarını kontrol Performans İzleme olayları günlüğe emin olmak için. Gecikmeli bir SDK algılama mesajıyla ilgili sorunları gidermek için aşağıda açıklanan uygun sorun giderme adımlarını deneyin.

Uygulama olayları günlüğe kaydediyor: sorun giderme adımları

Not: Yerel olarak daha sonra SDK toplu olayları Performans İzleme periyodik Firebase gönderir. Bu, uygulama etkileşimi ile Firebase'in uygulamanızdan etkinlik bilgilerini alması arasında bir gecikme olduğu anlamına gelir.

1. Hâlâ yerel olarak geliştiriyorsanız, veri toplama için daha fazla olay oluşturmayı deneyin:

   1. Web uygulamanızı yerel bir ortamda sunun ve görüntüleyin.

   2. Siteniz için alt sayfalar yükleyerek, uygulamanızla etkileşim kurarak ve/veya ağ isteklerini tetikleyerek etkinlikler oluşturun. Sayfa yüklendikten sonra tarayıcı sekmesini en az 10 saniye açık tuttuğunuzdan emin olun.

2. Senin emin olun Firebase yapılandırma nesnesi doğru uygulamanıza eklenir ve nesne değiştirilmemiş olması. Özellikle, aşağıdakileri kontrol edin:

   • Firebase Web Uygulaması Kimliği ( appId yapılandırma nesnesi) uygulamanıza ilişkin doğrudur. Senin içinde Uygulamalarınız karttaki Firebase Uygulama Kimliğini bulmak Proje ayarlarında .

   Uygulamanızdaki yapılandırma nesnesiyle ilgili bir sorun varsa aşağıdakileri deneyin:

   1. Şu anda uygulamanızda bulunan yapılandırma nesnesini silin.

   2. Takip bu talimatları yeni yapılandırma nesnesi elde etmek ve onu web uygulamanıza ekleyin.

3. SDK günlüğü olayları ve her şey doğru kurulmuş gibi görünüyor, ama yine de (2 saat sonra) SDK bulma mesajı veya işlenmiş verileri görmüyorsanız, iletişim Firebase Destek .

Uygulama olayları günlüğe değildir: sorun giderme adımlarını

1. SDK'yı Performans İzleme doğru olduğundan emin olun başlatıldı uygulamanızda.

2. Emin SDK'yı Performans İzleme aşağıdaki bayrak yoluyla devre dışı olmadığını olun:

   • performance.instrumentationEnabled

3. Emin tarayıcınızın önbelleğe alma devre dışı olduğundan emin olun, aksi takdirde tarayıcı herhangi bir yeni enstrümantasyon ayarlarını almak olmayabilir.

4. Kapatın, ardından web sayfası sekmesini yeniden açın. Tekrar günlüğe kaydetmeyi kontrol edin.

   Performans İzleme SDK'sını uygulamanıza yeni eklediyseniz, SDK'nın çalışmaya başlaması için uygulamanızı tamamen yeniden başlatmanız gerekebilir.

5. Uygulamanızda, devre dışı herhangi bir şeyi bulamıyorsanız iletişim Firebase Destek .

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

Performans İzleme bunu göstermeden önce performans olay verilerini işleyen Performans pano .

"SDK algılandı" mesajı görüntülendi beri 24 saatten fazla oldu, ve hala veri görmüyorsanız, o zaman kontrol Firebase Status Dashboard bilinen kesintisi olduğu durumda. Hiçbir kesintisi varsa iletişim Firebase Destek .

Genel sorun giderme

SDK'yı başarıyla eklediyseniz ve uygulamanızda Performans İzleme'yi kullanıyorsanız, aşağıdaki sorun giderme ipuçları, Performans İzleme özelliklerini ve araçlarını içeren genel sorunlarda yardımcı olabilir.

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

Eğer görmüyorsanız performans etkinlikleri için günlük iletilerini aşağıdaki sorun giderme adımlarını deneyin:

1. SDK'yı Performans İzleme doğru olduğundan emin olun başlatıldı uygulamanızda.

2. Emin SDK'yı Performans İzleme aşağıdaki bayrak yoluyla devre dışı olmadığını olun:

   • performance.instrumentationEnabled

3. Emin tarayıcınızın önbelleğe alma devre dışı olduğundan emin olun, aksi takdirde tarayıcı herhangi bir yeni enstrümantasyon ayarlarını almak olmayabilir.

4. Kapatın, ardından web sayfası sekmesini yeniden açın. Tekrar günlüğe kaydetmeyi kontrol edin.

   Performans İzleme SDK'sını uygulamanıza yeni eklediyseniz, SDK'nın çalışmaya başlaması için uygulamanızı tamamen yeniden başlatmanız gerekebilir.

5. Uygulamanızda, devre dışı herhangi bir şeyi bulamıyorsanız iletişim Firebase Destek .

Performans panosunda ilk giriş gecikmesi verileri eksik

İçin veri görmüyorsanız ilk giriş gecikmesi metrik aşağıdaki sorun giderme adımlarını deneyin:

1. Performans sadece İzleme zaman ilk 5 saniye içinde web sayfasında bir kullanıcı tıkladığında sayfa yüklemesinden sonra ilk giriş gecikmesi metrik kayıtları unutmayın.

2. Uygulamanızı bu metriği ölçecek şekilde ayarladığınızdan emin olun. Metrik ilk giriş gecikmesi gerektiren manuel kurulum . Spesifik olarak, bu ölçüm için çoklu doldurma kitaplığını eklemeniz gerekir. Yükleme talimatları için kütüphanenin bakın belgeler .

   Performans İzleme'nin diğer web uygulaması ölçümlerini raporlaması için bu çoklu doldurma kitaplığının eklenmesi gerekmediğini unutmayın.

Performans panosunda özel izleme verileri eksik

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

1. Aracılığıyla aletli özel kod izlerinin ayarlarını kontrol edin İz API , özellikle aşağıda:

   • Özel kod izleri ve özel metrikler için İsimler aşağıdaki gereksinimleri karşılaması gerekir: hayır başında veya sonlarındaki boşluk, hiçbir lider çizgi ( _ ) karakteri 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.

   Kullandığınız eğer Not record() yöntemini, o zaman açıkça başlatmak veya izlemeyi durdurmak gerekmez.

2. Emin olun Performans İzleme veri toplama devre dışı değildir aşağıdaki bayrak yoluyla:

   • performance.dataCollectionEnabled

     Bu bayrak, yalnızca özel kod izleri için veri toplanmasını kontrol eder (tüm veriler değil).

3. Sizin günlük iletilerini kontrol Performans İzleme beklenen özel kod izlerini giriş emin olmak için.

4. Performans İzleme günlüğü olayları, ancak ise hiçbir veri görüntüler 24 saat sonra, kontak Firebase Destek .

Performans panosunda ağ isteği verileri eksik

Ağ isteği verileriniz eksikse aşağıdakilere dikkat edin:

• Performans İzleme, tarayıcı API'si tarafından raporlanan ağ istekleri için otomatik olarak ölçümler toplar. Bu raporlar başarısız ağ isteklerini içermez.

• 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.

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

Diğer konularla ilgili bilgi nasıl performans agrega ağ isteği verilerini izleme URL modelleri altında.

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

SSS

iOS + Android Web

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

Biz Firebase konsolunun Performans İzleme bölümünü yeniden tasarladık olduğunu Pano sekmesi anahtar ölçümlerini ve bir boşlukta tüm izleri. Yeni tasarımın bir parçası olarak, On cihazı ve Ağ sayfaları kaldırıldı.

Hesap Özeti sekmesinin altındaki izleri tablo ama metrik spesifik bir için değişim yüzdesi ederek izlerini sıralamak için yeteneği dahil olmak üzere bazı ek özelliklerle birlikte, cihaz ve Ağ sekmelerinde görüntülenen tüm aynı bilgileri yer alır. Belirli bir iz tüm ölçümlerini ve verileri görüntülemek için, izleri tabloda iz adını tıklayın.

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

• Ağ isteği izleri (hem dışı-box ve özel) - Ağ alt sekmesini istekleri
• Özel kod izleri - Özel izleri alt sekmesi
• Uygulama başlangıç, app-in-ön planda, app-in-arkaplan izleri - Özel alt sekmesini izleri
• Ekran render izleri - Ekran render alt sekmesi
• Sayfa yükleme izleri - Sayfa yük alt sekmesi

(İzleri tablo hakkında ayrıntılar ve görüntüleme metrikleri ve veriler için, konsol genel bakış sayfasını ziyaret iOS + | Android | Web ).

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

Destekler İzleme Performans uyarıları tanımlanmış eşikleri aşması metrikler için. Performans ölçümleri için bu eşik değerine sahip karışıklığı önlemek için, biz yapılandırmak eşikleri yeteneğini kaldırdık konular .

Daha küçük, ad alanlı Performance Monitoring JS SDK'sını ("bağımsız" SDK) web uygulamama nasıl eklerim?

Performans İzleme, uygulamanızdaki tek Firebase ürünüyse, aşağıdakilerle ilgileniyorsanız bağımsız Performans İzleme SDK'sını (ve aşağıdaki önerilen başlık komut dosyasını) kullanabilirsiniz:

• ad alanlı bir kitaplık kullanma
• SDK paketinizin boyutunu küçültme
• sayfanız yüklenene kadar SDK'nın başlatılmasını geciktirme

Önemli: En Firebase web uygulamaları için, şiddetle kullanmanızı tavsiye Firebase JS SDK sürüm 9 aracılığıyla npm .
Ayrıca tarafından bir modül paketleyici UÖMlere kullanarak , sen SDK İzleme bağımsız Performans kullanmaktan daha daha da küçük bir SDK paketi boyutunu elde edebilirsiniz.

Uygulamanıza bağımsız Performance Monitoring SDK'sını dahil etmek ve başlatılmasını sayfanız yüklendikten sonraya ertelemek için:

1. Dizin dosyanızın başlığına aşağıdaki komut dosyasını ekleyin.
2. Uygulamanızın eklemek için emin olun Firebase proje yapılandırma nesnesi .

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

nerede,

• performance_standalone ise 'https://www.gstatic.com/firebasejs/9.6.0/firebase-performance-standalone.js'
• firebaseConfig uygulamanızın olan Firebase yapılandırma nesnesi

Yukarıdaki komut dosyası eş zamansız bağımsız SDK sonra pencerenin ardından Firebase başlatır yükler onload olay yangınlar. Bu taktik SDK üzerinde yapacağı etkiyi azaltır sayfa yükleme metrikleri size SDK başlatmak zaman tarayıcı zaten yükleme ölçümlerini bildirmiştir beri.

Not: SDK'yı İzleme bağımsız Performansını kullanırken bağımsız SDK zaten kendi hafif ağırlık Firebase çekirdek SDK içermektedir olarak, açıkça Firebase çekirdek SDK içermez.

Bağımsız Performance Monitoring SDK ve başlık komut dosyası hakkında bilgi edinin

Bu bağımsız SDK, boyut için optimize edilmiştir; Gzipli, 10kb civarında. Firebase Performance Monitoring'in tüm işlevlerinin yanı sıra minimum bir Firebase çekirdek SDK işlevselliği kümesine de sahiptir.

Firebase Performans İzleme kullanır fetch ve Promise eski tarayıcılarda kullanılamaz API'ler. Bu API'ler için çoklu dolgular, standart Firebase Performance Monitoring JS SDK'sına dahil edilmiştir, ancak boyutu azaltmak için bağımsız SDK'dan çıkarılmıştır.

Performans İzleme SDK üzerine kısmen dayanır Kaynak Zamanlama API tarayıcıdan sayfa yükleme ölçümlerini elde etmek.

Aşağıdaki kod parçası, ardından SDK'nın başlatılmasını geciktiren başlık komut dosyasını bozar:

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

nerede,

• performance_standalone ise 'https://www.gstatic.com/firebasejs/9.6.0/firebase-performance-standalone.js'
• firebaseConfig uygulamanızın olan Firebase yapılandırma nesnesi

Gerçek zamanlıya yakın veri işleme ve görüntüleme

"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şleme yararlanmak için, emin uygulamanız kullandığı yapmak gerçek zamanlı uyumlu bir SDK sürümü .

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 sonrası
• tvOS - v8.9.0 veya sonrası
• Android - v19.0.10 veya sonrası (Firebase Android BoM v26.1.0 veya sonrası ya)
• Web - v7.14.0 veya sonrası

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 sonrası
• tvOS - v8.9.0 veya sonrası
• Android - v19.0.10 veya sonrası (Firebase Android BoM v26.1.0 veya sonrası ya)
• Web - v7.14.0 veya sonrası

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.

Eğer (daha az kabaca 36 saat eski yerine) son veriler arıyorsanız Ancak, daha sonra verileri görüntülenen gerçek zamanlı uyumlu SDK sürümü kullanarak uygulama örneklerinin kullanıcılarından olduğunu. Olmayan yeni veriler olsa da, uygulamanızın tüm sürümleri performans verilerini içerir.

Firebase Desteği ile İletişime Geçme

Eğer varsa Firebase Destek birimine ulaşıp , her zaman Firebase Uygulama Kimliğini arasındadır. Senin içinde Uygulamalarınız karttaki Firebase Uygulama Kimliğini bulmak Proje ayarlarında .