Performance Monitoring ile ilgili sorunları giderme ve SSS

iOS+ Android Web

Bu sayfada, Performans İzleme'yi kullanmaya başlamayla ilgili sorun giderme ipuçları veya performans izleme özelliklerini ve araçlarını kullanmayı unutmayın.

Sorun giderme için ilk kontroller

Aşağıdaki iki kontrol, herkes için önerilen genel en iyi uygulamalardır inceleyin.

1. Performans etkinlikleri için günlük mesajlarını kontrol etme

Performance Monitoring SDK'sının verileri yakaladığından emin olmak için günlük mesajlarınızı kontrol edin performans etkinlikleri oluşturabilirsiniz.

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

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

   1. Xcode'da (minimum v14.1), Ürün > Şema > Şemayı düzenleyin.
   2. Soldaki menüden Çalıştır'ı, ardından Bağımsız değişkenler sekmesini seçin.
   3. Lansmanda İletilen Bağımsız Değişkenler bölümüne -FIRDebugEnabled ekleyin.

2. Hata mesajı olup olmadığını görmek için günlük mesajlarınızı kontrol edin.

3. Performance Monitoring, günlük mesajlarını Firebase/Performance ile etiketler. Böylece şunları yapabilirsiniz: günlük mesajlarınızı filtreleyebilirsiniz.

4. Performance Monitoring'in şu özelliklere sahip olduğunu gösteren aşağıdaki günlük türlerini kontrol edin: performans etkinliklerini günlüğe kaydetme:

   • 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. Birkaç dakika anlarda etkinleştirmeniz gerekir.

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

2. Firebase Durum Kontrol Paneli'ni kontrol etme

Kontrol edin Firebase Durum Kontrol Paneli: Firebase veya Performance Monitoring için bilinen bir kesinti vardır.

Performans İzleme'yi kullanmaya başlama

Performans İzleme'yi kullanmaya başlıyorsanız (iOS+ | Android | Web), aşağıdaki sorun giderme adımlarına göz atın. ipuçları, Firebase'in SDK'yı algılaması veya Firebase konsolundaki ilk performans verilerinizi gösterir.

SDK, uygulamaya eklendi ancak konsola eklendi hâlâ SDK'nın eklenmesi gerektiğini söylüyor

Firebase, uygulamanıza Performance Monitoring SDK'sını başarıyla ekleyip eklemediğinizi tespit edebilir Uygulamanızdan etkinlik bilgileri (uygulama etkileşimleri gibi) aldığında. Genellikle uygulamanızı başlattıktan sonra 10 dakika içinde Performans kontrol paneli Firebase konsolunda "SDK algılandı" hatası görüntüleniyor mesajını alırsınız. Ardından, 30 dakika, kontrol panelinde ilk işlenen veriler görüntülenir.

SDK'nın son sürümünü uygulamanıza rağmen herhangi bir değişiklik görmüyorsanız günlüğünüzü kontrol edin performans izleme mesajlarını Performance Monitoring'in günlüğe kaydettiğinden emin olun etkinlikler. Aşağıdaki işlemler için uygun sorun giderme adımlarını deneyin: gecikmeli SDK algılama mesajıyla ilgili sorunları giderme

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

Not: Performance Monitoring SDK'sı, etkinlikleri yerel olarak işler ve ardından Firebase'e gönderir. düzenli olarak veya uygulama ön plana geri döndüğünde. Bu nedenle, Uygulama etkileşimi ile Firebase'in etkinlik bilgilerini daha fazla bilgi edineceksiniz.

1. Hâlâ yerel olarak geliştirme yapıyorsanız veriler için daha fazla etkinlik oluşturmayı deneyin koleksiyon:

   1. Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.

   2. Uygulamanızı arka plan ve ön plan arasında değiştirerek etkinlik oluşturun veya ekranlar arasında gezinerek uygulamanızla etkileşime girin ya da ve/veya ağ isteklerini tetikler.

