Bu sayfa, Performans İzlemeye başlamak veya Performans İzleme özelliklerini ve araçlarını kullanmak için sorun giderme ipuçları sağlar.
Sorun giderme için ilk kontroller
Aşağıdaki iki kontrol, daha fazla sorun gidermeden önce herkes için önerilen genel en iyi uygulamalardır.
1. Performans olayları için günlük mesajlarını kontrol edin
Performans İzleme SDK'sının performans olaylarını yakaladığından emin olmak için günlük iletilerinizi kontrol edin.
Performans olayları için günlük mesajları nasıl görüntülenir?
Performans olayları için günlük mesajları nasıl görüntülenir?
Hata ayıklama günlüğünü aşağıdaki gibi etkinleştirin:
- Xcode'da (minimum v12.2), Product > Scheme > Edit Scheme öğesini seçin.
- Soldaki menüden Çalıştır'ı seçin, ardından Bağımsız Değişkenler sekmesini seçin.
- Başlatmada
-FIRDebugEnabledBağımsız Değişkenler bölümünde,
-FIRDebugEnabledekleyin.
Herhangi bir hata mesajı için günlük mesajlarınızı kontrol edin.
Performans İzleme, günlük mesajlarınızı filtreleyebilmeniz için günlük mesajlarını
Firebase/Performanceile etiketler.
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
-
Firebase konsolunda verilerinizi 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 kaydedmiyorsa sorun giderme ipuçlarını inceleyin .
2. Firebase Durum Kontrol Panelini Kontrol Edin
Firebase veya Performance Monitoring için bilinen bir kesinti olması durumunda Firebase Status Dashboard'u kontrol edin.
Performans İzlemeye Başlarken
Performans İzleme'yi ( iOS | Android | Web ) kullanmaya başlıyorsanız, aşağıdaki sorun giderme ipuçları, Firebase'in SDK'yı algılamasını veya Firebase konsolunda ilk performans verilerinizi görüntülemesini içeren sorunlarda yardımcı olabilir.
Uygulamaya SDK eklendi, ancak konsol hala SDK eklediğini söylüyor
Firebase, uygulamanızdan etkinlik bilgileri (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 panosunda bir "SDK algılandı" mesajı görüntülenir. Ardından, 30 dakika içinde gösterge tablosu ilk işlenmiş verileri görüntüler.
Uygulamanıza SDK'nın en son sürümünü eklemenizin üzerinden 10 dakikadan fazla zaman geçtiyse ve hâlâ herhangi bir değişiklik görmüyorsanız, Performans İzleme'nin olayları günlüğe kaydettiğinden emin olmak için günlük mesajlarınızı kontrol edin . Gecikmeli bir SDK algılama mesajıyla ilgili sorunları gidermek için aşağıda açıklanan uygun sorun giderme adımlarını deneyin.
Uygulama olayları günlüğe kaydediyor: sorun giderme adımları
Uygulama olayları günlüğe kaydediyor: sorun giderme adımları
Hâlâ yerel olarak geliştiriyorsanız, veri toplama için daha fazla olay oluşturmayı deneyin:
Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.
Uygulamanızı arka plan ve ön plan arasında birkaç kez değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşimde bulunarak ve/veya ağ isteklerini tetikleyerek olaylar oluşturun.
Firebase yapılandırma dosyanızın (
Google-Service-Info.plist) uygulamanıza doğru şekilde eklendiğinden ve dosyayı değiştirmediğinizden emin olun. Özellikle, aşağıdakileri kontrol edin:
Yapılandırma dosyası adı,
(2)gibi ek karakterlerle eklenmez.
Yapılandırma dosyası, XCode projenizin kökündedir ve doğru hedeflere eklenmiştir.
Yapılandırma dosyasında listelenen Firebase iOS Uygulama Kimliği (
GOOGLE_APP_ID), uygulamanız için doğrudur. Firebase Uygulama Kimliğinizi, Proje ayarlarındaki Uygulamalarınız kartında bulun.
Uygulamanızdaki yapılandırma dosyasında bir sorun varsa aşağıdakileri deneyin:
Şu anda uygulamanızda bulunan yapılandırma dosyasını silin.
Yeni bir yapılandırma dosyası indirmek ve onu iOS uygulamanıza eklemek için bu talimatları izleyin.
SDK, olayları günlüğe kaydediyorsa ve her şey doğru ayarlanmış gibi görünüyorsa ancak yine de SDK algılama mesajını veya işlenmiş verileri görmüyorsanız (2 saat sonra), Firebase Destek ile iletişime geçin .
Uygulama olayları günlüğe değildir: sorun giderme adımlarını
Uygulama olayları günlüğe değildir: sorun giderme adımlarını
Emin olun SDK Performans İzleme devre dışı değildir senin şu bayraklar birini yoluyla
Info.plistdosyasının:
-
firebase_performance_collection_enabled
-
firebase_performance_collection_deactivated
-
Uygulamanızda devre dışı bırakılmış bir şey bulamazsanız Firebase Destek ile iletişime geçin .
Konsol, SDK'nın algılandığını söylüyor, ancak hiçbir veri görüntülenmiyor
Performans İzleme, performans olay verilerini Performans panosunda görüntülemeden önce işler.
"SDK algılandı" mesajının görüntülenmesinden bu yana 24 saatten fazla zaman geçtiyse ve hala veri görmüyorsanız, bilinen bir kesinti olması ihtimaline karşı Firebase Durum Kontrol Panelini kontrol edin. Kesinti yoksa Firebase Destek ile iletişime geçin .
Genel sorun giderme
SDK'yı başarıyla eklediyseniz ve uygulamanızda Performans İzleme'yi kullanıyorsanız, aşağıdaki sorun giderme ipuçları, Performans İzleme özelliklerini ve araçlarını içeren genel sorunlara yardımcı olabilir.
Uygulama, performans olaylarını günlüğe kaydetmiyor
Performans olayları için günlük mesajları görmüyorsanız, aşağıdaki sorun giderme adımlarını deneyin:
Emin olun SDK Performans İzleme devre dışı değildir senin şu bayraklar birini yoluyla
Info.plistdosyasının:
-
firebase_performance_collection_enabled
-
firebase_performance_collection_deactivated
-
Uygulamanızda devre dışı bırakılmış bir şey bulamazsanız Firebase Destek ile iletişime geçin .
Performans panosunda ekran izleme verileri eksik
Ekran işleme izleri için veri eksikse, aşağıdaki sorun giderme adımlarını deneyin:
Performans panosunda özel izleme verileri eksik
Otomatik olarak toplanan izler için performans verilerini görüyor musunuz, ancak özel kod izleri için görmüyor musunuz? Aşağıdaki sorun giderme adımlarını deneyin:
Trace API aracılığıyla uygulanan özel kod izlemelerinin kurulumunu, özellikle aşağıdakileri kontrol edin:
- Özel kod izleri ve özel metrikler için adlar aşağıdaki gereksinimleri karşılamalıdır: Başta veya sonunda boşluk yok, baştaki alt çizgi (
_) karakteri yok ve maksimum uzunluk 32 karakterdir.
- Tüm izler başlatılmalı ve durdurulmalıdır. Başlatılmamış, durdurulmamış veya başlatılmadan önce durdurulmuş hiçbir izleme kaydedilmeyecektir.
- Özel kod izleri ve özel metrikler için adlar aşağıdaki gereksinimleri karşılamalıdır: Başta veya sonunda boşluk yok, baştaki alt çizgi (
Performans İzleme'nin beklenen özel kod izlerini günlüğe kaydettiğinden emin olmak için günlük iletilerinizi kontrol edin .
Performans panosunda ağ isteği verileri eksik
Ağ isteği verileriniz eksikse aşağıdaki sorun giderme adımlarını deneyin:
Ağ kitaplığı uyumsuzluğunu kontrol edin. Performans İzleme, aşağıdaki ağ kitaplıklarını kullanan ağ istekleri için ölçümleri otomatik olarak toplar :
- Swift için: URLSession ve URLConnection
- Objective-C için: NSURLSession ve NSURLConnection
Aşağıdakilere dikkat edin: Kodunuzun davranışına ve kodunuz tarafından kullanılan ağ kitaplıklarına bağlı olarak, Performans İzleme yalnızca tamamlanan ağ isteklerini rapor edebilir. 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
Ayrıca özel URL kalıplarını da deneyebilirsiniz!
SSS
Konsoldaki Cihazda veya Ağ sekmelerini tıkladığımda, otomatik olarak Gösterge Tablosu sekmesinin en altına yönlendiriliyorum. Bu sayfalardaki izleri nasıl görebilirim?
Firebase konsolunun Performans İzleme bölümünü yeniden tasarladık, böylece Pano sekmesi temel ölçümlerinizi ve tüm izlerinizi tek bir alanda gösterir.
Yakında Cihazda ve Ağ sekmelerini kaldıracağız. Bu nedenle, şu anda, bu sekmelerden birine tıkladığınızda, sizi tüm izlerinizi görüntülemek için yeni yere gönderiyoruz - Gösterge Tablosu sekmesinin altındaki izleme tablosu .
İzler tablosu, Cihazda ve Ağ sekmelerinde görüntülenen bilgilerin tümüne sahiptir, ancak izlerinizi belirli bir ölçüm için yüzde değişikliğine göre sıralama yeteneği de dahil olmak üzere bazı ek özellikler içerir. Belirli bir izleme için tüm metrikleri ve verileri görüntülemek için izleme tablosundaki izleme adını tıklayın.
İzlerinizi, izleme tablosunun aşağıdaki alt sekmelerinde 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şlangıcı, ön planda uygulama, arka planda uygulama izleri — Özel izlemeler alt sekmesi
- Ekran işleme izleri — Ekran işleme alt sekmesi
- Sayfa yükleme izleri — Sayfa yükleme alt sekmesi
İzler tablosundaki bir iz adına tıklayarak (sizi izin Metrikler sayfasına götürür), ardından ekranın üst kısmındaki içerik haritalarına tıklayarak Cihazda ve Ağ sekmelerinde gezinebileceğinizi unutmayın.
Performans İzleme verilerimin BigQuery'ye aktarılması beklenenden uzun sürüyor. Gerçek zaman değil mi?
Firebase Performance Monitoring için BigQuery entegrasyonunu etkinleştirdiyseniz verileriniz günün sonundan (Pasifik Saati) 12 ila 24 saat sonra BigQuery'ye aktarılır.
Örneğin, 19 Nisan'a ait veriler 20 Nisan'da saat 12:00 ile gece yarısı arasında BigQuery'de kullanılabilir (tüm tarihler ve saatler Pasifik Saati'dir).
Gerçek zamanlıya yakın veri işleme ve görüntüleme
"Gerçek zamanlıya yakın" performans verileri ne anlama geliyor?
Firebase Performance Monitoring, toplanan performans verilerini geldiği anda işler ve bu da Firebase konsolunda neredeyse gerçek zamanlı veri görüntülemesiyle sonuçlanır. İşlenen veriler, toplandıktan sonra birkaç dakika içinde konsolda görüntülenir, bu nedenle "neredeyse gerçek zamanlı" terimi.
Gerçek zamanlıya yakın veri işlemeden 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şlemeden 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.
Bunlar gerçek zamanlı uyumlu SDK sürümleridir:
- iOS — v7.3.0 veya üstü
- Android — v19.0.10 veya üzeri (veya Firebase Android BoM v26.1.0 veya üzeri)
- Web — v7.14.0 veya üstü
Her zaman SDK'nın en son sürümünü kullanmanızı önerdiğimizi unutmayın, ancak yukarıda listelenen herhangi bir sürüm, Performans İzleme'nin verilerinizi neredeyse gerçek zamanlı olarak işlemesine olanak tanır.
Performans İzleme SDK'sının hangi sürümleri gerçek zamanlı uyumlu olarak kabul edilir?
Bunlar, gerçek zamanlı veri işleme ile uyumlu SDK sürümleridir:
- iOS — v7.3.0 veya üstü
- Android — v19.0.10 veya üzeri (veya Firebase Android BoM v26.1.0 veya üzeri)
- Web — v7.14.0 veya üstü
Her zaman SDK'nın en son sürümünü kullanmanızı önerdiğimizi unutmayın, ancak yukarıda listelenen herhangi bir sürüm, Performans İzleme'nin verilerinizi neredeyse gerçek zamanlı olarak işlemesine olanak tanır.
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ü kullanmıyorsa uygulamanızın tüm performans verilerini Firebase konsolunda görmeye devam edeceksiniz. Bununla birlikte, performans verilerinin görüntülenmesi, toplandığı andan itibaren yaklaşık 36 saat gecikecektir.
Gerçek zamanlı uyumlu bir SDK sürümüne güncelledim, ancak bazı kullanıcılarım hala uygulamamın eski sürümlerini kullanıyor. Firebase konsolunda performans verilerini görmeye devam edecek miyim?
Evet! Bir uygulama örneğinin kullandığı SDK sürümü ne olursa olsun, tüm kullanıcılarınızdan gelen performans verilerini görürsünüz.
Ancak, en son verilere bakıyorsanız (yaklaşık 36 saatten daha eski), bu durumda görüntülenen veriler, gerçek zamanlı uyumlu bir SDK sürümü kullanan uygulama örneklerinin kullanıcılarına aittir. Ancak yakın zamana ait olmayan veriler, uygulamanızın tüm sürümlerine ait performans verilerini içerir.