Performance Monitoring ile ilgili sorunları giderme ve SSS

iOS+ Android Web

Bu sayfada, Performance Monitoring veya Performance Monitoring özelliklerini ve araçlarını kullanarak.

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 performans etkinliklerini yakaladığından emin olmak için günlük mesajlarınızı kontrol edin.

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 v15.2) Ü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. Günlük mesajlarınızda hata mesajı olup olmadığını 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 öğesinin aşağıdaki gibi olduğunu gösteren günlük türleri 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

Firebase veya Performance Monitoring için bilinen bir kesinti varsa Firebase Durum Kontrol Paneli'ni kontrol edin.

Performance Monitoring kullanmaya başlama

Performance Monitoring 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 ilk performans verilerinizi Firebase konsolunda görebilirsiniz.

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

Firebase, Performance Monitoring SDK'sını uygulamanıza 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 raporu, kontrol paneli Firebase konsolunda "SDK algılandı" mesajı 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 mesajlarının Performance Monitoring tarafından günlüğe kaydedildiğ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 toplu 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. Yeni bir yapılandırma dosyası indirip Apple uygulamanıza eklemek için bu talimatları uygulayın.

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 kaydetmez: 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 kullanarak yapabilirsiniz:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Performance Monitoring hizmetinin ç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 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 kullanarak yapabilirsiniz:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Performance Monitoring hizmetinin ç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 11.2.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. Performance Monitoring'nin beklenen özel kod izlerini kaydettiğinden emin olmak için günlük mesajlarınızı kontrol edin.

3. Performance Monitoring etkinlikleri günlüğe kaydediyorsa ancak 24 saat geçmesine rağmen veri görüntülenmiyorsa 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:

   • Performance Monitoring, yalnızca şuna uyan ağ isteklerini raporlayabilir: tamamlandı. Bu, açık bırakılan HTTP/S bağlantılarının raporlanmayacağı anlamına gelir.

   • 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 uygulamasının ağ isteklerini nasıl topladığı hakkında daha fazla bilgi verilerini URL kalıpları bölümünde bulabilirsiniz.

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 uygulamalarla ilgili en son üç uyarı gösterilir.

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, şu metriği aşan metrikler için uyarıları destekler: eşik değerleridir. 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 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 yoksa 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, 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, 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) 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 sınırında, Performance Monitoring bazı etkinlikleri kaldırmak için sunucu tarafı örneklemeyi kullanabilir 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.

Not: Özel örnekleme sınırları ve bunların uygulanması Performance Monitoring olarak değişebilir. olduğunu göreceksiniz.

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 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 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. 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 sınırlaması Performance Monitoring SDK'sıdır.

Performance Monitoring verilerimin dışa 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

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

Firebase Performance Monitoring, toplanan performans verilerini gelen verileri işler. Bu da sayesinde, Firebase konsolunda neredeyse gerçek zamanlı veriler görüntüleyebilirsiniz. İş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ı verilerle uyumlu bir Performance Monitoring SDK sürümü kullandığını 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 sonraki sürümler (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ı ö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ş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 sonraki sürümler (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 uygulamasının verilerinizi neredeyse gerçek zamanlı olarak işleyebilmesini 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 Firebase konsolunda uygulamanızın tüm performans verileri. 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 Firebase konsolunda görüntülenebilir mi?

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 İletiş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.