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. Ö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şta veya sonda boşluk olmamalı, başta 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:

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 izleri ekleme

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

Bu özelliği kullanmak için izlemek istediğiniz kodu Kullanıcı Zamanlaması işaretleriyle sarmalayı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 örnekte performance ifadesinin, tarayıcının window.performance nesnesini ifade ettiğini unutmayın.

Kullanıcı Zamanlamaları API'si kullanılırken özel metrikler ve özellikler, özel kod izlerine eklenemez. Bu özel öğeleri özel bir kod izine eklemek istiyorsanız Performance Monitoring Trace API'yi kullanın.

Ö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 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 özellikler oluşturma

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

Ö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

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 izleme, görüntüleme ve filtreleme

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ı sürümü kullandığından emin olun. Gerçek zamanlı performans verileri hakkında daha fazla bilgi edinin.

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:

• Sitenizin belirli bir sayfasının verilerini görüntülemek için Sayfa URL'si'ne göre filtreleme yapın.
• 3G bağlantısının uygulamanızı nasıl etkilediğini öğrenmek için Etkin bağlantı türü'ne 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.