Belirli uygulama kodu için özel izleme ekleyin

Performans İzleme, uygulamanızın performansını izlemenize yardımcı olmak için izleri toplar. İzleme, uygulamanızda zaman içinde iki nokta arasında yakalanan performans verilerinin bir raporudur.

Uygulamanızdaki belirli 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 tamamlamasının ne kadar sürdüğünü ölçebilirsiniz; örneğin, bir dizi görüntüyü yüklemek veya veritabanınızı sorgulamak.

Özel kod izleme için varsayılan metrik, "süre"dir (izin başlangıç ​​ve bitiş noktaları arasındaki süre), ancak özel metrikler de ekleyebilirsiniz.

Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'leri kullanarak özel bir kod izlemesinin başlangıcını ve sonunu tanımlarsınız.Android uygulamaları için, @AddTrace kullanarak belirli yöntemleri de izleyebilirsiniz.Özel kod izleri, oluşturulduktan sonra herhangi bir zamanda başlatılabilir ve iş parçacığı güvenlidir.

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

Bu izlerden gelen verileri, Performans panosunun alt kısmında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz ( konsolun kullanımı hakkında daha sonra bu sayfadan bilgi edinebilirsiniz).

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

Özel kod izleri için, Performans İzleme, varsayılan öznitelikleri (uygulama sürümü, ülke, cihaz vb. ortak meta veriler) otomatik olarak günlüğe kaydeder; böylece, Firebase konsolunda iz 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 olaylar için özel ölçümleri kaydetmek için özel bir kod izlemesini daha da yapılandırabilirsiniz. Örneğin, önbellek isabetlerinin ve ıskalamalarının sayısı veya kullanıcı arayüzünün fark edilir bir süre boyunca yanıt vermeme sayısı için özel bir metrik oluşturabilirsiniz.

Özel öznitelikler ve özel ölçüler, iz için varsayılan öznitelikler ve varsayılan ölçü ile birlikte Firebase konsolunda görüntülenir.

Özel kod izleri ekleyin

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

Aşağıdakilere dikkat et:

  • Bir uygulamanın birden çok özel kod izi olabilir.
  • Aynı anda birden fazla özel kod izleme çalışabilir.
  • Özel kod izleme adları aşağıdaki gereksinimleri karşılamalıdır: Başında veya sonunda boşluk yok, başında alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakterdir.
  • Özel kod izlemeleri, özel metrikler ve özel nitelikler eklemeyi destekler.

Özel kod izlemeyi başlatmak ve durdurmak için, izlemek istediğiniz kodu aşağıdakine benzer kod satırlarıyla sarın (bu örnek test_trace özel izleme adını kullanır):

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();

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()

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

Android uygulamaları ayrıca, özel kod izlemelerini denetlemek için @AddTrace ek açıklamasını da destekler. Bu özelliği kullanarak, izleme, belirtilen yöntemin başlangıcında başlar ve yöntem tarafından çağrılan her şey dahil, yöntem tamamlandığında durur.

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

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);
}

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
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}

Özel kod izlerine özel metrikler ekleyin

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

Aşağıdakilere dikkat et:

  • Özel metrik adları şu gereksinimleri karşılamalıdır: Başta veya sonda boşluk yok, baştaki alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakterdir.
  • Her özel kod izleme, 32 adede kadar metrik kaydedebilir (varsayılan Süre metriği dahil).

Özel bir metrik eklemek için, olay her gerçekleştiğinde aşağıdakine benzer bir kod satırı ekleyin. Örneğin, bu özel metrik, uygulamanızda meydana gelen önbellek isabetleri ve ıskalamaları gibi performansla ilgili olayları sayar ( item_cache_hit ve item_cache_miss örnek olay adlarını ve 1 bir artış kullanarak).

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();

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()

Özel kod izleri için özel nitelikler oluşturun

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

