Performance Monitoring ile ilgili sorunları giderme ve SSS

Performans etkinlikleriyle ilgili günlük mesajlarını görüntüleme

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

2. Tarayıcıda web uygulamanızı yenileyin.

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

4. Birkaç saniye sonra, tarayıcınızın geliştirici araçlarında firebaselogging.googleapis.com adresine yapılan bir ağ çağrısı olup olmadığını kontrol edin. Bu ağ çağrısının varlığı, tarayıcının Firebase'e performans verileri gönderdiğini gösterir.

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

SDK'yı uygulamaya ekledim ancak konsolda SDK eklemem gerektiği

Firebase, uygulamanızdan etkinlik bilgileri (ör. uygulama etkileşimleri) aldığında Performance Monitoring 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 kontrol panelinde "SDK algılandı" mesajı gösterilir. Ardından, kontrol panelinde ilk işlenen veriler 30 dakika içinde gösterilir.

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

Konsolda SDK'nın algılandığı belirtiliyor ancak veri gösterilmiyor

Performance Monitoring, performans etkinliği verilerini Performans kontrol panelinde görüntülemeden önce işler.

"SDK algılandı" mesajının gösterilmesinin üzerinden 24 saatten fazla zaman geçtiyse ve hâlâ veri görmüyorsanız bilinen bir kesinti olup olmadığını öğrenmek için Firebase Durum Kontrol Paneli'ni kontrol edin. Kesinti yoksa Firebase Destek Ekibi ile iletişime geçin.

Uygulama, performans etkinliklerini günlüğe kaydetmiyor

Performans etkinlikleriyle ilgili günlük mesajlarını görmüyorsanız aşağıdaki sorun giderme adımlarını deneyin:

1. Performance Monitoring SDK'sının uygulamanızda doğru şekilde başlatıldığından emin olun.

2. Performance Monitoring SDK'sının aşağıdaki işaret aracılığıyla devre dışı bırakılmadığından emin olun:

   • performance.instrumentationEnabled

3. Tarayıcınızın önbelleğe alma özelliğinin devre dışı olduğundan emin olun. Aksi takdirde tarayıcı yeni enstrümantasyon ayarlarını alamayabilir.

4. Web sayfası sekmesini kapatıp yeniden açın. Günlüğe kaydetme işlemini tekrar kontrol edin.

   Performance Monitoring 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ışı bırakılmış bir şey bulamıyorsanız Firebase Destek Ekibi ile iletişime geçin.

Performans kontrol panelinde ilk giriş gecikmesi verileri eksik

İlk giriş gecikmesi metriği ile ilgili verileri görmüyorsanız aşağıdaki sorun giderme adımlarını deneyin:

1. Performance Monitoring'ün yalnızca kullanıcı sayfa yüklendikten sonraki ilk 5 saniye içinde web sayfasını tıkladığında ilk giriş gecikmesi metriğini kaydettiğini unutmayın.

2. Uygulamanızı bu metriği ölçecek şekilde ayarladığınızdan emin olun. İlk giriş gecikmesi metriği için manuel kurulum gerekir. Daha açık belirtmek gerekirse, bu metrik için polyfill kitaplığını eklemeniz gerekir. Yükleme talimatları için kitaplığın dokümanlarına bakın.

   Performance Monitoring'ün diğer web uygulaması metriklerini bildirmesi için bu polyfill kitaplığının eklenmesi gerekmez.

Performans kontrol panelinde özel izleme verileri eksik

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

1. Trace API aracılığıyla enstrümante edilen özel kod izlemelerinin kurulumunu, özellikle de aşağıdakileri kontrol edin:

   • Özel kod izlemelerinin ve özel metriklerin adları aşağıdaki koşulları karşılamalıdır: Başında veya sonunda boşluk olmamalıdır, baştan kısa çizgi (_) karakteri olmamalıdır ve en fazla 32 karakter uzunluğunda olmalıdır.
   • Tüm izlemeler başlatılmalı ve durdurulmalıdır. Başlatılmayan, durdurulmayan veya başlatılmadan önce durdurulan hiçbir izleme günlüğe kaydedilmez.

   record() yöntemini kullanıyorsanız izlemenizi açıkça başlatmanız veya durdurmanız gerekmediğini unutmayın.

