Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Belirli uygulama kodu için özel izleme ekleyin

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

Özel kod izlemeleri için Performance Monitoring, varsayılan öznitelikleri (uygulama sürümü, ülke, cihaz vb. gibi yaygın meta veriler) otomatik olarak günlüğe kaydeder, böylece izleme için Firebase konsolunda verileri filtreleyebilirsiniz. Ayrıca özel nitelikler (oyun düzeyi veya kullanıcı özellikleri gibi) ekleyebilir ve izleyebilirsiniz.

İ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:

Süratli

Not: Bu Firebase ürünü, macOS, Mac Catalyst, 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, 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 ö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.

Süratli

Not: Bu Firebase ürünü, macOS, Mac Catalyst, 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, 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 ö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

Süratli

Not: Bu Firebase ürünü, macOS, Mac Catalyst, 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, 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

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ızlı bir şekilde belirleyebilir veya kodunuzdaki son değişikliklerin performansı iyileştirdiğini doğrulayabilirsiniz.

Firebase Performance Monitoring panosundaki metrik panosunun bir görüntüsü

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 öğesini 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 => 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 düğmesine tıklayın, örneğin:

özniteliğe göre filtrelenen Firebase Performance Monitoring verilerinin bir görüntüsü
  • 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

  • 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.
tutucu120 l10n-yer