Belirli uygulama kodu için özel izleme ekleme

Performance Monitoring, uygulamanızın performansını izlemenize yardımcı olmak için izleme toplar. İzleme, uygulamanızdaki iki zaman noktası arasında yakalanan performans verilerinin bir raporudur.

Aşağıdakilerle ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz: bir kod bulmanız gerekir. Özel kod izleme ile reklam öğelerinin uygulamanızın belirli bir görevi veya bir dizi görevi tamamlamasının veri kümesi yükleme veya veritabanınıza sorgu gönderme gibi işlemler de yapabilirsiniz.

Özel kod izleme için varsayılan metrik "süre"dir ( iz başlangıç ve bitiş noktalarını gösterir), ancak özel metrikleri de dahil edebilirsiniz.

Kodunuzda, özel bir kod izlemenin başlangıcını ve sonunu tanımlamak için Performance Monitoring SDK'sı tarafından sağlanan API'ler. Özel kod izlemeleri, oluşturulduktan sonra istenildiği zaman başlatılabilir. ileti dizisi açısından güvenli.

Bu izler için toplanan varsayılan metrik "süre" olduğundan, "Süre izleri" olarak da adlandırılır.

Bu izlere ait verileri, izlerin Özel izler alt sekmesinde görüntüleyebilirsiniz (Performans kontrol panelinin alt kısmındaki) konsolu kullanarak geri çekebilirsiniz).

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

Daha fazla özel kod izlemeyi yapılandırarak özel metrikleri izin verilen kapsam dahilindedir. Örneğin, önbellek isabetleri ve önbellekte yok durumlarının sayısı veya arayüzün belirgin bir süre yanıt vermediği durumların sayısı için özel metrik oluşturabilirsiniz.

Özel özellikler ve özel metrikler, Firebase konsolunda izlemenin varsayılan özellikleri ve varsayılan metriğiyle birlikte gösterilir.

Özel kod izlemeleri ekleme

Performance Monitoring kullanın Trace API izlemesi gereken özel kod izlemeleri ekleyin.

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 izlemelerinin adları aşağıdaki koşulları karşılamalıdır: Başında veya sonunda boşluk olmamalıdır, başta alt çizgi (_) karakteri olmamalıdır ve maksimum uzunluk 100 karakterdir.
• Özel kod izlemeleri, özel metrikler ve özel özellikler eklemeyi destekler.

Özel kod izlemeyi başlatmak ve durdurmak için aşağıdakine benzer kod satırlarıyla izler:

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, 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. User Timing API'yi kullanmak, özellikle Performance Monitoring SDK'sını eşzamansız olarak yüklemeyi tercih ediyorsanız faydalıdır. SDK başlatıldıktan sonra SDK, yüklenmeden önce yapılan ö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 nesne algılandı.

User Timing API kullanılırken özel kod izlemelerine özel metrikler ve özellikler eklenemez. Şunu kullanın: Eklemek istiyorsanız Performance Monitoring Trace API öğelerini özel kod izine ekler.

Ö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ı aşağıdaki koşulları karşılamalıdır: Başında veya sonunda boşluk olmamalıdır, başta alt çizgi (_) karakteri olmamalıdır ve maksimum uzunluk 100 karakterdir.
• Her özel kod izlemesi en fazla 32 metrik (varsayılan Süre metriği dahil) kaydedebilir.

Özel metrik eklemek için her seferinde aşağıdakine benzer bir kod satırı ekleyin dikkate almanız gerekir. Örneğin, bu özel metrik, ilgili etkinlikleri gösterir.

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

Performance Monitoring Trace API'yi kullanma kullanabilirsiniz.

Özel özellikleri kullanmak için uygulamanıza özelliği tanımlayan ve belirli bir özel kod izlemesiyle ilişkilendiren kod ekleyin. Özel özelliği, izlemenin başladığı andan sona erdiği ana kadar herhangi bir zamanda ayarlayabilirsiniz.

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

• Özel özelliklerin 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 A-Z, a-z ve _'dir.

• Her özel kod izleme, en fazla 5 özel özellik kaydedebilir.

• Lütfen özel özelliklerin Google'a kimliğinizin tanımlanmasını sağlar.

  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 Performans Gerçek zamanlı veri işlemeyle uyumlu olan izleme SDK sürümü. 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ı üst kısımdaki metrikler panelinize ekleyin. Performans kontrol paneli. Haftadan haftaya gerçekleşen değişiklikleri izleyerek regresyonları hızlıca tanımlayabilir veya kodunuzdaki son değişikliklerin performansı iyileştirip iyileştirmediğini doğrulayabilirsiniz.

Metrik panosuna metrik eklemek için aşağıdaki adımları uygulayın:

1. Şuraya gidin: Firebase konsolundaki Performans kontrol paneli.
2. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin.
3. Sonraki slayta geçin Daha fazla seçenek için doldurulmuş metrik kartında more_vert, örneğin bir metriği değiştirebilir veya kaldırabilirsiniz.

Metrikler 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

İzlemelerinizi görüntülemek için Firebase konsolundaki Performans kontrol paneline gidin, izlemeler tablosuna gidin ve uygun alt sekmeyi tıklayın. Tabloda, her izleme için bazı önemli metrikler gösterilir. Dilerseniz listeyi belirli bir metriğin yüzde değişimine göre de sıralayabilirsiniz.

Performance Monitoring, Firebase konsolunda metrik değişikliklerini vurgulayan bir sorun giderme sayfası sağlar. Bu sayede performans sorunlarının uygulamalarınız ve kullanıcılarınız üzerindeki etkisini hızlı bir şekilde giderebilir ve en aza indirebilirsiniz. Olası performans sorunları hakkında bilgi edindiğinizde sorun giderme sayfasını kullanabilirsiniz. Örneğin, aşağıdaki senaryolarda:

• Kontrol panelinde alakalı metrikleri seçtiğinizde büyük bir fark olduğunu fark edersiniz.
• İzlemeler tablosunda en büyük değişimleri en üstte gösterecek şekilde sıralama yaptığınızda önemli bir yüzde değişikliği 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 simgesini seçin => Ayrıntıları göster. Sorun giderme sayfasında, seçtiğiniz metrik hakkında bilgiler gösterilir.
• İzler tablosunda bir iz adını veya onunla ilişkili satırdaki herhangi bir metrik değerini tıklayın. izler.
• E-posta uyarısında Şimdi incele'yi tıklayın.

İzlemeler 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ı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 Geçerli bağlantı türüne göre filtreleyin
• Veritabanı konumunuzun belirli bir konumu etkilemediğinden emin olmak için Ülke'ye göre filtreleyin bölge

İzlemelerinize ait verileri görüntüleme hakkında daha fazla bilgi edinin.

Sonraki adımlar

• Daha fazla bilgi: özellikleri kullanarak da performans verilerini inceleyebilirsiniz.

• Şu işlemler hakkında daha fazla bilgi edinin: performans sorunlarını izleme Firebase konsolu.

• Uygulamanızın performansını düşüren kod değişiklikleri için uyarılar 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.