2. Aşağıdaki işaret aracılığıyla Performance Monitoring veri toplama özelliğinin devre dışı bırakılmadığından emin olun:

   • performance.dataCollectionEnabled

     Bu işaret, yalnızca özel kod izleriyle ilgili verilerin toplanmasını (tüm veriler değil) kontrol eder.

3. Performance Monitoring'nin beklenen özel kod izlerini kaydettiğinden emin olmak için günlük mesajlarınızı kontrol edin.

4. Performance Monitoring etkinlikleri günlüğe kaydediyorsa ancak 24 saat sonra hiçbir veri görüntülenmiyorsa Firebase Destek Ekibi ile iletişime geçin.

Performans gösterge tablosunda ağ isteği verileri eksik

Ağ isteği verileri eksikse aşağıdakileri göz önünde bulundurun:

• Performance Monitoring, tarayıcı API'si tarafından raporlanan ağ istekleriyle ilgili metrikleri otomatik olarak 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 Performance Monitoring yalnızca tamamlanan ağ isteklerini raporlayabilir. Bu, açık bırakılan HTTP/S bağlantılarının raporlanmayacağı anlamına gelir.

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

Performance Monitoring'ın URL kalıpları altında ağ istek verilerini nasıl topladığı hakkında daha fazla bilgi edinin.

Özel URL kalıplarını da deneyebilirsiniz.

Proje ana sayfasındaki Performans kartında En Önemli Sorunlar ne oldu?

Belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren uyarıları yakın zamanda kullanıma sunmamızın ardından Önemli Sorunlar'ı Son Uyarılar ile değiştirdik. Sorunlar artık kullanımdan kaldırıldı ve uyarılarla değiştirildi.

Performans kartının üst kısmındaki uygulama seçici, uyarı girişlerini Son Uyarılar altında filtreler. Yalnızca seçilen uygulamalarla ilgili en son üç uyarı gösterilir.

Uyarılar hakkında daha fazla bilgi edinmek için Performans sorunlarıyla ilgili uyarı oluşturma başlıklı makaleyi inceleyin.

Konsolda sorunlar için eşik belirleme özelliğine ne oldu?

Performance Monitoring, tanımlanan eşikleri aşan metrikler için uyarılar destekler. Performans metrikleri için yapılandırılabilir bu eşiklerle ilgili karışıklığı önlemek amacıyla sorunlar için eşik yapılandırmayı kaldırdık.

Firebase konsolundaki Ayrıntılar ve Metrikler bilgilerine ne oldu?

Sorun giderme sürecinizi iyileştirmek için Ayrıntılar ve Metrikler sayfalarını yeni tasarlanmış, merkezi bir kullanıcı arayüzüyle (UA) değiştirdik. Bu yeni sorun giderme kullanıcı arayüzü, Ayrıntılar ve Metrikler'in sunduğu temel işlevleri sunar. Sorun giderme hakkında daha fazla bilgi edinmek için Belirli bir izleme için daha fazla veri görüntüleme başlıklı makaleyi inceleyin.

Örnek sayısı neden beklediğim gibi değil?

Performance Monitoring, uygulamanızın kullanıcı cihazlarından performans verilerini toplar. Uygulamanızın çok sayıda kullanıcısı varsa veya uygulama çok fazla performans etkinliği oluşturuyorsa Performance Monitoring, işlenen etkinliklerin sayısını azaltmak için veri toplamayı bir cihaz alt kümesiyle sınırlayabilir. Bu sınırlar, daha az etkinlik olsa bile metrik değerlerinin kullanıcınızın uygulama deneyimini temsil etmesini sağlayacak kadar yüksektir.

Performance Monitoring, toplanan veri hacmini yönetmek için aşağıdaki örnekleme seçeneklerini kullanır:

• Cihaz üzerinde hız sınırlaması: Bir cihazın ani iz patlamaları göndermesini önlemek için cihazdan gönderilen kod ve ağ isteği izlerinin sayısını 10 dakikada 300 etkinlikle sınırlandırırız. Bu yaklaşım, cihazı büyük miktarda performans verisi gönderebilen döngüsel enstrümasyonlardan korur ve tek bir cihazın performans ölçümlerini çarpıtmasını önler.