Özel öznitelikleri kullanmak için, özniteliği tanımlayan ve belirli bir özel kod izleme ile ilişkilendiren kodu uygulamanıza ekleyin. Özel özniteliği, izlemenin başladığı ve durduğu zaman arasında istediğiniz zaman ayarlayabilirsiniz.

Aşağıdakilere dikkat et:

  • Özel öznitelik adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başında alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 32 karakterdir.

  • Her özel kod izleme, en fazla 5 özel özniteliği kaydedebilir.

  • Bir kişiyi Google'a kişisel olarak tanımlayan bilgileri içeren özel özellikleri kullanmamalısınız.

    Bu kılavuz hakkında daha fazla bilgi edinin

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();

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
}

Performans verilerini izleyin, görüntüleyin ve filtreleyin

Gösterge tablonuzdaki belirli metrikleri izleyin

Temel metriklerinizin nasıl trend olduğunu öğrenmek için bunları Performans panosunun üst kısmındaki metrik panonuza ekleyin. Haftadan haftaya değişiklikleri görerek gerilemeleri hızlı bir şekilde tanımlayabilir veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayabilirsiniz.

Firebase Performance Monitoring panosundaki metrik panosunun bir görüntüsü

Metrik panonuza bir metrik eklemek için şu adımları izleyin:

  1. Firebase konsolundaki Performans panosuna gidin.
  2. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin.
  3. Daha fazla seçenek için, örneğin bir metriği değiştirmek veya kaldırmak için doldurulmuş bir metrik kartında 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üleyin

İzlerinizi görüntülemek için Firebase konsolundaki Performans panosuna gidin, izler tablosuna gidin, ardından uygun alt sekmeyi tıklayın. Tablo, her iz için bazı önemli metrikleri görüntüler ve hatta belirli bir metrik için yüzde değişimine göre listeyi sıralayabilirsiniz.

Performans İzleme, Firebase konsolunda, metrik değişikliklerini vurgulayan ve performans sorunlarının uygulamalarınız ve kullanıcılarınız üzerindeki etkisini hızla ele almayı ve en aza indirmeyi kolaylaştıran bir sorun giderme sayfası sağlar. Olası performans sorunları hakkında bilgi edindiğinizde, örneğin aşağıdaki senaryolarda sorun giderme sayfasını kullanabilirsiniz:

  • Gösterge tablosunda ilgili metrikleri seçiyorsunuz ve büyük bir delta görüyorsunuz.
  • İzler tablosunda en büyük deltaları en üstte gösterecek şekilde sıralarsınız ve önemli bir yüzde değişikliği görürsünüz.
  • Bir performans sorununu bildiren bir e-posta uyarısı alırsınız.

Sorun giderme sayfasına aşağıdaki yollarla erişebilirsiniz:

  • Metrik kontrol panelinde, Metrik ayrıntılarını görüntüle düğmesini tıklayın.
  • Herhangi bir metrik kartında => Ayrıntıları görüntüle öğesini seçin. Sorun giderme sayfası, seçtiğiniz ölçümle ilgili bilgileri görüntüler.
  • İzler tablosunda, o iz ile ilişkili satırda bir iz adını veya herhangi bir metrik değerini tıklayın.
  • Bir e-posta uyarısında, Şimdi araştır 'ı tıklayın.

İzler tablosunda bir iz adına tıkladığınızda, ilgilendiğiniz metriklerin detayına inebilirsiniz. Verileri özniteliğe göre filtrelemek için Filtre düğmesini tıklayın, örneğin:

özniteliğe göre filtrelenen Firebase Performance Monitoring verilerinin bir görüntüsü
  • 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
  • Daha eski cihazların uygulamanızı nasıl idare ettiğini öğrenmek için Cihaza Göre Filtreleyin
  • Veritabanı konumunuzun belirli bir bölgeyi etkilemediğinden emin olmak için Ülkeye Göre Filtreleyin

İzleriniz için verileri görüntüleme hakkında daha fazla bilgi edinin.

Sonraki adımlar

  • 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.
tutucu120 l10n-yer