Performans İzleme sorunlarını giderme ve SSS

Performans etkinliklerine ilişkin günlük iletileri nasıl görüntülenir?

1. Hata ayıklama günlüğünü aşağıdaki şekilde etkinleştirin:

   1. Xcode'da (minimum v14.1), Ürün > Şema > Şemayı düzenle öğesini seçin.
   2. Soldaki menüden Çalıştır'ı seçin, ardından Bağımsız Değişkenler sekmesini seçin.
   3. Başlatma Sırasında Aktarılan Bağımsız Değişkenler bölümüne -FIRDebugEnabled ekleyin.

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

3. Performans İzleme, günlük mesajlarını Firebase/Performance ile etiketler, böylece günlük mesajlarınızı filtreleyebilirsiniz.

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. Verilerinizi Firebase konsolunda 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 kaydetmiyorsa sorun giderme ipuçlarını inceleyin.

SDK uygulamaya eklendi ancak konsol hâlâ SDK eklenmesi gerektiğini söylüyor

Firebase, uygulamanızdan etkinlik bilgilerini (uygulama etkileşimleri gibi) 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 kontrol panelinde "SDK algılandı" mesajı görüntülenir. Ardından, 30 dakika içinde gösterge tablosu ilk işlenen verileri görüntüler.

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öremiyorsanız, Performans İzleme'nin olayları günlüğe kaydettiğinden emin olmak için günlük iletilerinizi kontrol edin . Gecikmeli bir SDK algılama mesajıyla ilgili sorunları gidermek için aşağıda açıklandığı şekilde 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 kontrol panelinde görüntülemeden önce işler.

"SDK algılandı" mesajının üzerinden 24 saatten fazla zaman geçtiyse ve hâlâ veri göremiyorsanız, bilinen bir kesinti olup olmadığını kontrol etmek için Firebase Durum Kontrol Panelini kontrol edin. Kesinti yoksa Firebase Desteği ile iletişime geçin .

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

Performans etkinliklerine ilişkin günlük mesajlarını göremiyorsanız aşağıdaki sorun giderme adımlarını deneyin:

1. Info.plist dosyanızda Performans İzleme SDK'sının aşağıdaki işaretlerden herhangi biri aracılığıyla devre dışı bırakılmadığından emin olun:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Performans İzleme'nin çalışma zamanında devre dışı bırakılmadığından emin olun ( Swift | Obj-C ).

3. Uygulamanızda devre dışı bırakılmış bir şey bulamazsanız Firebase Desteği ile iletişime geçin .

Performans kontrol panelinde ekran izleme verileri eksik

Ekran oluşturma izlerine ilişkin veriler eksikse aşağıdaki sorun giderme adımlarını deneyin:

Performans kontrol panelinde özel izleme verileri eksik

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

1. Trace API aracılığıyla sağlanan özel kod izlemelerinin, özellikle de aşağıdakilerin kurulumunu kontrol edin:

   • Özel kod izlemelerine ve özel metriklere ilişkin adlar aşağıdaki gereksinimleri 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 izlemelerin başlatılması ve durdurulması gerekir. Başlatılmayan, durdurulmayan veya başlatılmadan önce durdurulan herhangi bir izleme günlüğe kaydedilmeyecektir.

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

3. Performans İzleme etkinlikleri günlüğe kaydediyor ancak 24 saatin ardından hiçbir veri görüntülenmiyorsa Firebase Desteği ile iletişime geçin .

Performans kontrol panelinde ağ isteği verileri eksik

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

1. Ağ kitaplığı uyumsuzluğunu kontrol edin. Performans İzleme, aşağıdaki ağ kitaplıklarını kullanan ağ isteklerine ilişkin ölçümleri otomatik olarak toplar :

   • Swift için: URLSession ve URLConnection
   • Objective-C için: NSURLSession ve NSURLConnection

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

2. 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 raporlayabilir. Bu, açık bırakılan HTTP/S bağlantılarının rapor edilmeyebileceği anlamına gelir.

   • Performans İzleme, geçersiz Content-Type üstbilgilerine sahip ağ isteklerini raporlamaz. Ancak Content-Type üstbilgileri 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 modellerini de deneyebilirsiniz!

Project ana sayfasındaki Performans kartındaki Önemli Sorunlara ne oldu?

Belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren, yakın zamanda kullanıma sunduğumuz uyarıların devamı olarak En Önemli Sorunlar'ı En Son Uyarılar ile değiştirdik. Sorunlar artık kullanımdan kaldırıldı ve bunların yerini uyarılar aldı.

Performans kartının üst kısmındaki uygulama seçici, Son Uyarılar altındaki uyarı girişlerini filtreler. Seçilen uygulama(lar) için yalnızca en son üç uyarı görüntülenir.

Uyarılar hakkında daha fazla bilgi edinmek için bkz. Performans sorunları için uyarı ayarlama .

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

Performans İzleme, tanımlanan eşikleri aşan ölçümlere yönelik uyarıları destekler. Performans ölçümlerine ilişkin bu yapılandırılabilir eşiklerle ilgili karışıklığı önlemek amacıyla, sorunlara yönelik eşikler yapılandırma özelliğini kaldırdık.

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

Sorunları giderme yönteminizi geliştirmek için Ayrıntılar ve Ölçümler sayfalarını yeniden tasarlanmış, merkezi bir kullanıcı arayüzü (UI) ile değiştirdik. Bu yeni sorun giderme kullanıcı arayüzü, Ayrıntılar ve Metriklerin sunduğu temel işlevlerin aynısını sunar. Sorun giderme hakkında daha fazla bilgi edinmek için bkz. Belirli bir izleme için daha fazla veri görüntüleme .

Numune sayısı neden beklediğim gibi değil?

Performans İzleme, uygulamanızın kullanıcı cihazlarından performans verilerini toplar. Uygulamanızda çok sayıda kullanıcı varsa veya uygulama büyük miktarda performans etkinliği oluşturuyorsa Performans İzleme, işlenen olayların sayısını azaltmak için veri toplamayı bir aygıt alt kümesiyle sınırlandırabilir. Bu sınırlar, daha az etkinlik olsa bile metrik değerlerinin hâlâ kullanıcınızın uygulama deneyimini temsil etmesini sağlayacak kadar yüksektir.

Performans İzleme, topladığımız veri hacmini yönetmek için aşağıdaki örnekleme seçeneklerini kullanır:

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

• Dinamik örnekleme : Performans İzleme, tüm uygulama kullanıcıları genelinde günlük olarak uygulama başına kod izlemeleri için yaklaşık 100 milyon olay ve ağ isteği izlemeleri için 100 milyonluk bir sınır toplar. Rastgele bir cihazın izleri yakalayıp göndermesi gerekip gerekmediğini belirlemek için cihazlara (Firebase Remote Config kullanılarak) dinamik bir örnekleme hızı getirilir. Örnekleme için seçilmeyen bir cihaz herhangi bir olay göndermez. Dinamik örnekleme hızı uygulamaya özeldir ve toplanan verilerin genel hacminin sınırın altında kalmasını sağlayacak şekilde ayarlanır.

  Kullanıcı oturumları, kullanıcının cihazından ek, ayrıntılı veriler gönderir; bu da verileri yakalamak ve göndermek için daha fazla kaynak gerektirir. Performans İzleme, 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 amacıyla Performans İzleme, cihazlardan alınan bazı olayları bırakmak için sunucu tarafı örneklemeyi kullanabilir. Bu tür bir sınırlama, ölçümlerimizin etkinliğini değiştirmese de aşağıdakiler de dahil olmak üzere küçük model değişikliklerine neden olabilir:

  • İzlerin sayısı, bir kod parçasının yürütülme sayısından farklı olabilir.
  • Kodda yakından eşleştirilmiş izlemelerin her biri farklı sayıda örneğe sahip olabilir.

Konsoldaki Sorunlar sekmesine ne oldu?

Sorunlar sekmesini, belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren Uyarılar özelliğinin eklenmesiyle değiştirdik. Bir eşiğin durumunu belirlemek için artık Firebase konsolunu manuel olarak kontrol etmenize gerek yok. Uyarılar hakkında bilgi edinmek için bkz. Performans sorunlarına yönelik uyarıları ayarlama .

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

Firebase konsolunun Performans İzleme bölümünü, Kontrol Paneli sekmesinin temel ölçümlerinizi ve tüm izlerinizi tek bir alanda görüntüleyeceği şekilde yeniden tasarladık. Yeniden tasarımın bir parçası olarak Cihazda ve Ağ sayfalarını kaldırdık.