• Dinamik örnekleme: Performance Monitoring, tüm uygulama kullanıcıları arasında uygulama başına günlük olarak sınırlı sayıda kod izleme ve ağ isteği izleme toplar. Rastgele bir cihazın izleme yakalayıp göndermesi gerekip gerekmediğini belirlemek için cihazlarda dinamik bir örnekleme oranı (Firebase Remote Config kullanılarak) alınır. Örnekleme için seçilmeyen cihazlar hiçbir etkinlik göndermez. Dinamik örnekleme hızı uygulamaya özeldir ve toplanan verilerin toplam hacminin sınırın altında kalmasını sağlayacak şekilde ayarlanır.

  Kullanıcı oturumları, kullanıcının cihazından ek ve ayrıntılı veriler gönderir. Bu verileri yakalamak ve göndermek için daha fazla kaynak gerekir. Performance Monitoring, kullanıcı oturumlarının etkisini en aza indirmek için oturum sayısını da kısıtlayabilir.

• Sunucu tarafı hız sınırlaması: Uygulamaların örnekleme sınırını aşmamasını sağlamak için Performance Monitoring, cihazlardan alınan bazı etkinlikleri atmak üzere sunucu tarafı örnekleme kullanabilir. Bu tür bir sınırlama, metriklerimizin etkinliğini değiştirmese de aşağıdakiler dahil olmak üzere küçük kalıp değişikliklerine neden olabilir:

  • İzleme sayısı, bir kod parçasının çalıştırılma sayısından farklı olabilir.
  • Kodda birbirine yakın olan izlemelerin her biri farklı sayıda örnek içerebilir.

Konsoldaki Sorunlar sekmesine ne oldu?

Sorunlar sekmesini, belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren Uyarılar sekmesiyle değiştirdik. Bir eşiğin durumunu belirlemek için artık Firebase konsolunu manuel olarak kontrol etmeniz gerekmez. Uyarıları öğrenmek için Performans sorunlarıyla ilgili uyarılar oluşturma başlıklı makaleyi inceleyin.

Konsolda Cihaz Üzerinde ve Ağ sekmelerine ne oldu? Bu sayfalarda bulunan izleri nasıl görebilirim?

Firebase konsolunun Performance Monitoring bölümünü, Kontrol paneli sekmesinde temel metriklerinizin ve tüm izlerinizin tek bir alanda gösterilmesi için yeniden tasarladık. Yeniden tasarım kapsamında Cihaz üzerinde ve Ağ sayfalarını kaldırdık.

Gösterge tablosu sekmesinin alt kısmındaki izlemler tablosunda, Cihaz üzerinde ve Ağ sekmelerinde gösterilen tüm bilgiler bulunur ancak bu bilgilere, izlemlerinizi belirli bir metrikteki yüzdelik değişime göre sıralama gibi bazı ek özellikler de eklenmiştir. Belirli bir izlemenin tüm metriklerini ve verilerini görüntülemek için izlemeler tablosundaki izleme adını tıklayın.

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

• Ağ isteği izleri (hem hazır hem de özel) — Ağ istekleri alt sekmesi
• Özel kod izleri: Özel izler alt sekmesi
• Uygulama başlatma, ön planda uygulama, arka planda uygulama izlemeleri: Özel izlemeler alt sekmesi
• Ekran oluşturma izleri: Ekran oluşturma alt sekmesi
• Sayfa yükleme izleri: Sayfa yükleme alt sekmesi

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

Yavaş ve donmuş karelerin sayısı neden beklediğim gibi değil?

