Belirli uygulama kodu için özel izleme ekleme

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 sonunu tanımlarsınız. Android uygulamalarında, @AddTrace ek açıklamasını kullanarak belirli yöntemleri de izleyebilirsiniz. Ö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ındaki 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

Ö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şında veya sonunda boşluk olmamalı, başında 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 kod satırlarıyla sarmalayın (bu örnekte test_trace adlı özel izleme adı kullanılmıştır):

// 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

// 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 izleme

Android uygulamaları, özel kod izlerini ölçmek için @AddTrace ek açıklamasını da destekler. Bu özellik kullanıldığında izleme, belirtilen yöntemin başında başlar ve yöntem tamamlandığında (yöntem tarafından çağrılan her şey dahil) durur.

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

// 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

// 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

Ö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 ve eksiklikleri) sayar (item_cache_hit ve item_cache_miss örnek etkinlik adları ve 1 artış değeri kullanılarak).

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

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 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ı aşağıdaki koşulları karşılamalıdır:

  • Baştaki veya sondaki boşluklar ve baştaki alt çizgi (_) karakteri kaldırılıyor mu?
  • Alan yok
  • Maksimum uzunluk 32 karakterdir.
  • Ad için izin verilen karakterler: A-Z, a-z ve _.

• Her özel kod izi en fazla 5 özel özellik kaydedebilir.

• Lütfen özel özelliklerin, bir kişinin kimliğini Google'a tanımlayabilecek herhangi bir bilgi içermediğinden emin olun.

  Bu kural hakkında daha fazla bilgi

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

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 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 kodunuzdaki son değişikliklerin performansı artırdığını doğrulayabilirsiniz.

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

1. Firebase konsolunda Performans kontrol paneline gidin.
2. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metriği seçin.
3. Doldurulmuş bir metrik kartında more_vert simgesini tıklayarak daha fazla seçeneğe (ör. bir metriği değiştirme veya kaldırma) erişebilirsiniz.

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 konsolunda Performans kontrol paneline gidin, izler tablosuna ilerleyin ve ardından 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.

Performance Monitoring, Firebase Console'da metrik değişikliklerini vurgulayan bir sorun giderme sayfası sunar. Bu sayede, performans sorunlarını hızlıca ele alıp uygulamalarınız ve kullanıcılarınız üzerindeki etkisini en aza indirebilirsiniz. Olası performans sorunları hakkında bilgi edinirken sorun giderme sayfasını kullanabilirsiniz. Örneğin, aşağıdaki senaryolarda bu sayfadan yararlanabilirsiniz:

• Kontrol panelinde alakalı metrikleri seçtiğinizde büyük bir fark olduğunu fark ediyorsunuz.
• İzleme tablosunda, en büyük deltaları en üstte gösterecek şekilde sıralama yaptığınızda önemli bir yüzde değişimi görürsünüz.
• Performans sorunuyla ilgili bir e-posta uyarısı alırsınız.

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

• Metrik kontrol panelinde Metrik ayrıntılarını görüntüle düğmesini tıklayın.
• Herhangi bir metrik kartında more_vert => Ayrıntıları göster'i seçin. Sorun giderme sayfasında, seçtiğiniz metrikle ilgili bilgiler gösterilir.
• İzleme tablosunda, bir izleme adını veya bu izlemeyle ilişkili satırdaki herhangi bir metrik değerini tıklayın.
• E-posta uyarısında Şimdi incele'yi tıklayın.

İzleme tablosunda bir izleme adını tıkladığınızda, ilgilendiğiniz metrikleri ayrıntılı olarak inceleyebilirsiniz. Verileri özelliğe göre filtrelemek için Filtreadd düğmesini tıklayın. Ö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 yapın.
• 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 Console'da 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.

• Aynı oturum sırasında toplanan diğer izlerin zaman çizelgesi bağlamında belirli bir izi görebileceğiniz kullanıcı oturumlarının ayrıntılı raporlarını görüntüleyin.