Belirli uygulama kodu için özel izleme ekleyin

Performans İzleme, uygulamanızın performansını izlemenize yardımcı olmak için izleri toplar. İ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 kod izleme ile, uygulamanızın belirli bir görevi veya bir dizi görevi tamamlamasının ne kadar sürdüğünü ölçebilirsiniz; örneğin, bir dizi görüntü yüklemek veya veritabanınızı sorgulamak.

Özel kod izleme için varsayılan metrik, "süre"dir (izin başlangıç ​​ve bitiş noktaları arasındaki süre), ancak özel metrikler 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ığı güvenlidir.

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

Bu izlerden gelen verileri, Performans panosunun alt kısmında bulunan izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz ( konsolun kullanımı hakkında daha sonra bu sayfadan bilgi edinebilirsiniz).

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

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

İzleme kapsamında meydana gelen performansla ilgili olaylar için özel ölçümleri kaydetmek için özel bir kod izlemesini daha da yapılandırabilirsiniz. Ö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

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 çok özel kod izi olabilir.
  • Aynı anda birden fazla özel kod izlemesi çalıştırılabilir.
  • Özel kod izleme adları aşağıdaki gereksinimleri karşılamalıdır: Başında veya sonunda boşluk yok, başında alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakterdir.
  • Özel kod izlemeleri, özel metrikler 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 metrikler 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şta veya sonda boşluk yok, başında alt çizgi ( _ ) karakteri yok ve maksimum uzunluk 100 karakterdir.
  • Her özel kod izleme, 32 adede kadar metrik kaydedebilir (varsayılan Süre metriği dahil).

Ö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, uygulamanızda gerçekleşen, önbellek isabetleri veya yeniden denemeler gibi 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, ö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 öznitelik adları şu gereksinimleri karşılamalıdır: başında veya sonunda boşluk yok, başında alt çizgi ( _ ) karakteri yok 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, 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

Gösterge tablonuzdaki belirli metrikleri izleyin

Temel metriklerinizin nasıl trend olduğunu öğrenmek için bunları Performans panosunun üst kısmındaki metrik panonuza 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ü

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

  1. Firebase konsolundaki Performans panosuna gidin.
  2. Boş bir metrik kartı tıklayın, ardından panonuza eklemek için mevcut bir metrik seçin.
  3. Daha fazla seçenek için, örneğin bir metriği değiştirmek veya kaldırmak için doldurulmuş bir metrik 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ş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, ardından uygun alt sekmeyi 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.

Performans İzleme, Firebase konsolunda, metrik değişikliklerini vurgulayan ve performans sorunlarının uygulamalarınız ve kullanıcılarınız üzerindeki etkisini hızla ele almayı ve en aza indirmeyi kolaylaştıran bir sorun giderme sayfası sağlar. Olası performans sorunları hakkında bilgi edindiğinizde, örneğin aşağıdaki senaryolarda sorun giderme sayfasını kullanabilirsiniz:

  • Gösterge tablosunda ilgili metrikleri seçiyorsunuz ve büyük bir delta görüyorsunuz.
  • İzler tablosunda en büyük deltaları en üstte gösterecek şekilde sıralarsınız ve önemli bir yüzde değişikliği görürsünüz.
  • Bir performans sorununu bildiren bir e-posta uyarısı alırsınız.

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

  • Metrik kontrol panelinde, Metrik ayrıntılarını görüntüle düğmesini tıklayın.
  • Herhangi bir metrik kartında => Ayrıntıları görüntüle 'yi seçin. Sorun giderme sayfası, seçtiğiniz metrikle ilgili bilgileri görüntüler.
  • İzler tablosunda, o iz ile ilişkili satırda bir iz adını veya herhangi bir metrik değerini 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 detayına inebilirsiniz. Verileri özniteliğe göre filtrelemek için Filtre düğmesini 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
  • Daha 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