Catch up on everthing we announced at this year's Firebase Summit. Learn more

Belirli uygulama kodu için özel izleme ekleyin

Toplar izlerini İzleme Performans uygulamanızın performansını izlemenize yardımcı olacak. İ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 bir kod iz ile, o örnek resim kümesi yüklerken ya da veritabanını sorgulamak için, belirli bir görevi veya görevler kümesini tamamlamak için uygulamanızı ne kadar sürede ölçebilirsiniz.

Özel bir kod iz için metrik varsayılan onun "süresi" (izinin başlatma ve durdurma noktaları arasındaki süre), ancak sıra, özel metrikler ekleyebilirsiniz.

Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'leri kullanarak özel kod izlemenin başlangıcını ve sonunu tanımlarsınız.oluşturulduktan sonra Özel kod izleri her zaman başlatılabilir ve bunlar parçacığı için güvenlidir.

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

Sen (hakkında daha fazla bilgi Performans gösterge tablosunun alt kısmında izleri tablonun Özel izleri alt sekmesinde, bu izlerin veri görebilirsiniz konsolunu kullanarak bu sayfada sonrası).

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

özel kod izleri için, Performans otomatik İzleme kaydeder varsayılan özelliklerini Eğer Firebase konsolunda iz için verilere filtre böylece (vb ülke, tarayıcı, sayfa URL gibi yaygın meta). Ayrıca ekleyebilir ve monitör özel niteliklerini (örneğin, oyun seviyesi veya kullanıcı özellikleri olarak).

Sen başka rekor için özel bir kod iz yapılandırabilir özel metrik Trace kapsamında meydana performansla ilgili olaylar için. Ö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

İzleme Performans kullanın İz API özel uygulama kodunu izlemek için özel kod izlerini ekleyin.

Aşağıdakilere dikkat et:

  • Bir uygulamanın birden çok özel kod izi olabilir.
  • Aynı anda birden fazla özel kod izlemesi çalıştırılabilir.
  • Özel kod izlerini İsimler aşağıdaki gereksinimleri karşılaması gerekir: hayır başında veya sonlarındaki boşluk, hiçbir lider çizgi ( _ ) karakteri ve maksimum uzunluk 100 karakterdir.
  • Özel kod izleri ekleyerek destekleyen özel metrik ve özel ayrıntıları .

Özel kod izlemeyi başlatmak ve durdurmak için, izlemek istediğiniz kodu aşağıdakine benzer kod satırlarıyla sarın:

Web sürümü 9

import { trace } from "firebase/performance";

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

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

t.stop();

Web sürümü 8

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

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

trace.stop();

Kullanıcı Zamanlaması API'sini kullanarak özel kod izleri ekleyin

İz API İzleme Performans ek olarak, bir tarayıcının yerli kullanarak özel kod izleri ekleyebilir Kullanıcı Zamanlama API . Bu API kullanılarak ölçülen bir izleme süresi, Performance Monitoring SDK tarafından otomatik olarak alınır. Performans İzleme SDK'sını eşzamansız olarak yüklemeyi tercih ediyorsanız, Kullanıcı Zamanlama API'sini kullanmak özellikle yararlıdır. SDK başlatıldığında, 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 sarın:

Web sürümü 9

const performance = window.performance;

performance.mark("measurementStart");

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

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

Web sürümü 8

const performance = window.performance;

performance.mark("measurementStart");

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

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

Not performance tarayıcının belirtir yukarıdaki örnekte window.performance nesne.

Kullanıcı Zamanlaması API'sini kullanırken, özel kod izlerine özel metrikler ve nitelikler eklenemez. Kullanım İz API İzleme Performans Özel bir kod iz için bu özel öğeleri eklemek istiyorsanız.

Özel kod izlerine özel metrikler ekleyin

İzleme Performans kullanın İz API özel kod izleri için özel metrik eklemek.

Aşağıdakilere dikkat et:

  • Özel metrikler için İsimler aşağıdaki gereksinimleri karşılaması gerekir: hayır başında veya sonlarındaki boşluk, hiçbir lider çizgi ( _ ) karakteri ve maksimum uzunluk 100 karakterdir.
  • Her özel kod iz (varsayılan Süre metrik dahil) 32 metrik kaydedebilirsiniz.

Ö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 performansla ilgili olayları sayar.

Web sürümü 9

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

Web sürümü 8

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

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

Kullanım İz API İzleme Performans özel kod izleri için özel ayrıntıları ekleyin.

Ö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 özellikler için İsimler aşağıdaki gereksinimleri karşılaması gerekir: hayır başında veya sonlarındaki boşluk, hiçbir lider çizgi ( _ ) karakteri 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 yönerge hakkında daha fazla bilgi edinin

Web sürümü 9

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

Web sürümü 8

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

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şleme ile uyumlu bir Performance Monitoring SDK sürümü kullandığından emin olun. Daha fazla bilgi .

Kontrol panelinizde belirli metrikleri izleyin

Senin önemli ölçütleri trend öğrenmek için, Performans Gösterge tablosunun en üstünde metrikleriniz kurulu 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ü

Gidin ölçümlerini kuruluna bir metrik eklemek için Performans pano Firebase konsolunda, ardından Tablosu sekmesini tıklayın. Boş bir metrik kartı tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin. Click değiştirmek veya bir metrik kaldırmak gibi fazla seçenek için nüfuslu metrik kartta.

Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçiminde hem de sayısal yüzde değişimi olarak gösterir.

Hakkında daha fazla bilgi panosunu kullanarak .

İzleri ve verilerini görüntüleyin

Gidin izlerini görüntülemek için Performans pano izleri masaya aşağı kaydırın Firebase konsolunda, ardından uygun alt sekmesini 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.

İzler tablosunda bir iz adına tıklarsanız, izi keşfetmek ve ilgilenilen metriklerin detayına inmek için çeşitli ekranlara tıklayabilirsiniz. En sayfalarda, Filtre kullanabilirsiniz örneğin özelliğine göre verileri filtrelemek için (ekranın sol üst) düğmesini:

özniteliğe göre filtrelenen Firebase Performance Monitoring verilerinin bir görüntüsü
  • Sayfa URL'ye göre filtre sitenizin belirli bir sayfaya ilişkin verileri görüntülemek için
  • Etkili bağlantı türüne göre filtre öğrenmeyi bir 3g bağlantısı etkiler uygulamanızı
  • Ülkeye göre Filtre emin veritabanı konumu belirli bir bölgeyi etkileyen olmadığından emin olmak için

Hakkında daha fazla bilgi için izleri verilerine bakmayı .

Sonraki adımlar