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 (ör. Chrome Geliştirici Araçları için Ağ sekmesi veya Firefox için Ağ İzleyicisi).

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 için bir ağ çağrısı olup olmadığına bakın. 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 Console'da hâlâ SDK eklemem gerektiği belirtiliyor

Firebase, uygulamanızdan etkinlik bilgileri (uygulama etkileşimleri gibi) 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, 30 dakika içinde kontrol panelinde ilk işlenen veriler gösterilir.

Uygulamanıza SDK'nın en yeni sürümünü eklemenizin üzerinden 10 dakikadan fazla zaman geçtiyse ve hâlâ herhangi bir değişiklik görmüyorsanız Performance Monitoring uygulamasının 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.

Console, SDK'nın algılandığını söylüyor ancak veri gösterilmiyor

Performance Monitoring, performans etkinliği verilerini Performans kontrol panelinde göstermeden önce işler.

"SDK algılandı" mesajının gösterilmesinin üzerinden 24 saatten uzun bir süre 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 etkinlikleri için günlük mesajları 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ı önbelleğe alma özelliğinin devre dışı bırakıldığından emin olun. Aksi takdirde tarayıcı, yeni ölçümleme ayarlarını algılamayabilir.

4. Web sayfası sekmesini kapatıp yeniden açın. Günlük kaydı için 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

Modern uygulamalar, Interaction to Next Paint (INP) First Input Delay'in (FID) yerini aldığı için _fid metriğini kullanmaz.

Eski tarayıcılarda FID'yi kaydetmek için:

1. Eski FID polyfill'i ekleyin.

2. Kullanıcının, sayfa yüklendikten sonraki 5 saniye içinde sayfayla etkileşim kurduğunu doğrulayın. Performance Monitoring, FID'yi yalnızca bu zaman aralığında kaydeder.

Performance Dashboard'da özel izleme verileri eksik

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

1. Trace API aracılığıyla özel kod izlerinin kurulumunu, özellikle de aşağıdakileri kontrol edin:

   • Özel kod izlemelerinin ve özel metriklerin adları şu koşulları karşılamalıdır: Başta veya sonda boşluk olmamalı, başta alt çizgi (_) karakteri olmamalı ve maksimum uzunluk 32 karakter olmalıdır.
   • Tüm izlemeler başlatılmalı ve durdurulmalıdır. Başlatılmayan, durdurulmayan veya başlatılmadan önce durdurulan izler günlüğe kaydedilmez.

   record() yöntemini kullanıyorsanız izlemenizi açıkça başlatmanız veya durdurmanız gerekmez.

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

   • performance.dataCollectionEnabled

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

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

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

Performance Dashboard'da ağ isteği verileri eksik

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

• Performance Monitoring, tarayıcı API'si tarafından bildirilen ağ istekleri için metrikleri otomatik olarak toplar. Bu raporlar, başarısız ağ isteklerini içermez.

• Kodunuzun ve kodunuz tarafından kullanılan ağ kitaplıklarının davranışı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 raporlanmayabileceği anlamına gelir.

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

Performance Monitoring, URL kalıpları altında ağ isteği verilerini nasıl toplar? hakkında daha fazla bilgi edinin.

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

Proje ana sayfasındaki Performans kartında yer alan En Önemli Sorunlar bölümüne ne oldu?

Kısa süre önce kullanıma sunduğumuz ve belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren uyarılar özelliğinin devamı olarak En Önemli Sorunlar'ı Son Uyarılar ile değiştirdik. Sorunlar artık kullanımdan kaldırıldı ve yerini uyarılara bıraktı.

Performans kartının üst kısmındaki uygulama seçici, Son Uyarılar bölümündeki uyarı girişlerini filtreler. Yalnızca seçilen uygulamalar için en son üç uyarı gösterilir.

Uyarılar hakkında daha fazla bilgi edinmek için Performans sorunları için uyarı ayarlama 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ılabilen bu eşiklerle ilgili kafa karışıklığını önlemek amacıyla sorunlar için eşik yapılandırma özelliğini kaldırdık.

Firebase Console'daki Ayrıntılar ve Metrikler bilgilerine ne oldu?

Sorun giderme deneyiminizi iyileştirmek için Ayrıntılar ve Metrikler sayfalarını yeniden tasarlanmış, merkezi bir kullanıcı arayüzüyle (UI) 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 iz için daha fazla veri görüntüleme bölümüne bakın.

Örnek sayısı neden beklediğimden farklı?

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

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

• Cihaz üzerinde sıklık sınırlaması: Bir cihazın ani izleme patlamaları göndermesini önlemek için cihazdan gönderilen kod ve ağ isteği izlerinin sayısını her 10 dakikada bir 300 etkinlikle sınırlandırırız. Bu yaklaşım, cihazı büyük miktarda performans verisi gönderebilecek döngülü araçlardan korur ve tek bir cihazın performans ölçümlerini saptırmasını önler.

• Dinamik örnekleme: Performance Monitoring, tüm uygulama kullanıcıları genelinde her uygulama için günlük olarak sınırlı sayıda kod izi ve ağ isteği izi toplar. Rastgele bir cihazın izleri yakalayıp göndermesi gerekip gerekmediğini belirlemek için cihazlarda (Firebase Remote Config kullanılarak) dinamik bir örnekleme hızı alınır. Örnekleme için seçilmeyen cihazlar 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. Kullanıcı oturumlarının etkisini en aza indirmek için Performance Monitoring, oturum sayısını da kısıtlayabilir.

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

  • İzleme sayısı, bir kod parçasının yürütülme sayısından farklı olabilir.
  • Kodda yakından bağlantılı olan izlerin her birinde farklı sayıda örnek olabilir.

