Bu sayfa, Cloud Translation API ile çevrilmiştir.

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, Performance Monitoring SDK'sı tarafından sağlanan API'leri kullanarak özel kod izinin başlangıç ve bitişini tanımlarsınız. Özel kod izlemeleri, 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, "Süre izleri" olarak da adlandırılır.

Bu izlerden elde edilen verileri, Performans kontrol panelinin alt kısmındaki iz tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz (Konsol'u kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen bölümlerinde bulabilirsiniz).

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

Özel kod izlemeleri için Performance Monitoring otomatik olarak günlüğe kaydeder varsayılan özellikler (ülke, tarayıcı, sayfa URL'si gibi yaygın meta veriler) böylece Firebase konsolunda iz verilerini filtreleyebilirsiniz. Siz Ayrıca, özel özellikler ekleyip izleyebilirsiniz (ör. oyun seviyesi veya kullanıcı özellikleri).

Özel kod izlemeyi, izlemenin kapsamında gerçekleşen performansla ilgili etkinlikler için özel metrikler kaydetecek şekilde daha da yapılandırabilirsiniz. Ö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

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

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

Bir uygulamanın birden fazla özel kod izlemesi olabilir.
Aynı anda birden fazla özel kod izleme çalıştırılabilir.
Ö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 izleri, özel metrik özel özellikleri kullanın.

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

Web

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

Web

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 ekleme

Performance Monitoring Trace API'ye ek olarak, aynı zamanda bir tarayıcının yerel User Timing API. Bu API kullanılarak ölçülen bir izlemenin süresi, Performance Monitoring SDK tarafından otomatik olarak alınır. Kullanıcı Zamanlama API'sini kullanmak özellikle avantaj sağlar: kullanarak Performance Monitoring SDK'sını eşzamansız olarak yükleyebilirsiniz. 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:

Web

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

Web

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 değerinin, tarayıcının window.performance nesnesini ifade ettiğini unutmayın.

User Timing API'yi kullanırken izin veriliyor. Bu özel öğeleri özel bir kod izlemeye eklemek istiyorsanız Performance Monitoring Trace API'yi kullanın.

Özel kod izlerine özel metrikler ekleme

Performance Monitoring kullanın Trace API özel kod izlerine özel metrikler eklemek için 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 izleme, varsayılan metrik dahil olmak üzere 32 adede kadar metrik kaydedebilir Süre metriği).

Ö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, ilgili etkinlikleri gösterir.

Web

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

Web

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 özel bir kod izlemeyle ilişkilendirir. Ö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şında veya sonunda boşluk, başında 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 Google'a kimliğinizin tanımlanmasını sağlar.
Bu kural hakkında daha fazla bilgi
Kullanıcı verilerini toplama: Performance Monitoring, ad, e-posta adresi veya telefon numarası gibi kimliği tanımlayabilecek bilgiler (PII) toplamaz. Geliştiriciler, aşağıdakileri kullanarak ek veri toplayabilirler: Özel kod izlerinde özel özellikler oluşturarak Performance Monitoring. Bu tür veriler Performance Monitoring, kimliği tanımlayabilecek bilgiler içermemelidir kişi Google'a aktarmalıdır.

Kimliği tanımlayabilecek bilgiler içermeyen bir günlük mesajı örneği aşağıda verilmiştir:
trace.putAttribute("experiment", "A");
Kişisel olarak şu ifadeyi içerir: kimliği tanımlayabilecek bilgiler (bu tür kullanmayın) özel özellik olarak kullanabilirsiniz):
trace.putAttribute("email", user.getEmailAddress());
Kimliği tanımlayabilecek bilgilerin ifşa edildiği veriler haber verilmeksizin silme.

Web

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

Web

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 edinin.

Kontrol panelinizde belirli metrikleri izleme

Önemli metriklerinizin nasıl bir eğilim gösterdiğini öğrenmek için Performans kontrol panelinin üst kısmındaki metrik panosuna ekleyin. Haftadan haftaya bakarak regresyonları hızlı bir şekilde belirleyebilirsiniz veya kodunuzda yapılan son değişikliklerin performansı artırdığını doğrulayın.

Firebase Performance Monitoring kontrol paneli" />

Metrikler panonuza metrik eklemek için aşağıdaki adımları uygulayın:

Şuraya gidin: Firebase konsolundaki Performans kontrol paneli.
Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin.
Daha fazla seçenek için doldurulmuş bir metrik kartında simgesini tıklayın. Örneğin, bir metriği değiştirmek veya kaldırmak için bu seçeneği kullanabilirsiniz.

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

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. Potansiyel sorunlar hakkında bilgi edinmek için performans sorunları söz konusu olabilir.

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 sizi bilgilendiren 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 simgesini seçin => Ayrıntıları göster. Sorun giderme sayfasında metrikle ilgili bilgiler görüntülenir. tıklayın.
İzler tablosunda, bir izleme adını veya söz konusu izlemeyle ilişkili satırdaki herhangi bir metrik değerini tıklayın.
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 Filtre düğmesini tıklayın. Örneğin:

Firebase Performance Monitoring verileri özelliğe göre filtreleniyor" />

Sitenizdeki belirli bir sayfanın verilerini görüntülemek için Sayfa URL'si'ne göre filtreleyin.
3g bağlantısının hesabınızı nasıl etkileyeceğini öğrenmek için Etkili bağlantı türü'ne göre filtreleyin uygulama
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.
Firebase konsolunda performans sorunlarını izleme hakkında daha fazla bilgi edinin.
Değerini yitiren kod değişiklikleri için uyarıları ayarlayın. en iyi uygulamaları paylaşacağız. Örneğin, şunun için bir e-posta uyarısı yapılandırabilirsiniz: belirli bir özel kod izlemenin süresi bir sınırı aşıyorsa ne kadar zaman ayırabileceğinizi göstereceğim.