Belirli uygulama kodu için özel izleme ekleme

iOS+ Android Web Flutter

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.

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. Android uygulamalarında şunu kullanarak belirli yöntemleri de izleyebilirsiniz: @AddTrace ek açıklaması. Ö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).

Not: İzlerin çok hızlı bir şekilde başlatılması ve durdurulması kaynakların yoğun bir şekilde çalışmasını gerektirebilir. yüksek sıklıkta (örneğin, )

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

Performance Monitoring, özel kod izlemeleri için varsayılan özellikleri (uygulama sürümü, ülke, cihaz gibi yaygın meta veriler) otomatik olarak kaydeder. Böylece, Firebase konsolunda izlemeyle ilgili verileri 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

Özellik, projenizin ve verileri konsolda filtreleyip segmentlere ayırabilirsiniz. Metrik sayısal bir değerdir ve ölçülebilen tüm verileri gösterir.

Özel kod izleri ekleyin

Performance Monitoring kullanın Trace API 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 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 100 karakterdir.
• Özel kod izleri, özel metrik özel özellikleri kullanın.

Özel kod izlemeyi başlatmak ve durdurmak için izlemek istediğiniz kodu aşağıdakine benzer kod satırları (bu örnekte test_trace):

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()
MainActivity.kt

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();
MainActivity.java

(İsteğe bağlı) @AddTrace kullanarak belirli yöntemleri izleyin

Android uygulamaları @AddTrace ek açıklama enstrümantasyon tekniklerinden yararlanırsınız. Bu özellik kullanıldığında iz, başlangıç noktasından belirtilen yöntemin başlangıcında ve yöntem tamamlandığında sona erer. yöntem tarafından çağrılan herhangi bir şey.

Not: @AddTrace ek açıklaması kullanılarak kullanılan özel kod izlemelerinde özel metrik veya özel özellik ekleyemez.

Örneğin, çalışan onCreateTrace adında özel bir kod izleme onCreate() yöntemi çağrıldığında.

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
// the `enabled` argument is optional and defaults to true
@AddTrace(name = "onCreateTrace", enabled = true)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}
MainActivity.kt

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}
MainActivity.java

Özel kod izlerine özel metrikler ekleme

Performance Monitoring kullanın Trace API ö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şında veya sonunda boşluk olmamalıdır, başta alt çizgi (_) karakteri olmamalı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 gerçekleşen önbellek isabetleri ve isabetsizlikleri (item_cache_hit ve item_cache_miss örnek etkinlik adları ve 1 artışı kullanılarak) sayar.

Kotlin+KTX

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()
MainActivity.kt

Java

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();
MainActivity.java

Özel kod izlemeleri için özel özellikler oluşturma

Özel kod izlemelerine özel özellikler eklemek için Performance Monitoring Trace API'yi kullanın.

Ö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 özelliklerin adları aşağıdaki şartları karşılamalıdır:

  • Başta veya sonda boşluk ve sonda alt çizgi (_) karakteri olmamalıdır
  • Boşluk yok
  • Maksimum uzunluk 32 karakterdir
  • Ad için izin verilen karakterler şunlardır: A-Z, a-z ve _.

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

• Lütfen özel özelliklerin, bir kişiyi Google'da kişisel olarak tanımlayan herhangi bir bilgi içermediğinden emin olun.

  Bu kural hakkında daha fazla bilgi

  Kullanıcı verileri toplanıyor: Performance Monitoring kendisi toplamıyor ad, e-posta adresi gibi kimliği tanımlayabilecek bilgiler (PII) telefon numaralarına geçiş yapabilirsiniz. Geliştiriciler, aşağıdakileri kullanarak ek veri toplayabilirler: Özel kod izlerinde özel özellikler oluşturarak Performance Monitoring. Bu tür veriler Performance Monitoring, kimliği tanımlayabilecek bilgiler içermemelidir kişi Google'a aktarmalıdır.

  Şu örneği içermeyen bir günlük mesajı örneği: kimliği tanımlayabilecek bilgiler:

  trace.putAttribute("experiment", "A");

  Kişisel olarak şu ifadeyi içerir: kimliği tanımlayabilecek bilgiler (bu tür kullanmayın) özel özellik olarak kullanabilirsiniz):

  trace.putAttribute("email", user.getEmailAddress());

  Kimliği tanımlayabilecek bilgilerin ifşa edildiği veriler haber verilmeksizin silme.

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}
MainActivity.kt

Java

Trace trace = FirebasePerformance.getInstance().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();
MainActivity.java

Performans verilerini izleme, görüntüleme ve filtreleme

Kontrol panelinizde belirli metrikleri izleme

Temel metriklerinizin nasıl bir trend gösterdiğini öğrenmek için bunları üst kısımdaki metrikler panelinize ekleyin. Performans kontrol paneli. Haftadan haftaya bakarak regresyonları hızlı bir şekilde belirleyebilirsiniz veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayın.

Firebase Performance Monitoring kontrol paneli" /

Metrikler panonuza metrik eklemek için aşağıdaki adımları uygulayın:

1. Firebase konsolunda Performans gösterge tablosuna gidin.
2. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin.
3. Sonraki slayta geçin Daha fazla seçenek için doldurulmuş metrik kartında , örneğin bir metriği değiştirebilir veya kaldırabilirsiniz.

Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçiminde hem de sayısal yüzde değişimi.

Kontrol panelini kullanma hakkında daha fazla bilgi edinin.

İzleri ve verilerini görüntüleme

İzlerinizi görüntülemek için şuraya gidin: Performans kontrol paneli Firebase konsolunda izler tablosuna gidin ve ilgili alt sekmeyi tıklayın. Tabloda her iz için en önemli metriklerden bazıları gösterilir. Hatta listeyi zamana göre sıralayabilirsiniz. yüzdelik değişimdir.

Performance Monitoring, Firebase konsolunda metriğin vurgulandığı bir sorun giderme sayfası sağlar Bu sayede, işletmenizdeki performans sorunlarının hızlıca ele alınmasını ve etkilerini en aza indirebilirsiniz. en iyi uygulamaları paylaşacağız. Olası performans sorunları hakkında bilgi edindiğinizde sorun giderme sayfasını kullanabilirsiniz. Örneğin, aşağıdaki senaryolarda:

• Kontrol panelinde ilgili metrikleri seçtiğinizde büyük bir delta fark edersiniz.
• İz tablosunda en büyük deltaları en üstte görüntülemek üzere sıralarsınız ve bir yüzdelik olarak önemli bir değişimdir.
• Performans sorunuyla ilgili bir e-posta uyarısı alırsınız.

Sorun giderme sayfasına aşağıdaki yöntemleri kullanarak erişebilirsiniz:

• Metrik kontrol panelinde Metrik ayrıntılarını görüntüle düğmesini tıklayın.
• Herhangi bir metrik kartında simgesini seçin => Ayrıntıları göster. Sorun giderme sayfasında metrikle ilgili bilgiler görüntülenir. tıklayın.
• İzler tablosunda bir iz adını veya onunla ilişkili satırdaki herhangi bir metrik değerini tıklayın. izler.
• E-posta uyarısında Şimdi incele'yi tıklayın.

İzlemeler tablosunda bir izleme adını tıkladığınızda, ilgilendiğiniz metrikleri ayrıntılı olarak inceleyebilirsiniz. Önce Verileri filtrelemek için Filtrele düğmesi Örneğin:

Firebase Performance Monitoring verileri özelliğe göre filtreleniyor" /

• 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 konumu etkilemediğinden emin olmak için Ülke'ye göre filtreleyin bölge

İzlemelerinize ait verileri görüntüleme hakkında daha fazla bilgi edinin.

Sonraki adımlar

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

• 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 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.

• Aynı oturum sırasında toplanan diğer izlerle birlikte belirli bir iz için zaman çizelgesi bağlamında ayrıntılı kullanıcı oturumları raporları görüntüleyin.