2. Firebase yapılandırmanızın (Google-Service-Info.plist) adlı dosya uygulamanıza doğru şekilde eklenmiş ve dosyayı değiştirmemişsiniz. Özellikle aşağıdakileri kontrol edin:

   • Yapılandırma dosyasının adına ek karakterler eklenmez. Örneğin: (2)

   • Yapılandırma dosyası, XCode projenizin kökünde bulunur ve ve doğru hedefler.

   • Yapılandırma dosyasında listelenen Firebase Apple Uygulama Kimliği (GOOGLE_APP_ID) doğru şekilde ekleyebilirsiniz. Uygulamalarınız kartında Firebase uygulama kimliğinizi bulun Projenizin ayarlarını yapın.

   Uygulamanızdaki yapılandırma dosyasında sorun görünüyorsa aşağıdakileri deneyin:

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

   2. İndirmek için bu talimatları uygulayın yeni bir yapılandırma dosyası yükleyin ve bunu Apple uygulamanıza ekleyin.

3. SDK etkinlikleri günlüğe kaydediyorsa ve her şey doğru ayarlanmış gibi görünüyorsa ancak hâlâ SDK algılama mesajını veya işlenen verileri görmüyorsunuz (2 saat sonra) Firebase Destek Ekibi ile iletişime geçin.

Uygulama, etkinlikleri günlüğe kaydetmiyor: sorun giderme adımları

1. Performance Monitoring SDK'sının olmadığından emin olun devre dışı Info.plist dosyanızda aşağıdaki işaretlerden birini kullanın:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Performance Monitoring'in çalışma zamanında devre dışı olmadığından emin olun (Swift | Obj-C).

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

Console'da SDK'nın algılandı ancak hiçbir veri gösterilmiyor

Performance Monitoring, performans etkinliği verilerini Performans kontrol paneli.

"SDK algılandı"nın üzerinden 24 saatten uzun süre geçtiyse mesaj görüntülendi ve hâlâ veri görmüyorsanız daha sonra Bir Firebase Durum Kontrol Paneli devam edebilir. Kesinti yoksa Firebase Destek Ekibi ile iletişime geçin.

Genel sorun giderme

SDK'yı başarıyla eklediyseniz ve uygulamanızda Performance Monitoring'i kullanıyorsanız aşağıdaki sorun giderme ipuçları, sorun giderme ile ilgili genel sorunlarda yardımcı olabilir: Performance Monitoring özellikleri ve araçları.

Uygulama günlüğe kaydetmiyor performans etkinlikleri

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

1. Performance Monitoring SDK'sının olmadığından emin olun devre dışı Info.plist dosyanızda aşağıdaki işaretlerden birini kullanın:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Performance Monitoring'in çalışma zamanında devre dışı olmadığından emin olun (Swift | Obj-C).

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

Performans kontrol paneli ekran izleme verileri eksik

Ekran oluşturma izlerine ilişkin verileriniz eksikse aşağıdakileri deneyin sorun giderme adımları:

1. Apple platformlar SDK'sının en son sürümünü kullandığınızdan emin olun (sürüm 10.29.0). Ekran oluşturma izleri yalnızca kullanılabilir veya 5.0.0 ya da üzeri sürümlerden birine sahip olmalıdır.

2. Performance Monitoring, kapsayıcı görünümü için ekran oluşturma izleri oluşturmuyor kontrol eder (ör. UINavigationController ve UITabBarController). Eğer yalnızca bu ekranlar için veri eksikse bu beklenen davranıştır.

Performans kontrol paneli özel izleme verileri eksik

Otomatik olarak toplanan izlere ait performans verilerini görünüyor ancak bu veriler için değil mi? izin veriliyor mu? Aşağıdaki sorun giderme adımlarını deneyin:

