Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Performance Monitoring ile ilgili sorunları giderme ve SSS

Bu sayfada, Performance Monitoring'ı kullanmaya başlama veya Performance Monitoring özelliklerini ve araçlarını kullanma ile ilgili sorun giderme ipuçları verilmektedir.

Sorun gidermeyle ilgili ilk kontroller

Aşağıdaki iki kontrol, daha fazla sorun giderme işlemi yapmadan önce herkesin uygulaması önerilen genel en iyi uygulamalardır.

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

Performance Monitoring SDK'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

Hata ayıklama günlük kaydını aşağıdaki şekilde etkinleştirin:
1. Xcode'da (minimum v26.2) Product > Scheme > Edit scheme'i (Şemayı düzenle) seçin.
2. Soldaki menüden Run'ı (Çalıştır) ve ardından Arguments (Bağımsız değişkenler) sekmesini seçin.
3. Arguments Passed on Launch (Başlatmada İletilen Parametreler) bölümüne -FIRDebugEnabled ekleyin.
Günlük mesajlarınızda hata mesajı olup olmadığını kontrol edin.
Performance Monitoring, günlük mesajlarını Firebase/Performance ile etiketler. Böylece günlük mesajlarınızı filtreleyebilirsiniz.
Performance Monitoring'nın performans etkinliklerini 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
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 etkinliklerini kaydetmiyorsa sorun giderme ipuçlarını inceleyin.

2. Firebase Durum Kontrol Paneli'ni kontrol edin

Firebase veya Performance Monitoring için bilinen bir kesinti olup olmadığını öğrenmek üzere Firebase Durum Kontrol Paneli'ni kontrol edin.

Performance Monitoring hizmetini kullanmaya başlama

Performance Monitoring ile çalışmaya başlıyorsanız (iOS+ | Android | Web), aşağıdaki sorun giderme ipuçları, Firebase'in SDK'yı algılaması veya ilk performans verilerinizi Firebase konsolunda göstermesiyle ilgili sorunlara yardımcı olabilir.

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

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

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

Hâlâ yerel olarak geliştirme yapıyorsanız veri toplama için daha fazla etkinlik oluşturmayı deneyin:
1. Simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.
2. Uygulamanızı birkaç kez arka plan ve ön plan arasında değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşim kurarak ve/veya ağ isteklerini tetikleyerek etkinlik 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ına (2) gibi ek karakterler eklenmediğinden emin olun.
- Yapılandırma dosyası, Xcode projenizin kök dizininde bulunur ve doğru hedeflere eklenir.
- Yapılandırma dosyasında listelenen Firebase Apple Uygulama Kimliği (GOOGLE_APP_ID) uygulamanız için doğru. Firebase Uygulama Kimliğinizi Proje ayarlarınızın Uygulamalarınız kartında bulabilirsiniz.
Uygulamanızdaki yapılandırma dosyasında bir sorun olduğunu düşünüyorsanız şunları deneyin:
1. 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.
SDK etkinlikleri kaydediyorsa ve her şey doğru şekilde ayarlanmış gibi görünüyorsa ancak 2 saat sonra SDK algılama mesajını veya işlenmiş verileri hâlâ görmüyorsanız Firebase Destek Ekibi ile iletişime geçin.

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

Performance Monitoring SDK'nın devre dışı bırakılmadığından emin olun. Bu işlem, Info.plist dosyanızdaki aşağıdaki işaretlerden biriyle yapılabilir:
- firebase_performance_collection_enabled
- firebase_performance_collection_deactivated
Çalışma zamanında Performance Monitoring öğesinin devre dışı bırakılmadığından emin olun (Swift | Obj-C).
Uygulamanızda devre dışı bırakılmış bir öğe bulamıyorsanız Firebase Destek Ekibi ile iletişime geçin.

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

Performance Monitoring, performans etkinliği 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ı öğrenmek için Firebase Durum Kontrol Paneli'ni kontrol edin. 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ı, Performance Monitoring özellikleri ve araçlarıyla ilgili genel sorunlara yardımcı olabilir.

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:

Performance Monitoring SDK'nın devre dışı bırakılmadığından emin olun. Bu işlem, Info.plist dosyanızdaki aşağıdaki işaretlerden biriyle yapılabilir:
- firebase_performance_collection_enabled
- firebase_performance_collection_deactivated
Çalışma zamanında Performance Monitoring öğesinin devre dışı bırakılmadığından emin olun (Swift | Obj-C).
Uygulamanızda devre dışı bırakılmış bir öğe bulamıyorsanız Firebase Destek Ekibi ile iletişime geçin.

Performans kontrol panelinde ekran izleme verileri eksik

Ekran oluşturma izleriyle ilgili verileriniz eksikse aşağıdaki sorun giderme adımlarını deneyin:

Performans kontrol panelinde özel izleme verileri eksik

Otomatik olarak toplanan izlemeler için performans verileri görülüyor ancak özel kod izlemeleri için görülmüyor mu? Aşağıdaki sorun giderme adımlarını deneyin:

