Belirli uygulama kodu için özel izleme ekleme


Performance Monitoring, uygulamanızın performansını izlemenize yardımcı olmak için izleme toplar. İzleme, uygulamanızdaki iki zaman noktası arasında yakalanan performans verilerinin bir raporudur.

Uygulamanızdaki belirli bir kodla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel kod izleme ile uygulamanızın belirli bir görevi veya bir dizi görevi (ör. bir dizi görsel yükleme ya da veritabanınızı sorgulama) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.

Özel kod izleme için varsayılan metrik "süre"dir (izlemenin 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 kod izininin başlangıç ve bitişini 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 izlemeler için toplanan varsayılan metrik "süre" olduğundan bu izlemeler bazen "süre izlemeleri" olarak 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

Özel kod izlerinde Performance Monitoring, Firebase konsolunda iz verilerini filtreleyebilmeniz için varsayılan özellikleri (uygulama sürümü, ülke, cihaz gibi yaygın meta veriler) otomatik olarak günlüğe kaydeder. Ayrıca özel özellikler (oyun seviyesi veya kullanıcı özellikleri gibi) ekleyip izleyebilirsiniz.

Özel kod izlemeyi, izlemenin kapsamında gerçekleşen performansla ilgili etkinlikler için özel metrikleri kaydetecek şekilde daha da yapılandırabilirsiniz. Örneğin, önbellek isabetleri ve önbellekte yok durumlarının sayısı veya arayüzün belirgin bir süre yanıt vermediği durumların 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 izlemeleri 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 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, 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 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 özelliklerin adları aşağıdaki koşulları karşılamalıdır: Başında veya sonunda boşluk olmamalıdır, başta alt çizgi (_) karakteri olmamalı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 konsolundaki Performans kontrol paneline gidin, iz 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 metrik için yüzdelik değişime göre de sıralayabilirsiniz.

İzlemeler tablosunda bir izleme adını tıkladığınızda, 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 Filtre düğmesini (ekranın sol üst kısmında) kullanabilirsiniz. Örneğin:

  • Geçmiş 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 filtreleme
  • 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

İzlemelerinize 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ı 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.