Console'daki Sorunlar sekmesine ne oldu?

Sorunlar sekmesini, belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren Uyarılar ile değiştirdik. Bir eşiğin durumunu belirlemek için artık Firebase konsolunu manuel olarak kontrol etmeniz gerekmez. Uyarılar hakkında bilgi edinmek için Performans sorunları için uyarı ayarlama başlıklı makaleyi inceleyin.

Konsoldaki Cihazda ve Ağ sekmelerine ne oldu? Bu sayfalardaki izleri nasıl görüntüleyebilirim?

Firebase konsolunun Performance Monitoring bölümünü yeniden tasarladık. Böylece Kontrol paneli sekmesi, önemli metriklerinizi ve tüm izlerinizi tek bir alanda gösterir. Yeniden tasarım kapsamında Cihazda ve Ağ sayfalarını kaldırdık.

Kontrol paneli sekmesinin alt kısmındaki izler tablosu, Cihazda ve Ağ sekmelerinde gösterilen bilgilerin aynısını içerir. Ancak izlerinizi belirli bir metriğin yüzde değişimine göre sıralama gibi bazı ek özellikler de sunar. Belirli bir izin tüm metriklerini ve verilerini görüntülemek için izler tablosunda iz adını tıklayın.

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

• 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şlatma, ön planda çalışan uygulama, arka planda çalışan uygulama izleri: Özel izler alt sekmesi
• Ekran oluşturma izleri: Ekran oluşturma alt sekmesi
• Sayfa yükleme izleri: Sayfa yükleme alt sekmesi

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

Yavaş ve donmuş karelerin sayısı neden beklediğimden farklı?

Yavaş oluşturulan kareler ve donmuş kareler, cihazın yenileme hızının 60 Hz olduğu varsayılarak hesaplanır. Cihazın yenileme hızı 60 Hz'den düşükse saniyede daha az kare oluşturulduğu için her karenin oluşturma süresi daha uzun olur. Daha fazla kare daha yavaş oluşturulacağı veya donacağı için daha yavaş oluşturma süreleri, daha fazla yavaş veya donmuş karenin bildirilmesine neden olabilir. Ancak cihazın yenileme hızı 60 Hz'den yüksekse her karenin oluşturma süresi daha kısa olur. Bu durum, daha az yavaş veya donmuş kare bildirilmesine neden olabilir. Bu, Performance Monitoring SDK'sındaki mevcut bir sınırlamadır.

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

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

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

Bağımsız Performance Monitoring SDK'sını uygulamanıza eklemek ve başlatma işlemini 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 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/13.0.0/firebase-performance.js'
• firebaseConfig, uygulamanızın Firebase yapılandırma nesnesidir.

Yukarıdaki komut dosyası, bağımsız SDK'yı eşzamansız olarak yükler ve pencerenin onload etkinliği tetiklendikten sonra Firebase'i başlatır. Bu taktik, SDK'nın sayfa yükleme metrikleri üzerindeki etkisini azaltır. Çünkü SDK'yı başlattığınızda tarayıcı, yükleme metriklerini zaten bildirmiştir.

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

Kaç tane özel URL kalıbı oluşturabilirim?

Uygulama başına toplam 400 adede kadar özel URL kalıbı ve bu uygulama için alan başına 100 adede kadar özel URL kalıbı oluşturabilirsiniz.

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

Firebase Performance Monitoring, toplanan performans verilerini geldikleri anda işler. Bu sayede, Firebase konsolunda veriler neredeyse gerçek zamanlı olarak gösterilir. İşlenen veriler, toplandıktan sonra birkaç dakika içinde konsolda gösterilir. Bu nedenle "neredeyse gerçek zamanlı" ifadesi 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ü kullandığından emin olun.

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

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ı 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 (ya da 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 yeni sürümünü kullanmanızı öneririz ancak yukarıda listelenen tüm sürümler, Performance Monitoring hizmetinin verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlar.

Performance Monitoring SDK'sının hangi sürümleri gerçek zamanlı uyumlu olarak 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 (ya da 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 yeni sürümünü kullanmanızı öneririz ancak yukarıda listelenen tüm sürümler, Performance Monitoring hizmetinin verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlar.

Uygulamamı anlık 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 Console'da görmeye devam edersiniz. Ancak performans verilerinin gösterilmesi, toplandığı zamandan yaklaşık 36 saat sonra gerçekleşir.

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

Evet! Uygulama örneğinin hangi SDK sürümünü kullandığına bakılmaksızın tüm kullanıcılarınızın performans verilerini görürsünüz.

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

Performans verilerini neden gerçek zamanlı olarak göremiyorum?

Gerçek zamanlı performans verilerini görüntülemek için uygulamanızın gerçek zamanlı veri işlemeyle uyumlu bir Performance Monitoring SDK sürümü kullandığından emin olun.

• 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 (ya da 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 yeni sürümünü kullanmanızı öneririz ancak yukarıda listelenen tüm sürümler, Performance Monitoring hizmetinin verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlar.