Belirli uygulama kodu için özel izleme ekleme

Performance Monitoring, uygulamanızın performansını izlemenize yardımcı olmak için izleri toplar. CEVAP iz, zaman içinde iki nokta arasında toplanan performans verilerinin en iyi şekilde yararlanabilirsiniz.

Aşağıdakilerle ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz: bir kod bulmanız gerekir. Özel kod izleme ile reklam öğelerinin uygulamanızın belirli bir görevi veya bir dizi görevi tamamlamasının veri kümesi yükleme veya veritabanınıza sorgu gönderme gibi işlemler de yapabilirsiniz.

Özel kod izleme için varsayılan metrik "süre"dir ( iz başlangıç ve bitiş noktalarını gösterir), ancak özel metrikleri de dahil edebilirsiniz.

Kodunuzda, özel bir kod izlemenin başlangıcını ve sonunu tanımlamak için Performance Monitoring SDK'sı tarafından sağlanan API'ler.

Özel kod izlemeleri, oluşturulduktan sonra istenildiği zaman başlatılabilir. ileti dizisi açısından güvenli.

Bu izler için toplanan varsayılan metrik "süre" olduğundan, "Süre izleri" olarak da adlandırılır.

Bu izlere ait verileri, izlerin Özel izler alt sekmesinde görüntüleyebilirsiniz (Performans kontrol panelinin alt kısmındaki) konsolu kullanarak geri çekebilirsiniz).

Varsayılan özellikler, özel özellikler ve özel metrikler

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

Daha fazla özel kod izlemeyi yapılandırarak özel metrikleri izin verilen kapsam dahilindedir. Örneğin, şunun için özel bir metrik oluşturabilirsiniz: önbellek isabetlerinin ve eksiklikleri veya kullanıcı arayüzünün bir süre yanıt vermeyebilir.

Özel özellikler ve özel metrikler Firebase konsolunda gösterilir varsayılan özellikler ve iz için varsayılan metriğin yanı sıra

Özel kod izleri ekleyin

Performance Monitoring Trace API'yi kullanma izlemesi gereken özel kod izlemeleri ekleyin.

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 izlemelerinin adları aşağıdaki gereksinimleri karşılamalıdır: başta veya sonda boşluk ya da başta alt çizgi (_) karakteri bulunmamalıdır, ve maksimum uzunluk 100 karakterdir.
  • Özel kod izleri, özel metrik özel özellikleri kullanın.

Özel kod izlemeyi başlatmak ve durdurmak için izlemek istediğiniz kodu şuna benzer bir kod içerir:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

Özel kod izlerine özel metrikler ekleme

Performance Monitoring Trace API'yi kullanma özel kod izlerine özel metrikler eklemek için kullanın.

Aşağıdakileri göz önünde bulundurun:

  • Özel metrik adları aşağıdaki koşulları karşılamalıdır: başta veya sonda boşluk ya da başta alt çizgi (_) karakteri bulunmamalıdır, ve maksimum uzunluk 100 karakterdir.
  • Her özel kod izleme, 32 adede kadar metrik kaydedebilir (varsayılan metrikler dahil) Süre metriği).

Özel metrik eklemek için her seferinde aşağıdakine benzer bir kod satırı ekleyin dikkate almanız gerekir. Örneğin, bu özel metrik, uygulamanızda meydana gelen performansla ilgili etkinlikler (ör. önbellek isabetleri veya yeniden deneme sayısı.

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 özel bir kod izlemeyle ilişkilendirir. Özel özelliğini iz başladığında ve durduğu zaman arasında herhangi bir zamanda görüntüler.

Aşağıdakileri göz önünde bulundurun:

  • Özel özellik adları aşağıdaki şartları karşılamalıdır: başta veya sonda boşluk ya da başta alt çizgi (_) karakteri bulunmamalıdır, ve maksimum uzunluk 32 karakterdir.

  • Her özel kod izleme, en fazla 5 özel özellik kaydedebilir.

  • Kişisel bilgilerinizi içeren özel bir bireyi Google'a tanımlar.

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ı şu adresteki metrik panonuza ekleyin: Performans kontrol panelinin üst kısmında bulunur. Regresyonları aşağıdaki ölçütlere göre hızla tanımlayabilirsiniz: değişiklikleri görebilirsiniz veya kodunuzdaki son değişikliklerin performansı artırmaya yardımcı olur.

Metrik panonuza metrik eklemek için Performans kontrol paneline gidin ve ardından Kontrol Paneli sekmesini tıklayın. Boş bir metriği tıklayın kartını tıklayın ve panonuza eklenecek mevcut bir metrik seçin. Sektörü tıklayın üç nokta () gösterilir. bir metriği değiştirebilir veya kaldırabilir.

Metrik panosunda, zaman içinde toplanan metrik verileri grafik biçiminde gösterilir ve sayısal bir yüzde değişimi olarak.

Kontrol panelini kullanma hakkında daha fazla bilgi edinin.

İzleri ve verilerini görüntüleme

İzlerinizi görüntülemek için Performans kontrol paneline gidin Firebase konsolunda izleme tablosuna gidin ve ardından kullanabilirsiniz. Tabloda her iz için bazı en önemli metrikler 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 ekranlarda izler ve ilgilendiğiniz metrikleri ayrıntılı olarak inceleyebilirsiniz. Çoğu sayfada, ekranın sol üst köşesinde bulunan Filtre düğmesini Verileri özelliğe göre filtreleyin. Ö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 lansman yapmak
  • Eski cihazların uygulamanızı nasıl işleyeceğini öğrenmek için Cihaz'a göre filtreleyin
  • Veritabanı konumunuzun bir veri tabanını etkilemediğinden emin olmak için Ülke'ye göre filtreleyin belirli bölge

İzlemlerinize ilişkin verileri görüntüleme hakkında daha fazla bilgi edinin.

Sonraki adımlar

  • Daha fazla bilgi: özellikleri kullanarak da performans verilerini inceleyebilirsiniz.

  • Şu işlemler hakkında daha fazla bilgi edinin: performans sorunlarını izleme Firebase konsolu.

  • Değerini yitiren kod değişiklikleri için uyarıları ayarlayın. en iyi uygulamaları paylaşacağız. Örneğin, şunun için bir e-posta uyarısı yapılandırabilirsiniz: belirli bir özel kod izlemenin süresi bir sınırı aşıyorsa ne kadar zaman ayırabileceğinizi göstereceğim.