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 bir kodla ilişkilendirilmiş performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel kod izleme ile uygulamanızın belirli bir görevi veya bir görev kümesini (örneğin, bir dizi görüntü yüklemek ya da veritabanınızı sorgulamak) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.

Ö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'sının sağladığı API'leri kullanarak özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız. Özel kod izlemeleri, oluşturulduktan sonra istenildiği zaman başlatılabilir. Bunlar 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ır.

Bu izlerdeki verileri, Performans kontrol panelinin en altında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz (bu sayfanın ilerleyen bölümlerinde Konsolu kullanma hakkında daha fazla bilgi edinebilirsiniz).

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

İz kapsamında gerçekleşen performansla ilgili etkinlikler için özel metrikleri kaydetmek amacıyla özel bir kod izlemeyi daha ayrıntılı bir şekilde yapılandırabilirsiniz. Örneğin, önbellek isabetleri ve önbellekte olmama sayısı veya kullanıcı arayüzünün belirgin bir süre yanıt vermeme sayısı için özel metrik oluşturabilirsiniz.

Özel özellikler ve özel metrikler, Firebase konsolunda iz için varsayılan özellikler ve varsayılan metriğin yanında gösterilir.

Özel kod izleri ekleyin

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

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 izleme adları şu koşulları karşılamalıdır: Başta veya sonda boşluk olmamalıdır, başında alt çizgi (_) karakteri bulunmamalıdır ve maksimum uzunluk 100 karakterdir.
• Özel kod izleri, özel metriklerin ve özel özelliklerin eklenmesini 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 ekleyin

Performance Monitoring Trace API'ye ek olarak, bir tarayıcının yerel User Timing API'sini kullanarak özel kod izleri ekleyebilirsiniz. Bu API kullanılarak ölçülen bir izin süresi, Performance Monitoring SDK'sı tarafından otomatik olarak alınır. Performance Monitoring SDK'sını eşzamansız olarak yüklemeyi tercih ettiğinizde User Timing API'yi kullanmak özellikle yararlıdır. SDK başlatıldıktan sonra, SDK 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 öğesinin, tarayıcının window.performance nesnesini ifade ettiğini unutmayın.

User Timing API'yi kullanırken özel metrikler ve özellikler özel kod izlerine eklenemez. Bu özel öğeleri özel bir kod izlemeye 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 metrik adları şu koşulları karşılamalıdır: Başta veya sonda boşluk olmamalı, başında alt çizgi (_) karakteri bulunmamalıdır ve maksimum uzunluk 100 karakterdir.
• Her özel kod izleme, en fazla 32 metrik kaydedebilir (varsayılan Süre metriği dahil).

Ö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 meydana gelen 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 izlemeyle ilişkilendiren bir kod ekleyin. Özel özelliği, iz başlangıcıyla izin durduğu zaman arasında istediğiniz zaman ayarlayabilirsiniz.

Aşağıdakileri göz önünde bulundurun:

• Özel özellik 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 bireyi Google'a kişisel olarak tanımlayan 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 Performans İzleme SDK'sı sürümü kullandığından emin olun. Gerçek zamanlı performans verileri hakkında daha fazla bilgi

Kontrol panelinizde belirli metrikleri izleme

Temel metriklerinizin nasıl bir trend gösterdiğini öğrenmek için bunları Performans kontrol panelinin üst kısmındaki metrikler panonuza ekleyin. Haftadan haftaya değişiklikleri görerek veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayarak regresyonları hızla belirleyebilirsiniz.

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 metrik seçin.
3. Bir metriği değiştirme veya kaldırma gibi diğer seçeneklere erişmek için doldurulmuş bir metrik kartında more_vert simgesini 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üleme

İzlerinizi görüntülemek için Firebase konsolunda Performans kontrol paneline gidin, izleme tablosuna ilerleyin ve ilgili alt sekmeyi tıklayın. Tabloda her iz için en önemli metriklerden bazıları gösterilir. Hatta listeyi belirli bir metrik için yüzdelik değişime göre de sıralayabilirsiniz.

Performance Monitoring, Firebase konsolunda metrik değişikliklerini vurgulayan bir sorun giderme sayfası sağlar. Bu sayfa, performans sorunlarının hemen ele alınmasını ve uygulamalarınız ile kullanıcılarınız üzerindeki etkisini en aza indirmenizi kolaylaştırır. 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österecek şekilde sıralarsınız ve ö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ö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 more_vert => Ayrıntıları görüntüle'yi seçin. Sorun giderme sayfasında, seçtiğiniz metrikle ilgili bilgiler görüntülenir.
• İz tablosunda bir iz adını veya söz konusu izle ilişkili satırdaki herhangi bir metrik değerini tıklayın.
• E-posta uyarısında Şimdi incele'yi tıklayın.

İz tablosundaki bir iz 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ına ait 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 Ülke'ye göre filtreleyin

İzlemlerinizle ilgili 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 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ı 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.