Belirli uygulama kodu için özel izleme ekleyin

Performans İzleme, uygulamanızın performansını izlemenize yardımcı olmak için izler toplar. İzleme, uygulamanızda zamanın iki noktası 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 izleme ile, uygulamanızın belirli bir görevi veya bir dizi görevi tamamlamasının (örneğin, bir dizi resim yüklemek veya veritabanınızı sorgulamak) ne kadar sürdüğünü ölçebilirsiniz.

Özel bir kod izleme için varsayılan ölçü, "süre"dir (izlemenin başlangıç ​​ve bitiş noktaları arasındaki süre), ancak özel ölçüler de ekleyebilirsiniz.

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

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

Bu izlerden gelen verileri, Performans panosunun alt kısmında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz ( konsolu kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen kısımlarında bulabilirsiniz).

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

İzleme kapsamında meydana gelen performansla ilgili olaylara yönelik özel ölçümleri kaydetmek için ayrıca özel bir kod izlemesi yapılandırabilirsiniz. Örneğin, önbellek isabetlerinin ve ıskalamalarının sayısı veya kullanıcı arayüzünün fark edilebilir bir süre boyunca yanıt vermeme sayısı için özel bir ölçüm oluşturabilirsiniz.

Özel nitelikler ve özel metrikler, Firebase konsolunda iz için varsayılan öznitelikler ve varsayılan metrikle birlikte görüntülenir.

Özel kod izleri ekleyin

Belirli uygulama kodunu izlemek üzere özel kod izleri eklemek için Performans İzleme İzleme API'sini ( Swift | Obj-C ) kullanın.

Aşağıdakilere dikkat et:

• Bir uygulamanın birden fazla özel kod izi olabilir.
• Birden fazla özel kod izleme aynı anda çalışabilir.
• Özel kod izleme adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakter.
• Özel kod izlemeleri , özel ölçümler ve özel nitelikler eklemeyi destekler.

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

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

// 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 ölçümler ekleyin

Özel kod izlemelerine özel ölçümler eklemek için Performans İzleme İzleme API'sini ( Swift | Obj-C ) kullanın.

Aşağıdakilere dikkat et:

• Özel metrik adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başta alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakter.
• Her bir özel kod izi, 32 adede kadar ölçüm kaydedebilir (varsayılan Süre ölçümü dahil).

Özel bir metrik eklemek için, olayın 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.

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

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

Özel kod izlemelerine özel öznitelikler eklemek için Performans İzleme İzleme API'sini ( Swift | Obj-C ) kullanın.

Özel öznitelikleri kullanmak için, uygulamanıza özelliği tanımlayan ve onu belirli bir özel kod izlemeyle ilişkilendiren kod ekleyin. Özel özniteliği izlemenin başladığı ve durduğu an arasında herhangi bir zamanda ayarlayabilirsiniz.

Aşağıdakilere dikkat et:

• Özel niteliklerin adları aşağıdaki gereksinimleri karşılamalıdır:

  • Başta veya sonda boşluk yok, baştaki alt çizgi ( _ ) karakteri yok
  • Boşluksuz
  • Maksimum uzunluk 32 karakterdir
  • Ad için izin verilen karakterler AZ , az ve _ .

• Her bir özel kod izi, en fazla 5 özel öznitelik kaydedebilir.

• Lütfen özel özelliklerin, bir kişiyi Google'a kişisel olarak tanımlayan herhangi bir bilgi içermediğinden emin olun.

  Bu kılavuz hakkında daha fazla bilgi edinin

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;

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

Kontrol panelinizde belirli metrikleri izleyin

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

Metrik panonuza bir metrik eklemek için şu adımları izleyin:

1. Firebase konsolundaki Performans kontrol paneline gidin.
2. Boş bir metrik kartı tıklayın, ardından panonuza eklemek için mevcut bir metriği seçin.
3. Örneğin bir metriği değiştirmek veya kaldırmak gibi daha fazla seçenek için doldurulmuş bir metrik kartında more_vert tıklayın.

Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçimde 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üleyin

İzlerinizi görüntülemek için Firebase konsolundaki Performans panosuna gidin, izler tablosuna gidin ve uygun alt sekmeyi tıklayın. Tablo, her iz için bazı en iyi metrikleri gösterir ve hatta listeyi belirli bir metrik için değişim yüzdesine göre sıralayabilirsiniz.

Performance Monitoring, Firebase konsolunda metrik değişikliklerini vurgulayan bir sorun giderme sayfası sağlayarak performans sorunlarının uygulamalarınız ve kullanıcılarınız üzerindeki etkisini hızlı bir şekilde ele almayı ve en aza indirmeyi kolaylaştırır. Örneğin, aşağıdaki senaryolarda olası performans sorunları hakkında bilgi edindiğinizde sorun giderme sayfasını kullanabilirsiniz:

• Kontrol panelinde ilgili metrikleri seçersiniz ve büyük bir fark görürsünüz.
• İzler tablosunda, en büyük deltaları üstte gösterecek şekilde sıralarsınız ve önemli bir yüzde değişikliği görürsünüz.
• Size bir performans sorununu bildiren bir e-posta uyarısı alırsınız.

Sorun giderme sayfasına aşağıdaki şekillerde erişebilirsiniz:

• Metrik panosunda, Metrik ayrıntılarını görüntüle düğmesini tıklayın.
• Herhangi bir metrik kartta more_vert => Ayrıntıları görüntüle öğesini seçin. Sorun giderme sayfası, seçtiğiniz ölçümle ilgili bilgileri görüntüler.
• İzler tablosunda, bir iz adına veya o iz ile ilişkili satırdaki herhangi bir metrik değere tıklayın.
• Bir e-posta uyarısında, Şimdi araştır'ı tıklayın.

İzler tablosunda bir iz adına tıkladığınızda, ilgilendiğiniz metrikleri daha sonra inceleyebilirsiniz. Verileri özniteliğe göre filtrelemek için Filtre add düğmesine tıklayın, örneğin:

• Geçmiş bir sürüm veya en son sürümünüz hakkındaki verileri görüntülemek için Uygulama sürümüne göre filtreleyin
• Eski cihazların uygulamanızı nasıl işlediğini öğrenmek için Cihaza göre filtreleyin
• Veritabanı konumunuzun belirli bir bölgeyi etkilemediğinden emin olmak için Ülkeye göre filtreleyin

İzleriniz için verileri görüntüleme hakkında daha fazla bilgi edinin.

Sonraki adımlar

• Performans verilerini incelemek için öznitelikleri kullanma hakkında daha fazla bilgi edinin.

• Firebase konsolunda performans sorunlarının nasıl izleneceği hakkında daha fazla bilgi edinin.

• Uygulamanızın performansını düşüren kod değişiklikleri için uyarılar ayarlayın . Örneğin, belirli bir özel kod izinin süresi belirlediğiniz eşiği aşarsa ekibiniz için bir e-posta uyarısı yapılandırabilirsiniz.

• Aynı oturum sırasında toplanan diğer izlerin zaman çizelgesi bağlamında belirli bir izi görebileceğiniz kullanıcı oturumlarının ayrıntılı raporlarını görüntüleyin.