1. Trace API Özellikle aşağıdakiler:

   • Özel kod izlemelerin ve özel metriklerin adları aşağıdaki gibi olmalıdır: koşullar: başta veya sonda boşluk veya alt çizgi olmamalıdır (_) karakter ve maksimum uzunluk 32 karakterdir.
   • Tüm izler başlatılmalı ve durdurulmalıdır. Başlatılmayan herhangi bir iz durdurulan veya başlatılmadan önce durdurulan içerikler günlüğe kaydedilmez.

2. Günlük mesajlarınızı kontrol ederek Performance Monitoring, beklenen özel kod izlerini günlüğe kaydediyor.

3. Performance Monitoring etkinlikleri günlüğe kaydediyorsa ancak 24 saat geçmesine rağmen veri gösterilmiyorsa Firebase Destek Ekibi ile iletişime geçin.

Performans kontrol paneli ağ isteği verisi eksik

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

1. Ağ kitaplığı uyumsuzluğunu kontrol edin. Performance Monitoring otomatik olarak ağ istekleri için metrik toplar şu ağ kitaplıklarını kullanan:

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

   Ağ için özel izleme ekleyebileceğinize dikkat edin. istekleri hakkında daha fazla bilgi edinin.

2. Aşağıdakilere dikkat edin:

   • yoksa Performance Monitoring yalnızca tamamlandı. Bu nedenle, açık kalan HTTP/S bağlantıları bildirilebilir.

   • Performance Monitoring, geçersiz ağ istekleri hakkında rapor oluşturmaz Content-Type başlık. Ancak Yine de Content-Type başlık kabul edilir.

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

Performance Monitoring'in ağ isteklerini nasıl topladığı hakkında daha fazla bilgi verileri bölümünde de görebilirsiniz.

Ayrıca, özel URL'yi de görebilirsiniz!

SSS

iOS+ Android Web

Proje ana sayfasındaki Performans kartında yer alan En Önemli Sorunlar'a ne oldu?

Bu güncellemenin devamı olarak En Sık Karşılaşılan Sorunlar'ı Son Uyarılar ile değiştirdik en son kullanıma sunulan uyarılarla, eşiklerinin de aşıldığını görebilirsiniz. Sorunlar kullanımdan kaldırıldı uyarılarıyla değiştirilmiştir.

Performans kartının üst kısmındaki uygulama seçici uyarıyı filtreler Son Uyarılar altındaki girişlerde kullanılabilir. Yalnızca seçilen uygulamalar görüntüleniyor.

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

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

Performance Monitoring, boyutu aşan metrikler için uyarıları destekler: eşik değerleridir. Bu yapılandırılabilir eşiklerle ilgili karmaşayı önlemek için daha önce belirttiğimiz gibi, sorunlar hakkında daha fazla bilgi edinin.

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

Ayrıntılar ve Metrikler sayfalarını, yeni tasarıma sahip, merkezileştirilmiş kullanıcı arayüzünü (UI) kullanarak sorunları giderme şeklinizi iyileştirir. Bu yeni sorun giderme kullanıcı arayüzünün, Ayrıntılar ve Sunulan metrikler. Sorun giderme hakkında daha fazla bilgi edinmek için bkz. Belirli bir iz için daha fazla veri görüntüleyin.

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

Performance Monitoring, uygulamanızın kullanıcı cihazlarından performans verilerini toplar. Eğer uygulamanın çok sayıda kullanıcısı varsa veya uygulama yüksek miktarda performans sergiliyorsa etkinliği varsa Performance Monitoring, veri toplamayı cihazların bir alt kümesiyle sınırlayabilir. işlenen etkinliklerin sayısını azaltır. Bu sınırlar şu kadar yüksektir: daha az etkinlikle olsa bile metrik değerleri hâlâ en iyi uygulamaları paylaşacağız.

Performance Monitoring, topladığımız veri hacmini yönetmek için aşağıdaki yöntemleri kullanır: örnekleme seçenekleri:

• Cihaz üzerinde hız sınırlaması: Bir cihazın, aniden oluşan bir web sitesinden gönderilen kod ve ağ isteği izlerinin sayısını her 10 dakikada bir 300 etkinliğe ekleyebilirsiniz. Bu yaklaşım, cihazınızı Büyük miktarlarda performans verisi gönderebilen döngüsel enstrümanlar ve tek bir cihazın performans ölçümlerini çarpıtmasını önler.

