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 kodlarla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel kod izi ile uygulamanızın belirli bir görevi veya bir dizi görevi (ör. bir dizi resim yükleme veya veritabanınızı sorgulama) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.
Özel kod izlemenin varsayılan metriği "süre"dir (izlemenin başlangıç ve bitiş noktaları arasındaki süre). Ancak özel metrikler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK'sı tarafından sağlanan API'leri kullanarak özel kod izlemenin başlangıcını ve bitişini tanımlarsınız.
Özel kod izleri, oluşturulduktan sonra herhangi bir zamanda 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ırlar.
Bu izlemelerden elde edilen verileri, Performans kontrol panelinin alt kısmında bulunan izleme tablosunun Özel izlemeler alt sekmesinde görüntüleyebilirsiniz (Konsolu kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen kısımlarında bulabilirsiniz).
Varsayılan özellikler, özel özellikler ve özel metrikler
Performans İzleme, özel kod izlemeleri için varsayılan özellikleri (uygulama sürümü, ülke, cihaz vb. ortak meta veriler) otomatik olarak günlüğe kaydeder. Böylece Firebase konsolunda izleme verilerini filtreleyebilirsiniz. Ayrıca özel özellikler (ör. oyun seviyesi veya kullanıcı özellikleri) ekleyip bunları izleyebilirsiniz.
Özel kod izlemeyi, izlemenin kapsamında gerçekleşen performansla ilgili etkinlikler için özel metrikleri kaydedecek şekilde daha ayrıntılı olarak yapılandırabilirsiniz. Örneğin, önbellek isabeti ve ıskalamalarının sayısı veya kullanıcı arayüzünün fark edilir bir süre boyunca yanıt vermediği durumların sayısı için özel bir metrik oluşturabilirsiniz.
Özel özellikler ve özel metrikler, iz için varsayılan özellikler ve varsayılan metrikle birlikte Firebase konsolunda gösterilir.
Özel kod izleri ekleme
Belirli uygulama kodlarını izlemek için özel kod izleri eklemek üzere Performance Monitoring Trace API'yi kullanın.
Aşağıdakileri göz önünde bulundurun:
- Bir uygulamada birden fazla özel kod izi olabilir.
- Aynı anda birden fazla özel kod izi çalıştırılabilir.
- Özel kod izlemelerinin adları şu koşulları karşılamalıdır:
Başta veya sonda boşluk olmamalı, başta alt çizgi (
_) karakteri olmamalı ve maksimum uzunluk 100 karakter olmalıdır. - Özel kod izlemeleri, özel metrikler ve özel özellikler eklemeyi destekler.
Özel 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 metriklerin adları şu koşulları karşılamalıdır: Başta veya sonda boşluk olmamalı, başta alt çizgi (
_) karakteri olmamalı ve maksimum uzunluk 100 karakter olmalıdır. - Her özel kod izleme, varsayılan Süre metriği dahil olmak üzere en fazla 32 metrik kaydedebilir.
Ö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, uygulamanızda gerçekleşen 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 iziyle ilişkilendiren kod ekleyin. Özel özelliği, izlemenin başladığı ve durduğu zamanlar arasında istediğiniz zaman ayarlayabilirsiniz.
Aşağıdakileri göz önünde bulundurun:
Özel özelliklerin adları şu 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.Her özel kod izi en fazla 5 özel özellik kaydedebilir.
Google'a bir kişinin kimliğini tanımlayabilecek 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 nasıl bir trend izlediğini öğrenmek için bunları Performans kontrol panelinin üst kısmındaki metrikler panonuza ekleyin. Haftalık değişiklikleri görerek gerilemeleri hızlıca tespit edebilir veya kodunuzda yapılan son değişikliklerin performansı artırdığını doğrulayabilirsiniz.
Metrikler panonuza metrik eklemek için Firebase konsolunda Performance kontrol paneline gidip Kontrol paneli sekmesini tıklayın. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metriği seçin. Bir metriği değiştirme veya kaldırma gibi daha fazla seçenek için doldurulmuş bir metrik kartındaki dikey üç noktayı (⋮) tıklayın.
Metrik panosu, toplanan metrik verilerini zaman içinde 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 konsolundaki Performans kontrol paneline gidin, izler tablosuna ilerleyin ve uygun alt sekmeyi tıklayın. Tabloda her iz için en önemli metriklerden bazıları gösterilir. Hatta listeyi belirli bir metriğin yüzde değişimine göre sıralayabilirsiniz.
İzleme tablosunda bir izleme adını tıklarsanız izlemeyi keşfetmek ve ilgilendiğiniz metrikleri ayrıntılı olarak incelemek için çeşitli ekranları tıklayabilirsiniz. Çoğu sayfada, verileri özelliğe göre filtrelemek için Filtrele düğmesini (ekranın sol üst kısmında) kullanabilirsiniz. Örneğin:
- Geçmiş bir sürüme veya en son sürümünüze ait 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 Cihaz'a göre filtreleyin.
- Veritabanı konumunuzun belirli bir bölgeyi etkilemediğinden emin olmak için Ülke'ye göre filtreleyin.
İzlerinize ait 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ılar ayarlayın. Örneğin, belirli bir özel kod izinin süresi belirlediğiniz eşiği aşarsa ekibiniz için bir e-posta uyarısı yapılandırabilirsiniz.