Performans İzleme, uygulamanızın performansını izlemenize yardımcı olmak için izler toplar. İzleme, uygulamanızda zamanın iki noktası arasında yakalanan performans verilerinin bir raporudur.
Uygulamanızdaki belirli kodla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel bir kod izleme ile, uygulamanızın belirli bir görevi veya bir dizi görevi tamamlamasının (örneğin, bir dizi resim yüklemek veya veritabanınızı sorgulamak) ne kadar sürdüğünü ölçebilirsiniz.
Özel bir kod izleme için varsayılan ölçü, "süre"dir (izlemenin başlangıç ve bitiş noktaları arasındaki süre), ancak özel ölçüler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'leri kullanarak özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız.
Özel kod izlemeleri, oluşturulduktan sonra herhangi bir zamanda başlatılabilir ve iş parçacığı için güvenlidir.
Bu izler için toplanan varsayılan metrik "süre" olduğundan, bunlara bazen "Süre izleri" adı verilir.
Bu izlerden gelen verileri, Performans panosunun alt kısmında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz ( konsolu kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen kısımlarında bulabilirsiniz).
Varsayılan nitelikler, özel nitelikler ve özel metrikler
Özel kod izlemeleri için Performance Monitoring, Firebase konsolundaki izleme verilerini filtreleyebilmeniz için varsayılan öznitelikleri (uygulama sürümü, ülke, cihaz vb. gibi yaygın meta veriler) otomatik olarak günlüğe kaydeder. Ayrıca özel nitelikler (oyun düzeyi veya kullanıcı özellikleri gibi) ekleyebilir ve izleyebilirsiniz.
İzleme kapsamında meydana gelen performansla ilgili olaylara yönelik özel ölçümleri kaydetmek için ayrıca özel bir kod izlemesi yapılandırabilirsiniz. Örneğin, önbellek isabetlerinin ve ıskalamalarının sayısı veya kullanıcı arayüzünün fark edilebilir bir süre boyunca yanıt vermeme sayısı için özel bir ölçüm oluşturabilirsiniz.
Özel nitelikler ve özel metrikler, Firebase konsolunda iz için varsayılan öznitelikler ve varsayılan metrikle birlikte görüntülenir.
Özel kod izleri ekleyin
Belirli uygulama kodunu izlemek üzere özel kod izlemeleri eklemek için Performance Monitoring Trace API'yi kullanın.
Aşağıdakilere dikkat et:
- Bir uygulamanın birden fazla özel kod izi olabilir.
- Birden fazla özel kod izleme aynı anda çalışabilir.
- Özel kod izleme adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi (
_) karakteri yok ve maksimum uzunluk 100 karakter. - Özel kod izlemeleri , özel ölçümler ve özel nitelikler eklemeyi destekler.
Özel kod izlemeyi başlatmak ve durdurmak için izlemek istediğiniz kodu aşağıdakine benzer bir kodla sarın:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Özel kod izlerine özel ölçümler ekleyin
Özel kod izlemelerine özel ölçümler eklemek için Performance Monitoring Trace API'yi kullanın.
Aşağıdakilere dikkat et:
- Özel metrik adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi (
_) karakteri yok ve maksimum uzunluk 100 karakter. - Her bir özel kod izi, 32 adede kadar ölçüm kaydedebilir (varsayılan Süre ölçümü dahil).
Özel bir metrik eklemek için, olayın her gerçekleştiğinde aşağıdakine benzer bir kod satırı ekleyin. Örneğin, bu özel metrik, önbellek isabetleri veya yeniden denemeler gibi uygulamanızda meydana gelen performansla ilgili olayları sayar.
Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();
// Code you want to trace
customTrace.incrementMetric("metric-name", 1);
// More code
await customTrace.stop();
Özel kod izleri için özel nitelikler oluşturun
Özel öznitelikleri kullanmak için, uygulamanıza özelliği tanımlayan ve onu belirli bir özel kod izlemeyle ilişkilendiren kod ekleyin. Özel özniteliği izlemenin başladığı ve durduğu an arasında herhangi bir zamanda ayarlayabilirsiniz.
Aşağıdakilere dikkat et:
Özel niteliklerin adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi (
_) karakteri yok ve maksimum uzunluk 32 karakter.Her bir özel kod izi, en fazla 5 özel öznitelik kaydedebilir.
Bir kişiyi Google'a kişisel olarak tanımlayan bilgiler içeren özel özellikler kullanmamalısınız.
Performance Monitoring, adlar, e-posta adresleri veya telefon numaraları gibi kişisel olarak tanımlanabilir bilgileri (PII) toplamaz. Geliştiriciler, özel kod izlerinde özel nitelikler oluşturarak Performance Monitoring'i kullanarak ek veriler toplayabilir. Performance Monitoring aracılığıyla toplanan bu tür veriler, Google'a bir kişiyi kişisel olarak tanımlayan bilgiler içermemelidir.
Aşağıda, kişisel olarak tanımlanabilir bilgiler içermeyen bir günlük mesajı örneği verilmiştir:
customTrace.putAttribute("experiment", "A"); // OKAşağıda, kişisel olarak tanımlanabilir bilgiler içermeyen bir örnek verilmiştir (uygulamanızda bu tür bir özel özellik kullanmayın):
customTrace.putAttribute(("email", user.getEmailAddress()); // Don't do this!Herhangi bir kişisel olarak tanımlanabilir bilgiyi ifşa eden veriler, bildirimde bulunulmaksızın silinmeye tabidir.
Trace trace = FirebasePerformance.instance.newTrace("test_trace");
// Update scenario.
trace.putAttribute("experiment", "A");
// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");
// Delete scenario.
trace.removeAttribute("experiment");
// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
Performans verilerini izleyin, görüntüleyin ve filtreleyin
Kontrol panelinizde belirli metrikleri izleyin
Temel metriklerinizin nasıl bir trend olduğunu öğrenmek için bunları Performans kontrol panelinin üst kısmındaki metrik panonuza ekleyin. Haftadan haftaya değişiklikleri görerek regresyonları hızla belirleyebilir veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayabilirsiniz.
Metrik panonuza bir metrik eklemek için Firebase konsolundaki Performans kontrol paneline gidin ve ardından Kontrol Paneli sekmesini tıklayın. Boş bir metrik kartı tıklayın, ardından panonuza eklemek için mevcut bir metriği seçin. Bir metriği değiştirmek veya kaldırmak gibi daha fazla seçenek için doldurulmuş bir metrik kartındaki dikey üç noktaya ( ⋮ ) tıklayın.
Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçimde hem de sayısal yüzde değişimi olarak gösterir.
Kontrol panelini kullanma hakkında daha fazla bilgi edinin.
İzleri ve verilerini görüntüleyin
İzlerinizi görüntülemek için Firebase konsolundaki Performans panosuna gidin, izler tablosuna gidin ve uygun alt sekmeyi tıklayın. Tablo, her iz için bazı en iyi metrikleri gösterir ve hatta listeyi belirli bir metrik için değişim yüzdesine göre sıralayabilirsiniz.
İzler tablosunda bir iz adına tıklarsanız, izi keşfetmek ve ilgilenilen metrikleri derinlemesine incelemek için çeşitli ekranlara tıklayabilirsiniz. Çoğu sayfada, verileri özniteliğine göre filtrelemek için Filtre düğmesini (ekranın sol üst tarafında) kullanabilirsiniz, örneğin:
- Geçmiş bir sürüm veya en son sürümünüz hakkındaki verileri görüntülemek için Uygulama sürümüne göre filtreleyin
- Eski cihazların uygulamanızı nasıl işlediğini öğrenmek için Cihaza göre filtreleyin
- Veritabanı konumunuzun belirli bir bölgeyi etkilemediğinden emin olmak için Ülkeye göre filtreleyin
İzleriniz için verileri görüntüleme hakkında daha fazla bilgi edinin.
Sonraki adımlar
Performans verilerini incelemek için öznitelikleri kullanma hakkında daha fazla bilgi edinin.
Firebase konsolunda performans sorunlarının nasıl izleneceği hakkında daha fazla bilgi edinin.
Uygulamanızın performansını düşüren kod değişiklikleri için uyarılar ayarlayın . Örneğin, belirli bir özel kod izlemenin süresi belirlediğiniz eşiği aşarsa ekibiniz için bir e-posta uyarısı yapılandırabilirsiniz.