Performance Monitoring, uygulamanızın performansını izlemenize yardımcı olmak için izler toplar. İz, uygulamanızda iki zaman noktası arasında yakalanan performans verilerinin raporudur.
Uygulamanızdaki belirli bir kodla ilişkilendirilmiş performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel kod izleme ile uygulamanızın belirli bir görevi veya bir görev kümesini (örneğin, bir dizi görüntü yüklemek ya da veritabanınızı sorgulamak) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.
Özel kod izleme için varsayılan metrik "süre"dir (izin başlangıç ve bitiş noktaları arasındaki süre). Ancak özel metrikler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK'sının sağladığı API'leri kullanarak özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız.
Özel kod izlemeler, oluşturulduktan sonra istenildiği zaman başlatılabilir ve iş parçacığı açısından güvenlidir.
Bu izler için toplanan varsayılan metrik "süre" olduğundan, bazen "Süre izleri" olarak da adlandırılır.
Bu izlerdeki verileri, Performans kontrol panelinin en altında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz (bu sayfanın ilerleyen bölümlerinde Konsolu kullanma hakkında daha fazla bilgi edinebilirsiniz).
Varsayılan özellikler, özel özellikler ve özel metrikler
Performance Monitoring, özel kod izlemeleri için varsayılan özellikleri (uygulama sürümü, ülke, cihaz vb. gibi yaygın meta veriler) otomatik olarak günlüğe kaydeder. Böylece Firebase konsolunda iz için verileri filtreleyebilirsiniz. Ayrıca özel özellikler de (oyun seviyesi veya kullanıcı özellikleri gibi) ekleyebilir ve izleyebilirsiniz.
İz kapsamında gerçekleşen performansla ilgili etkinlikler için özel metrikleri kaydetmek amacıyla özel bir kod izlemeyi daha ayrıntılı bir şekilde yapılandırabilirsiniz. Örneğin, önbellek isabetleri ve önbellekte olmama sayısı veya kullanıcı arayüzünün belirgin bir süre yanıt vermeme sayısı için özel metrik oluşturabilirsiniz.
Özel özellikler ve özel metrikler, Firebase konsolunda iz için varsayılan özellikler ve varsayılan metriğin yanında gösterilir.
Özel kod izleri ekleyin
Belirli uygulama kodlarını izlemek üzere özel kod izlemeleri eklemek için Performance Monitoring Trace API'yi kullanın.
Aşağıdakileri göz önünde bulundurun:
- Bir uygulamada birden fazla özel kod izlemesi olabilir.
- Aynı anda birden fazla özel kod izlemesi çalışabilir.
- Özel kod izleme adları şu koşulları karşılamalıdır: Başta veya sonda boşluk olmamalıdır, başında alt çizgi (
_) karakteri bulunmamalıdır ve maksimum uzunluk 100 karakterdir. - Özel kod izleri, özel metriklerin ve özel özelliklerin eklenmesini destekler.
Özel bir kod izlemeyi başlatmak ve durdurmak için izlemek istediğiniz kodu aşağıdakine benzer bir kodla sarmalayın:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Özel kod izlerine özel metrikler ekleme
Özel kod izlerine özel metrikler eklemek için Performance Monitoring Trace API'yi kullanın.
Aşağıdakileri göz önünde bulundurun:
- Özel metrik adları şu koşulları karşılamalıdır:
Başta veya sonda boşluk olmamalı, başında alt çizgi (
_) karakteri bulunmamalıdır ve maksimum uzunluk 100 karakterdir. - Her özel kod izleme, en fazla 32 metrik kaydedebilir (varsayılan Süre metriği dahil).
Özel metrik eklemek için etkinlik her gerçekleştiğinde aşağıdakine benzer bir kod satırı ekleyin. Örneğin bu özel metrik, performansla ilgili etkinlikleri (ör. önbellek isabetleri veya yeniden denemeler) 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 özellikler oluşturma
Özel özellikleri kullanmak için uygulamanıza özelliği tanımlayan ve belirli bir özel kod izlemeyle ilişkilendiren bir kod ekleyin. Özel özelliği, iz başlangıcıyla izin durduğu zaman arasında istediğiniz zaman ayarlayabilirsiniz.
Aşağıdakileri göz önünde bulundurun:
Özel özellik adları şu koşullara uymalıdır: başta veya sonda boşluk olmamalıdır, başında alt çizgi (
_) karakteri bulunmamalıdır ve maksimum uzunluk 32 karakterdir.Her özel kod izleme, en fazla 5 özel özellik kaydedebilir.
Bir bireyi Google tarafından şahsen tanımlayan bilgiler içeren özel özellikler kullanmamalısınız.
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 izleme, görüntüleme ve filtreleme
Kontrol panelinizde belirli metrikleri izleme
Temel metriklerinizin trendlerini öğrenmek için bunları Performans kontrol panelinin üst kısmındaki metrikler panonuza ekleyin. Haftadan haftaya değişiklikleri görüntüleyerek veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayarak regresyonları hızla belirleyebilirsiniz.
Metrik panonuza metrik eklemek için Firebase konsolunda Performans kontrol paneline gidin ve Kontrol paneli sekmesini tıklayın. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin. Bir metriği değiştirme veya kaldırma gibi daha fazla seçenek için, doldurulmuş metrik kartındaki dikey üç nokta (⋮) simgesini tıklayın.
Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçiminde 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üleme
İzlerinizi görüntülemek için Firebase konsolunda Performans kontrol paneli'ne gidin, izleme tablosuna ilerleyin ve ilgili alt sekmeyi tıklayın. Tabloda her iz için en önemli metriklerden bazıları gösterilir. Hatta listeyi belirli bir metrik için yüzdelik değişime göre de sıralayabilirsiniz.
İz tablosundaki bir iz adını tıklarsanız, çeşitli ekranları tıklayarak izini inceleyebilir ve istediğiniz metrikleri ayrıntılı olarak inceleyebilirsiniz. Çoğu sayfada, verileri özelliğe göre filtrelemek için Filtre düğmesini (ekranın sol üst kısmında) kullanabilirsiniz. Örneğin:
- Eski bir sürüm veya en son sürümünüzle ilgili verileri görüntülemek için Uygulama sürümü'ne göre filtreleyin
- Eski cihazların uygulamanızı nasıl işleyeceğini öğrenmek için Cihaz'a göre filtreleyin
- Veritabanı konumunuzun belirli bir bölgeyi etkilemediğinden emin olmak için Ülke'ye göre filtreleyin
İzlemlerinize ilişkin verileri görüntüleme hakkında daha fazla bilgi edinin.
Sonraki adımlar
Performans verilerini incelemek için özellikleri kullanma hakkında daha fazla bilgi edinin.
Firebase konsolunda performans sorunlarını izleme hakkında daha fazla bilgi edinin.
Uygulamanızın performansını düşüren kod değişiklikleri için uyarı oluşturun. Örneğin, belirli bir özel kod izlemenin süresi, belirlediğiniz bir eşiği aşarsa ekibiniz için bir e-posta uyarısı yapılandırabilirsiniz.