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 verilerini filtre böylece (uygulama sürümü, ülke, cihaz vb gibi ortak 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

(İz API İzleme Performans kullanın Swift | Obj-C ) ö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:

Süratli

Not: Bu Firebase ürün MacOS kullanılamaz, Mac Catalyst, watchos hedefler.
// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Amaç-C

Not: Bu Firebase ürün MacOS kullanılamaz, Mac Catalyst, watchos hedefler.
// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Özel kod izlerine özel metrikler ekleyin

(Performans İzleme İz API kullanın Swift | Obj-C ö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, önbellek isabetleri veya yeniden denemeler gibi uygulamanızda meydana gelen performansla ilgili olayları sayar.

Süratli

Not: Bu Firebase ürün MacOS kullanılamaz, Mac Catalyst, watchos hedefler.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Amaç-C

Not: Bu Firebase ürün MacOS kullanılamaz, Mac Catalyst, watchos hedefler.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

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

(İz API İzleme Performans kullanın Swift | Obj-C özel özel kod izleri için niteliklerini eklemek için).

Ö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

Süratli

Not: Bu Firebase ürün MacOS kullanılamaz, Mac Catalyst, watchos hedefler.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Amaç-C

Not: Bu Firebase ürün MacOS kullanılamaz, Mac Catalyst, watchos hedefler.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Performans verilerini izleyin, görüntüleyin ve filtreleyin

Gösterge tablonuzdaki 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ü
  • Geçmiş serbest bırakılması veya en son sürümü hakkında görüş verilerinize uygulama sürümü tarafından Filtre
  • Cihaza Göre Filtre eski cihazlar uygulamanızı nasıl kullanıldığını öğrenmek üzere
  • Ü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

  • Ait ayrıntılı raporları görüntüleme kullanıcı oturumları aynı seansta toplanan diğer izlerin bir zaman çizelgesi çerçevesinde belirli iz görebileceğiniz.