Belirli uygulama kodu için özel izleme ekleyin

Performans İzleme, uygulamanızın performansını izlemenize yardımcı olacak izleri toplar. İzleme, uygulamanızdaki iki zaman noktası arasında yakalanan performans verilerinin bir raporudur.

Uygulamanızdaki belirli kodlarla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel bir kod izlemeyle , uygulamanızın belirli bir görevi veya bir dizi görevi (örneğin, bir dizi görseli yüklemek veya veritabanınızı sorgulamak) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.

Özel bir kod izlemesinin varsayılan ölçümü "süresi"dir (izin başlangıç ​​ve bitiş noktaları arasındaki süre), ancak özel ölçümler de 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.Ö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 bunlara bazen "Süre izleri" de denir.

Bu izlemelerden elde edilen verileri, Performans kontrol panelinin alt kısmında bulunan izlemeler tablosunun Özel izlemeler alt sekmesinde görüntüleyebilirsiniz ( konsolu kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen kısımlarında bulabilirsiniz).

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

Performans İzleme, özel kod izlemeleri için varsayılan nitelikleri (uygulama sürümü, ülke, cihaz vb. gibi ortak meta veriler) otomatik olarak günlüğe kaydeder; böylece Firebase konsolundaki izleme verilerini filtreleyebilirsiniz. Ayrıca özel nitelikler (oyun seviyesi veya kullanıcı özellikleri gibi) ekleyebilir ve izleyebilirsiniz.

İzleme kapsamında meydana gelen performansla ilgili olaylara ilişkin özel ölçümleri kaydetmek için özel bir kod izlemeyi daha da yapılandırabilirsiniz. Örneğin, önbellek isabetleri ve eksikliklerinin 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 izleme için varsayılan nitelikler ve varsayılan metrikle birlikte görüntülenir.

Özel kod izleri ekleme

Belirli uygulama kodunu izlemek üzere özel kod izlemeleri 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.
  • Aynı anda birden fazla özel kod izlemesi çalıştırılabilir.
  • Özel kod izleme adlarının aşağıdaki gereksinimleri karşılaması gerekir: başta veya sonda boşluk olmamalıdır, başta alt çizgi ( _ ) karakteri olmamalıdır ve maksimum uzunluk 100 karakterdir.
  • Özel kod izlemeleri, özel ölçümlerin ve özel niteliklerin eklenmesini destekler.

Ö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, Mac Catalyst ve watchOS hedeflerinde mevcut değildir.
// 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, Mac Catalyst ve watchOS hedeflerinde mevcut değildir.
// 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 ekleme

Ö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ının şu gereksinimleri karşılaması gerekir: başta veya sonda 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 metriği kaydedebilir (varsayılan Süre metriği 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 ölçüm, önbellek isabetleri veya yeniden denemeler gibi uygulamanızda meydana gelen performansla ilgili olayları sayar.

Süratli

Not: Bu Firebase ürünü macOS, Mac Catalyst ve watchOS hedeflerinde mevcut değildir.
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, Mac Catalyst ve watchOS hedeflerinde mevcut değildir.
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 nitelikler eklemek için Performans İzleme İzleme API'sini ( Swift | Obj-C ) kullanın.

Özel öznitelikleri kullanmak için uygulamanıza özniteliği tanımlayan ve onu belirli bir özel kod izlemeyle ilişkilendiren kodu ekleyin. Özel niteliği izlemenin başlamasıyla izlemenin durması arasında istediğiniz zaman ayarlayabilirsiniz.

Aşağıdakilere dikkat et:

  • Özel özelliklere ilişkin adlar aşağıdaki gereksinimleri karşılamalıdır:

    • Başta veya sonda boşluk yok, başta alt çizgi ( _ ) karakteri yok
    • Boşluksuz
    • Maksimum uzunluk 32 karakterdir
    • Ad için izin verilen karakterler AZ , az ve _ .
  • Her özel kod izlemesi en fazla 5 özel niteliği kaydedebilir.

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

    Bu yönerge hakkında daha fazla bilgi edinin

Süratli

Not: Bu Firebase ürünü macOS, Mac Catalyst ve watchOS hedeflerinde mevcut değildir.
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, Mac Catalyst ve watchOS hedeflerinde mevcut değildir.
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 tablonuzda belirli ölçümleri izleyin

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

Firebase Performans İzleme kontrol panelindeki ölçüm panosunun resmi

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

  1. Firebase konsolundaki Performans kontrol paneline gidin.
  2. Boş bir metrik kartını tıklayın, ardından panonuza eklemek üzere mevcut bir metriği seçin.
  3. Daha fazla seçenek için (örneğin, bir ölçümü değiştirmek veya kaldırmak için) doldurulmuş bir ölçüm kartında tıklayın.

Metrik panosu, zaman içinde toplanan metrik verilerini hem grafik biçiminde hem de sayısal yüzde değişim 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 kontrol paneline gidin, izler tablosuna doğru aşağı kaydırın ve ardından uygun alt sekmeyi tıklayın. Tablo, her iz için bazı önemli metrikleri görüntüler ve hatta listeyi belirli bir metrik için yüzde değişime göre sıralayabilirsiniz.

Performans İzleme, 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ını öğrendiğinizde sorun giderme sayfasını kullanabilirsiniz:

  • Kontrol panelinde ilgili metrikleri seçiyorsunuz ve büyük bir fark fark ediyorsunuz.
  • İzler tablosunda en büyük deltaları en üstte görüntüleyecek şekilde sıralarsınız ve önemli bir yüzde değişimi görürsünüz.
  • Bir performans sorunu hakkında sizi bilgilendiren bir e-posta uyarısı alırsınız.

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

  • Metrik kontrol panelinde Metrik ayrıntılarını görüntüle düğmesini tıklayın.
  • Herhangi bir metrik kartta => Ayrıntıları görüntüle . 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ğerine 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 metriklerin ayrıntısına inebilirsiniz. Tıkla Verileri özniteliğe göre filtrelemek için filtre düğmesi, örneğin:

Özelliğe göre filtrelenen Firebase Performance Monitoring verilerinin resmi
  • 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

İzlerinize ilişkin 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 takip edileceğ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 izlemenin 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.