Performance Monitoring, uygulamanızın performansını izlemenize yardımcı olmak için izleme toplar. İzleme, uygulamanızdaki iki zaman noktası arasında yakalanan performans verilerinin bir raporudur.
Uygulamanızdaki belirli bir kodla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel kod izleme ile uygulamanızın belirli bir görevi veya görev grubunu (ör. bir grup görsel yükleme ya da veritabanınızı sorgulama) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.
Özel kod izleme için varsayılan metrik "süre"dir (izlemenin başlangıç ve bitiş noktaları arasındaki süre). Ancak özel metrikler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK'sının sağladığı API'leri kullanarak özel kod izininin başlangıç ve bitişini 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 izlemeler için toplanan varsayılan metrik "süre" olduğundan bu izlemeler bazen "süre izlemeleri" olarak adlandırılır.
Bu izlerden elde edilen verileri, Performans kontrol panelinin alt kısmındaki iz tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz (Konsol'u kullanma hakkında daha fazla bilgiyi bu sayfanın ilerleyen bölümlerinde bulabilirsiniz).
Varsayılan özellikler, özel özellikler ve özel metrikler
Performance Monitoring, özel kod izleri için otomatik olarak günlüğe kaydeder varsayılan özellikleri (uygulama sürümü, ülke, cihaz vb. gibi yaygın meta veriler) Böylece, Firebase konsolunda iz verilerini filtreleyebilirsiniz. Ayrıca özel özellikler (ör. oyun seviyesi veya kullanıcı mülkleri) ekleyip izleyebilirsiniz.
Daha fazla özel kod izlemeyi yapılandırarak özel metrikleri izin verilen kapsam dahilindedir. Örneğin, şunun için özel bir metrik oluşturabilirsiniz: önbellek isabetlerinin ve eksiklikleri veya kullanıcı arayüzünün bir süre yanıt vermeyebilir.
Özel özellikler ve özel metrikler Firebase konsolunda gösterilir varsayılan özellikler ve iz için varsayılan metriğin yanı sıra
Özel kod izleri ekleyin
Belirli uygulama kodlarını izlemek için özel kod izleri eklemek üzere Performance Monitoring Trace API'yi kullanın.
Aşağıdakileri göz önünde bulundurun:
- Bir uygulamanın birden fazla özel kod izlemesi olabilir.
- Aynı anda birden fazla özel kod izleme çalıştırılabilir.
- Özel kod izlemelerinin adları aşağıdaki gereksinimleri karşılamalıdır:
başta veya sonda boşluk ya da başta alt çizgi (
_) karakteri bulunmamalıdır, ve maksimum uzunluk 100 karakterdir. - Özel kod izlemeleri, özel metrikler ve özel özellikler eklemeyi destekler.
Özel bir kod izlemeyi başlatmak ve durdurmak için izlemek istediğiniz kodu şuna benzer bir kod içerir:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Özel kod izlerine özel metrikler ekleme
Özel kod izlerine özel metrikler eklemek için Performance Monitoring Trace API'yi kullanın.
Aşağıdakileri göz önünde bulundurun:
- Özel metrik adları aşağıdaki koşulları karşılamalıdır: Başında veya sonunda boşluk olmamalıdır, başta alt çizgi (
_) karakteri olmamalıdır ve maksimum uzunluk 100 karakterdir. - Her özel kod izleme, varsayılan metrik dahil olmak üzere 32 adede kadar metrik kaydedebilir Süre metriği).
Özel metrik eklemek için etkinlik her gerçekleştiğinde aşağıdakine benzer bir kod satırı ekleyin. Örneğin, bu özel metrik, uygulamanızda gerçekleşen performansla ilgili etkinlikleri (ör. önbellek isabetleri veya yeniden denemeler) sayar.
Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();
// Code you want to trace
customTrace.incrementMetric("metric-name", 1);
// More code
await customTrace.stop();
Özel kod izleri için özel özellikler oluşturma
Özel özellikleri kullanmak için uygulamanıza özelliği tanımlayan ve belirli bir özel kod izlemesiyle ilişkilendiren kod ekleyin. Özel özelliğini iz başladığında ve durduğu zaman arasında herhangi bir zamanda görüntüler.
Aşağıdakileri göz önünde bulundurun:
Özel özelliklerin adları aşağıdaki koşulları karşılamalıdır: Başında veya sonunda boşluk olmamalıdır, başta alt çizgi (
_) karakteri olmamalıdır ve maksimum uzunluk 32 karakterdir.Her özel kod izlemesi en fazla 5 özel özellik kaydedebilir.
Bir kişiyi Google'da kişisel olarak tanımlayan bilgiler içeren özel özellikler kullanmamalısınız.
Trace trace = FirebasePerformance.instance.newTrace("test_trace");
// Update scenario.
trace.putAttribute("experiment", "A");
// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");
// Delete scenario.
trace.removeAttribute("experiment");
// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
Performans verilerini izleme, görüntüleme ve filtreleme
Kontrol panelinizde belirli metrikleri izleme
Temel metriklerinizin nasıl bir eğilim gösterdiğini öğrenmek için Performans kontrol panelinin üst kısmındaki metriklerinize ekleyin. Regresyonları aşağıdaki ölçütlere göre hızla tanımlayabilirsiniz: değişiklikleri görebilirsiniz veya kodunuzdaki son değişikliklerin performansı artırmaya yardımcı olur.
Metrik panonuza metrik eklemek için Performans kontrol paneline gidin ve ardından Kontrol Paneli sekmesini tıklayın. Boş bir metriği tıklayın kartını tıklayın ve panonuza eklenecek mevcut bir metrik seçin. Sektörü tıklayın üç nokta (⋮) gösterilir. bir metriği değiştirebilir veya kaldırabilir.
Metrik panosunda, zaman içinde toplanan metrik verileri grafik biçiminde gösterilir ve sayısal bir yüzde değişimi olarak.
Kontrol panelini kullanma hakkında daha fazla bilgi edinin.
İzleri ve verilerini görüntüleme
İzlerinizi görüntülemek için Firebase konsolundaki Performans kontrol paneline gidin, iz tablosuna ilerleyin ve uygun alt sekmeyi tıklayın. Tabloda her iz için bazı en önemli metrikler gösterilir. Hatta listeyi, belirli bir metrik için yüzdelik değişime göre de sıralayabilirsiniz.
İz tablosundaki bir iz adını tıklarsanız çeşitli ekranlarda izler ve ilgilendiğiniz metrikleri ayrıntılı olarak inceleyebilirsiniz. Çoğu sayfada, verileri özelliğe göre filtrelemek için Filtre düğmesini (ekranın sol üst kısmında) kullanabilirsiniz. Örneğin:
- Geçmiş bir sürüm veya en son sürümünüzle ilgili verileri görüntülemek için Uygulama sürümüne göre filtreleme
- Eski cihazların uygulamanızı nasıl işlediğini öğrenmek için Cihaz'a göre filtreleyin
- Veritabanı konumunuzun bir veri tabanını etkilemediğinden emin olmak için Ülke'ye göre filtreleyin belirli bölge
İzlemelerinize ait verileri görüntüleme hakkında daha fazla bilgi edinin.
Sonraki adımlar
Performans verilerini incelemek için özellikleri kullanma hakkında daha fazla bilgi edinin.
Şu işlemler hakkında daha fazla bilgi edinin: performans sorunlarını izleme Firebase konsolu.
Değerini yitiren kod değişiklikleri için uyarıları ayarlayın. en iyi uygulamaları paylaşacağız. Örneğin, şunun için bir e-posta uyarısı yapılandırabilirsiniz: belirli bir özel kod izlemenin süresi bir sınırı aşıyorsa ne kadar zaman ayırabileceğinizi göstereceğim.