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 Dev Araçları'nda Ağ sekmesi veya Firefox'ta 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ı bulun. 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 kaydetmiyorsa sorun giderme ipuçlarını inceleyin.

SDK uygulamaya eklendi ancak konsolda hala SDK'nın eklenmesi gerektiği belirtiliyor

Firebase, uygulamanızdan etkinlik bilgileri (ör. uygulama etkileşimleri) aldığında Performance Monitoring SDK'yı 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.

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 öğesinin 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.

Konsol, SDK'nın algılandığını belirtiyor ancak veri gösterilmiyor

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

"SDK algılandı" mesajının görünmesinden bu yana 24 saatten uzun bir süre geçtiyse ve hâlâ veri görmüyorsanız bilinen bir kesinti olup olmadığını kontrol etmek için Firebase Durum Kontrol Paneli'ne bakın. 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'nın uygulamanızda doğru şekilde başlatıldığından emin olun.

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

   • performance.instrumentationEnabled

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

4. Web sayfası sekmesini kapatıp yeniden açın. Günlük kaydını tekrar kontrol edin.

   Performance Monitoring SDK'yı 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ğiyle ilgili verileri görmüyorsanız aşağıdaki sorun giderme adımlarını deneyin:

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

2. Uygulamanızı bu metriği ölçecek şekilde ayarladığınızdan emin olun. İlk giriş gecikmesi metriği için manuel kurulum gerekir. Özellikle, bu metrik için polyfill kitaplığını eklemeniz gerekir. Yükleme talimatları için kitaplığın belgelerine bakın.

   Bu polyfill kitaplığının eklenmesinin, Performance Monitoring özelliğinin diğer web uygulaması metriklerini raporlaması için gerekli olmadığını unutmayın.

Performans kontrol panelinde özel izleme verileri eksik

Otomatik olarak toplanan izlemelerle ilgili performans verilerini görüyor musunuz ancak özel kod izlemeleriyle ilgili verileri görmüyor musunuz? Aşağıdaki sorun giderme adımlarını deneyin:

1. Trace API aracılığıyla oluşturulan özel kod izlerinin kurulumunu kontrol edin. Özellikle aşağıdakilere dikkat edin:

   • Özel kod izlerinin ve özel metriklerin adları aşağıdaki koşulları karşılamalıdır: başta veya sonda boşluk olmamalıdır, başta alt çizgi (_) karakteri olmamalıdır ve maksimum uzunluk 32 karakterdir.
   • Tüm izlemeler başlatılmalı ve durdurulmalıdır. Başlatılmayan, durdurulmayan veya başlatılmadan önce durdurulan izlemeler 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 izleri için veri toplanmasını kontrol eder (tüm veriler için değil).

3. Performance Monitoring öğesinin 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 kaydediyor ancak 24 saat sonra 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 verileriniz eksikse aşağıdakilere dikkat edin:

• Performance Monitoring, tarayıcı API'si tarafından bildirilen ağ istekleriyle ilgili metrikleri otomatik olarak toplar. Bu raporlar, başarısız olan 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ğ istekleriyle ilgili rapor oluşturabilir. Bu nedenle, açık bırakılan HTTP/S bağlantıları raporlanmayabilir.

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

Performance Monitoring ağ isteği verilerini URL kalıpları altında nasıl topladığı 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ü kaldırıldı.

Son zamanlarda kullanıma sunduğumuz uyarılar özelliğinin devamı olarak En Önemli Sorunlar bölümünü Son Uyarılar ile değiştirdik. Bu özellik, belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendirir. Sorunların desteği sonlandı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 uygulamalarla ilgili en son üç uyarı gösterilir.

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

Konsoldaki sorunlar için eşikler belirleme özelliği neden kaldırıldı?

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

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

Sorunları giderme şeklinizi iyileştirmek için Ayrıntılar ve Metrikler sayfalarını yeni 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 izleme için daha fazla veri görüntüleme başlıklı makaleyi inceleyin.

Örnek sayısının beklediğim gibi olmamasının nedeni nedir?

Performance Monitoring, uygulamanızın kullanıcı cihazlarından performans verileri toplar. Uygulamanızın çok sayıda kullanıcısı varsa veya uygulama büyük miktarda 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 etmesini sağlayacak 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 bir cihazdan gönderilen kod ve ağ isteği izlerinin sayısını 10 dakikada 300 etkinlik ile sınırlandırırız. Bu yaklaşım, cihazı büyük miktarda performans verisi gönderebilen döngüye alınmış enstrümantasyonlardan 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 günlük olarak uygulama başına 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ı getirilir. Örnekleme için seçilmeyen bir cihaz herhangi bir etkinlik göndermez. Dinamik örnekleme hızı uygulamaya özeldir ve toplanan verilerin genel hacminin sınırın altında kalmasını sağlamak için ayarlanır.

  Kullanıcı oturumları, kullanıcının cihazından ek ve ayrıntılı veriler gönderir. Bu verilerin yakalanıp gönderilmesi 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ı için Performance Monitoring, cihazlardan alınan bazı etkinlikleri bırakmak üzere sunucu tarafı örnekleme kullanabilir. Bu tür bir sınırlama, metriklerimizin etkinliğini değiştirmese de aşağıdakiler de dahil olmak üzere küçük desen değişikliklerine neden olabilir:

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