• Dinamik örnekleme: Performance Monitoring yaklaşık 100 milyonluk bir sınır toplar Uygulama başına günlük kod izleme etkinlikleri ve ağ isteği izleri için 100 milyon elde etti. Cihazlarda bir dinamik örnekleme hızı getirilir ( Firebase Remote Config'i kullanarak rastgele bir cihazın izin verdiğinden emin olmalısınız. Örnekleme için seçilmeyen bir cihazda, etkinlik gönderebilirsiniz. Dinamik örnekleme hızı uygulamaya özeldir ve toplanan veri hacminin sınırın altında kalmasını sağlamak.

  Kullanıcı oturumları, kullanıcının cihazından ek, ayrıntılı veriler gönderir. Bu veriler, verilerin yakalanıp gönderilmesi için daha fazla kaynak sağlanmalıdır. Kullanıcının etkisini en aza indirmek için oturum sayısı ise Performance Monitoring, oturum sayısını da kısıtlayabilir.

• Sunucu tarafı hız sınırlaması: Uygulamaların örneklemeyi aşmamasını sağlamak için performans izleme, bazı etkinlikleri kaldırmak için sunucu tarafı örneklemeyi cihazlardan alındı. Bu tür bir sınırlama, mevcut kampanyanın metriklerimizin etkili olmaması, performans metriklerimiz de dahil olmak üzere takip etmek için:

  • İz sayısı, bir parçanın kaç kez izlendiğinden farklı olabilir. kodu yürütüldü.
  • Kodda yakından bağlantılı olan izlerin her biri farklı sayıda kullanabilirsiniz.

ziyaret edin.

Not: Belirli örnekleme sınırları ve bunların uygulamaları, Performance Monitoring ile birlikte değişebilir olduğunu göreceksiniz.

Konsoldaki Sorunlar sekmesine ne oldu?

Sorunlar sekmesinin yerine, Uyarılar'ı kullanıma sunduk. Belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendirir. Sen hayır Firebase konsolunun durumunu manuel olarak kontrol etmesi daha uzun belirleyebilirsiniz. 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 sayfalarda bulunan izleri nasıl görüntüleyebilirim?

Firebase konsolunun Performans İzleme bölümünü yeniden tasarladık: Kontrol Paneli sekmesi, temel metriklerinizi ve tüm izlerinizi tek bir yerde görüntüler. Farklı Yeniden tasarımın bir parçası olarak Cihazda ve Ağ sayfalarını kaldırdık.

Kontrol Paneli sekmesinin alt kısmındaki iz tablosunda da Cihazda ve Ağ sekmelerinin gösterildiği ancak bazı izlerinizi yüzdeye göre sıralama olanağı da dahil olmak üzere yeni veya belirli bir metrik için Belirli bir konuyla ilgili tüm metrikleri ve verileri görüntülemek için: iz tablosundaki iz adını tıklayın.

İz tablosunun aşağıdaki alt sekmelerinde izlerinizi 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, arka plandaki uygulama izleri — Özel izler alt sekmesi
• Ekran oluşturma izleri — Ekran oluşturma alt sekmesi
• Sayfa yükleme izleri — Sayfa yükleme alt sekmesi

İz tablosuyla ve metrikler ile verileri görüntülemeyle ilgili ayrıntılar için şu sayfayı ziyaret edin: konsol genel bakış sayfası (iOS+ | Android | Web).

Yavaş ve donmuş kare sayısı neden beklediğim kadar değil?

Yavaş oluşturma kareleri ve donmuş kareler, varsayılan bir cihazla hesaplanır 60 Hz yenileme hızı. Cihazın yenileme hızı 60 Hz'in altındaysa her karede daha yavaş bir oluşturma süresine sahip olur. Bunun nedeni, saniye başına daha az kare oluşturulmasıdır. Daha yavaş oluşturma süreleri, daha yavaş veya donmuş karelerin raporlanmasına neden olabilir çünkü daha fazla kare daha yavaş oluşturulacak veya donacak. Ancak, bir cihaz Yenileme hızı 60 Hz'in üzerindeyse her karede oluşturma süresi daha kısa olur. Bu durum, daha az sayıda yavaş veya donmuş karenin raporlanmasına neden olabilir. Bu güncel bir bunlarla sınırlı değildir.

Performance Monitoring verilerimin hedefine aktarılması beklenenden uzun sürüyor BigQuery'ye gidin. Gerçek zamanlı değil mi?

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

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

Neredeyse gerçek zamanlı veri işleme ve görüntüleme

"Gerçek zamanlıya yakın" ne demek performans verilerinin anlamı nedir?

Firebase Performance Monitoring, toplanan performans verilerini işleme alır. Bu veriler, Firebase konsolunda neredeyse gerçek zamanlı veri gösterilmesini sağlar. İşlendi Veriler, toplandıktan birkaç dakika sonra konsolda görüntülenir. Dolayısıyla neredeyse aynı değildir.

Neredeyse gerçek zamanlı veri işlemeden yararlanmak için uygulamanızda gerçek zamanlı uyumlu SDK sürümü) tıklayın.

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