Trace API aracılığıyla oluşturulan özel kod izlemelerinin 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ı, başta alt çizgi (_) karakteri olmamalı ve maksimum uzunluk 32 karakter olmalıdır.
- Tüm izlemeler başlatılmalı ve durdurulmalıdır. Başlatılmamış, durdurulmamış veya başlatılmadan önce durdurulmuş izler kaydedilmez.
Performance Monitoring öğesinin beklenen özel kod izlerini günlüğe kaydettiğinden emin olmak için günlük mesajlarınızı kontrol edin.
Performance Monitoring etkinlikleri kaydediyor ancak 24 saat sonra veri gösterilmiyorsa Firebase Destek Ekibi 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:

Ağ kitaplığı uyumsuzluğunu kontrol edin. Performance Monitoring Aşağıdaki ağ kitaplıklarını kullanan ağ istekleriyle ilgili metrikleri 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.
Aşağıdakilere dikkat edin:
- 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.
- Performance Monitoring, geçersiz Content-Type başlıklı ağ istekleri hakkında rapor oluşturmaz. Ancak Content-Type başlıkları olmayan ağ istekleri yine de kabul edilecektir.

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

Performance Monitoring'nin 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.

SSS

Proje ana sayfasındaki Performans kartında yer alan En Önemli Sorunlar bölümüne ne oldu?

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 artık kullanımdan kaldı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.

Konsolda 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 yapılandırılabilir bu 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?

Sorun giderme sürecinizi 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.

Neden örnek sayısı beklediğim gibi değil?

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 dizileri göndermesini önlemek için 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ış ölçümlerden 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.

BigQuery entegrasyonunu etkinleştiren projeler, ağ isteği izlerinin sayısı için daha yüksek bir sınır alı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 kaymalarına neden olabilir:
- İz sayısı, bir kod parçasının yürütüldüğü sayıdan farklı olabilir.
- Kodda birbirine yakın olan izlemelerin her birinde farklı sayıda örnek olabilir.

Console'daki Sorunlar sekmesine ne oldu?

Sorunlar sekmesinin yerini, belirlediğiniz eşikler aşıldığında sizi otomatik olarak bilgilendiren Uyarılar aldı. 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ıyla ilgili uyarıları ayarlama 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.

Kontrol paneli 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 izlemeyle ilgili tüm metrikleri ve verileri görüntülemek için izlemeler tablosunda izleme adını tıklayın.

İzlerinizi, izler 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ş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ı ziyaret edin ( iOS+ | Android | Web).

Yavaş ve donmuş karelerin sayısı neden beklediğim gibi değil?

Yavaş oluşturulan kareler ve donan 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 uzun olur. Daha yavaş oluşturma süreleri, daha fazla karenin 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 yavaş veya donmuş karenin bildirilmesine neden olabilir. Bu, Performance Monitoring SDK'daki mevcut bir sınırlamadır.

Performance Monitoring 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ün bitiminden 12-24 saat sonra (Pasifik Saati) BigQuery'ye aktarılır.

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

Kaç ö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.

Gerçek zamanlıya yakın veri işleme ve görüntüleme

"Gerçek zamanlıya yakın" performans verileri ne anlama gelir?

Firebase Performance Monitoring, toplanan performans verilerini geldikçe işler. Bu da Firebase konsolunda neredeyse gerçek zamanlı veri görüntülenmesine neden olur. İşlenen veriler, toplandıktan birkaç dakika sonra konsolda gösterilir. Bu nedenle "neredeyse gerçek zamanlı" terimi kullanılır.

Neredeyse anlık veri işlemeyi kullanmak için uygulamanızın anlık veri işlemeyle uyumlu bir SDK sürümü kullandığından emin olun.

Uygulamam için gerçek zamanlıya yakın performans verilerini nasıl alabilirim?

Neredeyse anlık veri işlemeden yararlanmak için uygulamanızın anlık veri işleme ile uyumlu bir Performance Monitoring SDK sürümü kullandığından emin olmanız yeterlidir.

Gerçek zamanlı 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: 19.0.10 veya sonraki sürümler (ya da Firebase Android BoM 26.1.0 veya sonraki sürümler)
Web: 7.14.0 veya sonraki sürümler

Her zaman SDK'nın en son 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.

Hangi Performance Monitoring SDK sürümleri anlık 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: 19.0.10 veya sonraki sürümler (ya da Firebase Android BoM 26.1.0 veya sonraki sürümler)
Web: 7.14.0 veya sonraki sürümler

Uygulamamı gerçek zamanlı uyumlu bir SDK sürümünü kullanacak şekilde güncellemezsem ne olur?

Uygulamanız anlık 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ı 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 eski olmayan) bakıyorsanız gösterilen veriler, anlık 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.

Performans verilerinin neden anlık olarak gösterilmediğini öğrenin.

Gerçek zamanlı performans verilerini görüntülemek için uygulamanızın, gerçek zamanlı veri işlemeyle uyumlu bir Performance MonitoringSDK 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: 19.0.10 veya sonraki sürümler (ya da Firebase Android BoM 26.1.0 veya sonraki sürümler)
Web: 7.14.0 veya sonraki sürümler

Firebase Destek Ekibi ile iletişime geçme

Firebase Destek Ekibi ile iletişime geçerseniz Firebase uygulama kimliğinizi mutlaka ekleyin. Firebase uygulama kimliğinizi Proje ayarları bölümündeki Uygulamalarınız kartında bulabilirsiniz.