Konsoldaki Sorunlar sekmesine ne oldu?

Sorunlar sekmesini, belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren Uyarılar ile değiştirdik. Eşiğin durumunu belirlemek için artık Firebase konsolunu manuel olarak kontrol etmeniz gerekmiyor. Uyarılar hakkında bilgi edinmek için Performans sorunlarıyla ilgili uyarılar oluşturma 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. Artık Kontrol Paneli sekmesinde temel metrikleriniz ve tüm izleriniz tek bir alanda gösteriliyor. Yeniden tasarım kapsamında Cihazda ve Ağ sayfalarını kaldırdık.

Gösterge tablosu sekmesinin alt kısmındaki izler tablosunda, Cihazda ve Ağ sekmelerinde gösterilen tüm bilgiler yer alır. Ancak bu tabloda, izlerinizi belirli bir metriğin yüzde değişimine göre sıralama özelliği de dahil olmak üzere bazı ek özellikler bulunur. Belirli bir izlemeye ait tüm metrikleri ve verileri görüntülemek için izlemeler tablosunda izleme adını tıklayın.

İzleme tablosunun aşağıdaki alt sekmelerinde izlemelerinizi 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şlatma, uygulama ön planda, uygulama arka planda 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 metrikleri 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ğim gibi değil?

Yavaş oluşturma kareleri ve donmuş kareler, cihazın yenileme hızının 60 Hz olduğu varsayılarak hesaplanır. Bir 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 yavaş olur. Daha yavaş oluşturma süreleri, daha fazla karenin daha yavaş oluşturulmasına veya donmasına neden olacağından daha fazla yavaş veya donmuş kare bildirilmesine neden olabilir. Ancak bir cihazın yenileme hızı 60 Hz'den yüksekse her karenin oluşturma süresi daha hızlı olur. Bu durum, daha az sayıda yavaş veya donmuş karenin bildirilmesine neden olabilir. Bu, Performance Monitoring SDK'daki mevcut bir sınırlamadır.

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

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

• ad alanına sahip bir kitaplık kullanma
• SDK paketinizin boyutunu küçültme
• SDK'nın başlatılmasını sayfanız yüklendikten sonraya ertelemek

Bağımsız Performance Monitoring SDK'yı uygulamanıza eklemek ve başlatılmasını sayfanız yüklendikten sonraya 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/12.11.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 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ği için 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);

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

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

"Neredeyse gerçek zamanlı" performans verileri ne anlama gelir?

Firebase Performance Monitoring, toplanan performans verilerini geldikçe işler. Bu da Firebase konsolunda verilerin neredeyse gerçek zamanlı olarak gösterilmesini sağlar. İşlenen veriler, toplandıktan birkaç dakika sonra konsolda gösterilir. Bu nedenle "neredeyse gerçek zamanlı" ifadesi kullanılır.

Neredeyse gerçek zamanlı veri işlemeyi kullanmak 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şlemeden yararlanmak için uygulamanızın gerçek zamanlı veri işleme ile 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: v7.3.0 veya sonraki sürümler
• tvOS: 8.9.0 veya sonraki sürümler
• Android: v19.0.10 veya sonraki sürümler (ya da Firebase Android BoM v26.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ı önerdiğimizi ancak yukarıda listelenen sürümlerin herhangi birinin Performance Monitoring'nın verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlayacağını unutmayın.

Performance Monitoring SDK'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: v7.3.0 veya sonraki sürümler
• tvOS: 8.9.0 veya sonraki sürümler
• Android: v19.0.10 veya sonraki sürümler (ya da Firebase Android BoM v26.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ı önerdiğimizi ancak yukarıda listelenen sürümlerin herhangi birinin Performance Monitoring'nın verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlayacağını unutmayın.

Uygulamamı gerçek zamanlı olarak uyumlu bir SDK sürümünü 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österilmesi, toplanma zamanından yaklaşık 36 saat sonra gerçekleşir.

Gerçek zamanlı olarak uyumlu bir SDK sürümüne güncelledim 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! Bir 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 son verilere (yaklaşık 36 saatten daha eski olmayan) bakıyorsanız gösterilen veriler, gerçek zamanlı uyumlu bir SDK sürümü kullanan uygulama örneklerinin kullanıcılarına aittir. Ancak güncel olmayan veriler, uygulamanızın tüm sürümlerine ait performans verilerini içerir.

Neden performans verilerinin gerçek zamanlı gösterimini görmüyorum?

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: v7.3.0 veya sonraki sürümler
• tvOS: 8.9.0 veya sonraki sürümler
• Android: v19.0.10 veya sonraki sürümler (ya da Firebase Android BoM v26.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ı önerdiğimizi ancak yukarıda listelenen sürümlerin herhangi birinin Performance Monitoring'nın verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlayacağını unutmayın.