Kontrol Paneli sekmesinin alt kısmındaki izlemeler tablosu, Cihazda ve Ağ sekmelerinde görüntülenen bilgilerin tamamına sahiptir ancak belirli bir ölçüm için izlerinizi yüzde değişime göre sıralama yeteneği de dahil olmak üzere bazı ek özellikler içerir. Belirli bir izlemeye ilişkin tüm metrikleri ve verileri görüntülemek için izlemeler tablosundaki izleme adına tıklayın.

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

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

İzleme tablosu ve metrikleri ve verileri görüntülemeyle ilgili ayrıntılar 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şturulan kareler ve donmuş kareler, 60 Hz'lik varsayılan cihaz yenileme hızıyla 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ş olacaktır. Daha yavaş oluşturma süreleri, daha fazla karenin daha yavaş işlenmesi veya donması nedeniyle daha yavaş veya donmuş karelerin raporlanmasına neden olabilir. Ancak cihazın yenileme hızı 60 Hz'den yüksekse her karenin oluşturma süresi daha hızlı olacaktır. Bu, daha az yavaş veya donmuş karenin raporlanmasına neden olabilir. Bu, Performans İzleme SDK'sındaki geçerli bir sınırlamadır.

Performans İzleme verilerimin BigQuery'ye aktarılması beklenenden daha uzun sürüyor. Gerçek zamanlı değil mi?

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

Örneğin, 19 Nisan'a ait veriler BigQuery'de 20 Nisan'da 12:00 ile gece yarısı arasında mevcut olacaktır (tüm tarih ve saatler Pasifik Saatine göredir).

"Yakın Gerçek Zamanlı" performans verileri ne anlama geliyor?

Firebase Performans İzleme işlemleri, performans verilerini geldiği gibi topladı, bu da Firebase konsolunda gerçek zamanlı veri görüntüsüne neden oluyor. İşlenmiş veriler konsolda koleksiyonundan birkaç dakika içinde görüntülenir, dolayısıyla "gerçek zamanlı" terimi.

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

Uygulamam için gerçek zamanlı performans verilerine nasıl yaklaşabilirim?

Yakın gerçek zamanlı veri işlemeden yararlanmak için, uygulamanızın yalnızca gerçek zamanlı veri işleme ile uyumlu bir performans izleme SDK sürümü kullandığından emin olmanız gerekir.

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

• iOS - V7.3.0 veya daha sonra
• TVO'lar - v8.9.0 veya üstü
• Android - V19.0.10 veya üstü (veya Firebase Android Bom v26.1.0 veya üstü)
• Web - V7.14.0 veya daha sonra

Her zaman SDK'nın en son sürümünü kullanmanızı tavsiye ettiğimizi unutmayın, ancak yukarıda listelenen herhangi bir sürüm, performans izlemenin verilerinizi gerçek zamanlı olarak işlemesini sağlayacaktır.

Performans İzleme SDK'sının hangi sürümleri gerçek zamanlı uyumlu kabul edilir?

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

• iOS - V7.3.0 veya daha sonra
• TVO'lar - v8.9.0 veya üstü
• Android - V19.0.10 veya üstü (veya Firebase Android Bom v26.1.0 veya üstü)
• Web - V7.14.0 veya daha sonra

Her zaman SDK'nın en son sürümünü kullanmanızı tavsiye ettiğimizi unutmayın, ancak yukarıda listelenen herhangi bir sürüm, performans izlemenin verilerinizi gerçek zamanlı olarak işlemesini sağlayacaktır.

Gerçek zamanlı uyumlu bir SDK sürümü kullanmak için uygulamamı 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öreceksiniz. Ancak, performans verilerinin görüntülenmesi, koleksiyonundan yaklaşık 36 saat ertelenecektir.

Gerçek zamanlı uyumlu bir SDK sürümünü güncelledim, ancak bazı kullanıcılarım hala uygulamamın eski sürümlerinde. Performans verilerini Firbase konsolunda görmeye devam ediyor muyum?

Evet! Bir uygulama örneğinin hangi SDK sürümünü kullandığına bakılmaksızın, tüm kullanıcılarınızdan performans verilerini göreceksiniz.

Ancak, son verilere bakıyorsanız (kabaca 36 saatten az), görüntülenen veriler gerçek zamanlı uyumlu bir SDK sürümü kullanan uygulama örneklerinin kullanıcılarından alınmıştır. Bununla birlikte, tebrik olmayan veriler, uygulamanızın tüm sürümlerinden performans verilerini içerir.