Belirli uygulama kodu için özel izleme ekleyin

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

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

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

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

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

Bu izlerden gelen verileri, Performans panosunun alt kısmında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz ( konsolu kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen kısımlarında bulabilirsiniz).

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

İzleme kapsamında meydana gelen performansla ilgili olaylara yönelik özel ölçümleri kaydetmek için ayrıca özel bir kod izlemesi yapılandırabilirsiniz. Örneğin, önbellek isabetlerinin ve ıskalamalarının 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 iz için varsayılan öznitelikler ve varsayılan metrikle birlikte görüntülenir.

Özel kod izleri ekleyin

Belirli uygulama kodunu izlemek üzere özel kod izlemeleri eklemek için Performance Monitoring Trace API'yi kullanın.

Aşağıdakilere dikkat et:

• Bir uygulamanın birden fazla özel kod izi olabilir.
• Birden fazla özel kod izleme aynı anda çalışabilir.
• Özel kod izleme adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakter.
• Özel kod izlemeleri , özel ölçümler 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:

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();
perf_add_custom_trace.js

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();
index.js

User Timing API'yi kullanarak özel kod izlemeleri ekleyin

Performance Monitoring Trace API'ye ek olarak, bir tarayıcının yerel User Timing API'sini kullanarak özel kod izlemeleri ekleyebilirsiniz. Bu API kullanılarak ölçülen bir izlemenin süresi, Performance Monitoring SDK tarafından otomatik olarak alınır. Performance Monitoring SDK'yı eşzamansız olarak yüklemeyi tercih ediyorsanız, User Timing API'yi kullanmak özellikle yararlıdır. SDK başlatıldıktan sonra SDK, yüklenmeden önce gerçekleşen ölçümleri kaydedecektir.

Bu özelliği kullanmak için, izlemek istediğiniz kodu Kullanıcı Zamanlaması işaretleriyle sarın:

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");
perf_user_timing_marks.js

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");
index.js

Yukarıdaki örnekteki performance , tarayıcının window.performance nesnesine atıfta bulunduğunu unutmayın.

Kullanıcı Zamanlaması API'sini kullanırken, özel ölçümler ve öznitelikler özel kod izlerine eklenemez. Bu özel öğeleri özel bir kod izlemesine eklemek istiyorsanız Performance Monitoring Trace API'yi kullanın.

Özel kod izlerine özel ölçümler ekleyin

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

Aşağıdakilere dikkat et:

• Özel metrik adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakter.
• Her bir özel kod izi, 32 adede kadar ölçüm kaydedebilir (varsayılan Süre ölçümü 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 metrik, uygulamanızda meydana gelen performansla ilgili olayları sayar.

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}
perf_add_custom_metrics.js

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}
index.js

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

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

Özel öznitelikleri kullanmak için, uygulamanıza özelliği tanımlayan ve onu belirli bir özel kod izlemeyle ilişkilendiren kod ekleyin. Özel özniteliği izlemenin başladığı ve durduğu an arasında herhangi bir zamanda ayarlayabilirsiniz.

Aşağıdakilere dikkat et:

• Özel niteliklerin adları aşağıdaki gereksinimleri karşılamalıdır:

  • Başta veya sonda boşluk yok, baştaki alt çizgi ( _ ) karakteri yok
  • Boşluksuz
  • Maksimum uzunluk 32 karakterdir
  • Ad için izin verilen karakterler AZ , az ve _ .

• Her bir özel kod izi, en fazla 5 özel öznitelik kaydedebilir.

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

  Bu kılavuz hakkında daha fazla bilgi edinin

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();
perf_add_custom_attributes.js

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

// Delete scenario
trace.removeAttribute("experiment");

// Read attributes
const traceAttributes = trace.getAttributes();
index.js

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

Gerçek zamanlı performans verilerini görüntülemek için uygulamanızın gerçek zamanlı veri işlemeyle uyumlu bir Performance Monitoring SDK sürümü kullandığından emin olun. Gerçek zamanlı performans verileri hakkında daha fazla bilgi edinin .

Kontrol panelinizde belirli metrikleri izleyin

Temel metriklerinizin nasıl bir trend olduğunu öğ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 belirleyebilir veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayabilirsiniz.

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

1. Firebase konsolundaki Performans kontrol paneline gidin.
2. Boş bir metrik kartı tıklayın, ardından panonuza eklemek için mevcut bir metriği seçin.
3. Örneğin bir metriği değiştirmek veya kaldırmak gibi daha fazla seçenek için doldurulmuş bir metrik kartında more_vert tıklayın.

Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçimde 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 ve uygun alt sekmeyi tıklayın. Tablo, her iz için bazı en iyi metrikleri gösterir ve hatta listeyi belirli bir metrik için değişim yüzdesine göre sıralayabilirsiniz.

Performance Monitoring, Firebase konsolunda metrik değişikliklerini vurgulayan bir sorun giderme sayfası sağlayarak performans sorunlarının uygulamalarınız ve kullanıcılarınız üzerindeki etkisini hızlı bir şekilde ele almayı ve en aza indirmeyi kolaylaştırır. Örneğin, aşağıdaki senaryolarda olası performans sorunları hakkında bilgi edindiğinizde sorun giderme sayfasını kullanabilirsiniz:

• Kontrol panelinde ilgili metrikleri seçersiniz ve büyük bir fark görürsünüz.
• İzler tablosunda, en büyük deltaları üstte gösterecek şekilde sıralarsınız ve önemli bir yüzde değişikliği görürsünüz.
• Size bir performans sorununu bildiren bir e-posta uyarısı alırsınız.

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

• Metrik panosunda, Metrik ayrıntılarını görüntüle düğmesini tıklayın.
• Herhangi bir metrik kartta more_vert => 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, bir iz adına veya o iz ile ilişkili satırdaki herhangi bir metrik değere 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 metrikleri daha sonra inceleyebilirsiniz. Verileri özniteliğe göre filtrelemek için Filtre add düğmesine tıklayın, örneğin:

• Sitenizin belirli bir sayfasına ilişkin verileri görüntülemek için Sayfa URL'sine göre filtreleyin
• 3g bağlantısının uygulamanızı nasıl etkilediğini öğrenmek için Etkili bağlantı türüne 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

• Performans verilerini incelemek için öznitelikleri kullanma hakkında daha fazla bilgi edinin.

• Firebase konsolunda performans sorunlarının nasıl izleneceğ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.