Belirli uygulama kodu için özel izleme ekleyin

Performans İzleme, uygulamanızın performansını izlemenize yardımcı olacak izleri toplar. İzleme, uygulamanızdaki iki zaman noktası arasında yakalanan performans verilerinin bir raporudur.

Uygulamanızdaki belirli kodlarla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel bir kod izlemeyle , uygulamanızın belirli bir görevi veya bir dizi görevi (örneğin, bir dizi görseli yüklemek veya veritabanınızı sorgulamak) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.

Özel bir kod izlemesinin varsayılan ölçümü "süresi"dir (izin başlangıç ​​ve bitiş noktaları arasındaki süre), ancak özel ölçümler de ekleyebilirsiniz.

Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'leri kullanarak özel 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ığı açısından güvenlidir.

Bu izler için toplanan varsayılan metrik "süre" olduğundan bunlara bazen "Süre izleri" de denir.

Bu izlemelerden elde edilen verileri, Performans kontrol panelinin alt kısmında bulunan izlemeler 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 nitelikleri (uygulama sürümü, ülke, cihaz vb. gibi ortak meta veriler) otomatik olarak günlüğe kaydeder; böylece Firebase konsolunda izleme için verileri filtreleyebilirsiniz. Ayrıca özel nitelikler (oyun seviyesi veya kullanıcı özellikleri gibi) ekleyebilir ve izleyebilirsiniz.

İzleme kapsamında meydana gelen performansla ilgili olaylara ilişkin özel ölçümleri kaydetmek için özel bir kod izlemeyi daha da yapılandırabilirsiniz. Örneğin, önbellek isabetleri ve eksikliklerinin 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 izleme için varsayılan nitelikler ve varsayılan metrikle birlikte görüntülenir.

Özel kod izleri ekleme

Belirli uygulama kodunu izlemek üzere özel kod izlemeleri eklemek için Performans İzleme İzleme API'sini kullanın.

Aşağıdakilere dikkat et:

  • Bir uygulamanın birden fazla özel kod izi olabilir.
  • Aynı anda birden fazla özel kod izlemesi çalıştırılabilir.
  • Özel kod izleme adlarının aşağıdaki gereksinimleri karşılaması gerekir: başta veya sonda boşluk olmamalıdır, başta alt çizgi ( _ ) karakteri olmamalıdır ve maksimum uzunluk 100 karakterdir.
  • Özel kod izlemeleri, özel ölçümlerin ve özel niteliklerin eklenmesini 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 metrikler ekleme

Özel kod izlemelerine özel ölçümler eklemek için Performans İzleme İzleme API'sini kullanın.

Aşağıdakilere dikkat et:

  • Özel metrik adlarının aşağıdaki gereksinimleri karşılaması gerekir: başta veya sonda boşluk olmamalıdır, başta alt çizgi ( _ ) karakteri olmamalıdır ve maksimum uzunluk 100 karakterdir.
  • Her özel kod izlemesi en fazla 32 metriği kaydedebilir (varsayılan Süre metriği 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 ölçüm, ö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 özniteliği tanımlayan ve onu belirli bir özel kod izlemeyle ilişkilendiren kodu ekleyin. Özel özniteliği izlemenin başlamasıyla izlemenin durması arasında istediğiniz zaman ayarlayabilirsiniz.

Aşağıdakilere dikkat et:

  • Özel öznitelik adlarının şu gereksinimleri karşılaması gerekir: başta veya sonda boşluk olmamalıdır, başta alt çizgi ( _ ) karakteri olmamalıdır ve maksimum uzunluk 32 karakterdir.

  • Her özel kod izlemesi en fazla 5 özel niteliği kaydedebilir.

  • Bir kişiyi Google'da kişisel olarak tanımlayan bilgileri içeren özel özellikleri 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 izleyin, görüntüleyin ve filtreleyin

Gösterge tablonuzda belirli ölçümleri izleyin

Temel metriklerinizin nasıl bir trend izlediğini öğrenmek için bunları Performans kontrol panelinin üst kısmındaki metrik panonuza ekleyin. Haftadan haftaya değişiklikleri görerek regresyonları hızlı bir şekilde tanımlayabilir 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ını tıklayın, ardından panonuza eklemek üzere mevcut bir metriği seçin. Bir ölçümü 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çiminde hem de sayısal yüzde değişim 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 kontrol paneline gidin, izler tablosuna doğru aşağı kaydırın ve ardından uygun alt sekmeyi tıklayın. Tablo, her iz için bazı önemli metrikleri görüntüler ve hatta listeyi belirli bir metrik için yüzde değişime göre sıralayabilirsiniz.

İzler tablosunda bir iz adına tıklarsanız, izi keşfetmek ve ilgilendiğiniz metrikleri ayrıntılı olarak incelemek için çeşitli ekranlara tıklayabilirsiniz. Çoğu sayfada, verileri özniteliğe göre filtrelemek için Filtre düğmesini (ekranın sol üst kısmı) 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

İzlerinize ilişkin 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 takip edileceğ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.