Neredeyse gerçek zamanlı veri işlemeden yararlanmak için yalnızca uygulamanızın gerçek zamanlı testlerle uyumlu bir Performance Monitoring SDK sürümü veri işleme sürecidir.

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

• iOS — v7.3.0 veya sonraki sürümler
• tvOS: v8.9.0 veya sonraki sürümler
• Android: 19.0.10 veya üzeri (ya da Firebase Android BoM 26.1.0 veya sonraki sürümler)
• Web — v7.14.0 veya sonraki sürümler

Her zaman SDK'nın en son sürümünü kullanmanızı öneriyoruz ancak sürümü, Performance Monitoring'in verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlar gerekir.

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

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

• iOS — v7.3.0 veya sonraki sürümler
• tvOS: v8.9.0 veya sonraki sürümler
• Android: 19.0.10 veya üzeri (ya da Firebase Android BoM 26.1.0 veya sonraki sürümler)
• Web — v7.14.0 veya sonraki sürümler

Her zaman SDK'nın en son sürümünü kullanmanızı öneriyoruz ancak sürümü, Performance Monitoring'in verilerinizi neredeyse gerçek zamanlı olarak işlemesini sağlar gerekir.

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ü kullanmasa bile uygulamanızın tüm performans verilerini Firebase konsolunda bulabilirsiniz. Ancak ekran tarihinden itibaren yaklaşık 36 saat gecikmeli olarak koleksiyonudur.

Gerçek zamanlı uyumlu bir SDK sürümüne güncelleme yaptım ancak kullanıcılarımdan bazıları hâlâ uygulamamın eski sürümlerini kullanıyor. Performanslarını görmeye devam edecek miyim? verileri tekrarlanıyor mu?

Evet! Uygulama örneğinin kullandığı SDK sürümünden bağımsız olarak tüm kullanıcılarınızdan gelen performans verileri.

Ancak, yeni verilere (yaklaşık 36 saatten daha eski) bakıyorsanız gösterilen veriler, gerçek zamanlı analiz verileri kullanılarak uygulama örneklerinin uyumlu bir SDK sürümü. Bununla birlikte, yeni olmayan veriler performans verilerini içerir. uygulamanızın tüm sürümlerinden kaldırabilirsiniz.

Firebase Destek Ekibi ile iletişime geçme

Şu durumda: Firebase Destek Ekibi ile iletişime geçin. Firebase Uygulama Kimliğinizi her zaman ekleyin. Firebase uygulama kimliğinizi şurada bulabilirsiniz: Hesabınıza ait Uygulamalarınız Proje Ayarlar'a gidin.