Yavaş oluşturma kareleri ve donmuş kareler, 60 Hz cihaz yenileme hızı varsayılarak hesaplanır. Bir cihazın yenileme hızı 60 Hz'den düşükse saniyede daha az kare oluşturulduğundan her karenin oluşturma süresi daha yavaş olur. Daha yavaş oluşturma süreleri, daha fazla karenin daha yavaş oluşturulması veya donması nedeniyle daha fazla yavaş veya donmuş karenin raporlanmasına neden olabilir. Ancak bir cihazın yenileme hızı 60 Hz'den yüksekse her karenin oluşturma süresi daha kısa olur. Bu, yavaş veya donmuş karelerin daha az bildirilmesine neden olabilir. Bu, Performance Monitoring SDK'sındaki mevcut bir sınırlamadır.

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

Uygulamanızdaki tek Firebase ürünü Performance Monitoring ise aşağıdakileri yapmak istiyorsanız bağımsız Performance Monitoring SDK'sını (ve aşağıdaki önerilen başlık komut dosyasını) kullanabilirsiniz:

• Ad alanı içeren bir kitaplık kullanarak
• SDK paketinizin boyutunu küçültme
• SDK'nın ilk kullanıma hazırlanmasını sayfanız yüklendikten sonraya kadar erteleme

Bağımsız Performance Monitoring SDK'yı uygulamanıza eklemek ve ilk başlatılmasını sayfanız yüklendikten sonra ertelemek için:

1. Aşağıdaki komut dosyasını dizin dosyanızın başlığına ekleyin.
2. Uygulamanızın Firebase proje yapılandırma nesnesini eklediğinizden emin olun.

(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);

Burada:

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

Yukarıdaki komut dosyası, bağımsız SDK'yı asenkron olarak yükler ve ardından pencerenin onload etkinliği tetiklendikten sonra Firebase'i başlatır. Bu taktik, SDK'yı başlattığınızda tarayıcı yükleme metriklerini zaten bildirdiğinden SDK'nın sayfa yükleme metrikleri üzerindeki etkisini azaltır.

(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);

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

Firebase Performance Monitoring, toplanan performans verilerini geldikçe işler. Bu da Firebase konsolunda neredeyse gerçek zamanlı veri görüntülenmesine neden olur. İşlenen veriler, toplandıktan birkaç dakika içinde konsolda gösterilir. Bu nedenle "neredeyse gerçek zamanlı" terimi kullanılır.

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

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

Neredeyse gerçek zamanlı veri işleme özelliğinden 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.

Gerçek zamanlı olarak uyumlu SDK sürümleri şunlardır:

• iOS: 7.3.0 veya sonraki sürümler
• tvOS: 8.9.0 veya sonraki sürümler
• Android: 19.0.10 veya sonraki sürümler (veya Firebase Android BoM 26.1.0 veya sonraki sürümler)
• Web: 7.14.0 veya sonraki sürümler

Her zaman SDK'nın en son sürümünü kullanmanızı öneririz ancak yukarıda listelenen sürümlerin tümü Performance Monitoring'ün verilerinizi neredeyse gerçek zamanlı olarak işlemesine olanak tanır.

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

Gerçek zamanlı veri işlemeyle uyumlu SDK sürümleri şunlardır:

• iOS: 7.3.0 veya sonraki sürümler
• tvOS: 8.9.0 veya sonraki sürümler
• Android: 19.0.10 veya sonraki sürümler (veya Firebase Android BoM 26.1.0 veya sonraki sürümler)
• Web: 7.14.0 veya sonraki sürümler

Her zaman SDK'nın en son sürümünü kullanmanızı öneririz ancak yukarıda listelenen sürümlerin tümü Performance Monitoring'ün verilerinizi neredeyse gerçek zamanlı olarak işlemesine olanak tanır.

Uygulamamı gerçek zamanlı olarak 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 edersiniz. Ancak performans verilerinin görüntülenmesi, verilerin toplanmasından yaklaşık 36 saat sonra gerçekleşir.

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

Evet! Bir uygulama örneğinin kullandığı SDK sürümünden bağımsız olarak tüm kullanıcılarınızın performans verilerini görürsünüz.

Ancak son verilere (yaklaşık 36 saatten eski olmayan) bakıyorsanız gösterilen veriler, gerçek zamanlı uyumlu SDK sürümünü kullanan uygulama örneklerindeki kullanıcılardan gelir. Ancak yakın olmayan veriler, uygulamanızın tüm sürümlerinden alınan performans verilerini içerir.