Performance Monitoring, uygulamanızın performansını izlemenize yardımcı olmak için izler toplar. İz, uygulamanızda belirli iki zaman noktası arasında yakalanan performans verilerinin raporudur.
Uygulamanızdaki belirli kodlarla ilişkili performans verilerini izlemek için kendi izlerinizi oluşturabilirsiniz. Özel kod izi ile uygulamanızın belirli bir görevi veya görev grubunu (ör. bir grup resmi yükleme ya da veritabanınıza sorgu gönderme) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz.
Özel kod izlemenin varsayılan metriği "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 izinin başlangıcını ve bitişini 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 bazen "Süre izleri" olarak adlandırılırlar.
Bu izlerden elde edilen verileri, Performans kontrol panelinin alt kısmındaki izler tablosunun Özel izler alt sekmesinde görüntüleyebilirsiniz (Konsolu 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 varsayılan özellikleri (uygulama sürümü, ülke, cihaz vb. gibi ortak meta veriler) otomatik olarak günlüğe kaydeder. Böylece, Firebase konsolunda izle ilgili verileri filtreleyebilirsiniz. Ayrıca, özel özellikler (ör. oyun seviyesi veya kullanıcı özellikleri) ekleyip bunları izleyebilirsiniz.
Özel kod izini, iz kapsamı içinde gerçekleşen performansla ilgili etkinliklere ait özel metrikleri kaydedecek şekilde daha da yapılandırabilirsiniz. Örneğin, önbellek isabetleri ve önbellekte yok durumlarının sayısı veya arayüzün belirgin bir süre yanıt vermediği durumların sayısı için özel metrik oluşturabilirsiniz.
Özel özellikler ve özel metrikler, Firebase konsolunda izlemeyle ilgili varsayılan özellikler ve varsayılan metrikle birlikte gösterilir.
Özel kod izleri ekleme
Belirli uygulama kodunu izlemek için özel kod izleri eklemek üzere Performance Monitoring Trace API'yi kullanın.
Aşağıdakileri göz önünde bulundurun:
- Bir uygulamada birden fazla özel kod izi olabilir.
- Aynı anda birden fazla özel kod izi çalıştırılabilir.
- Özel kod izlerinin adları aşağıdaki koşulları karşılamalıdır:
Başta veya sonda boşluk olmamalı, başta alt çizgi (
_) karakteri olmamalı ve maksimum uzunluk 100 karakter olmalıdır. - Özel kod izleri, özel metrikler ve özel özellikler eklemeyi destekler.
Özel kod izlemeyi başlatmak ve durdurmak için izlemek istediğiniz kodu aşağıdaki gibi bir kodla sarmalayın:
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 şartları karşılamalıdır:
Başta veya sonda boşluk olmamalı, başta alt çizgi (
_) karakteri olmamalı ve maksimum uzunluk 100 karakter olmalıdır. - Her özel kod izi, varsayılan Süre metriği dahil olmak üzere en fazla 32 metrik kaydedebilir.
Ö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 (önbellek isabetleri veya yeniden denemeler gibi) 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 iziyle ilişkilendiren kodu ekleyin. Özel özelliği, izleme başlatıldıktan sonra ve izleme durdurulmadan önce istediğiniz zaman ayarlayabilirsiniz.
Aşağıdakileri göz önünde bulundurun:
Özel özellik adları aşağıdaki koşulları karşılamalıdır: Başta veya sonda boşluk olmamalı, başta alt çizgi (
_) karakteri olmamalı ve maksimum uzunluk 32 karakter olmalıdır.Her özel kod izi en fazla 5 özel özellik kaydedebilir.
Google'a bir kişiyi şahsen 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 trend izlediğini öğrenmek için bu metrikleri Performans kontrol panelinin üst kısmındaki metrik panonuza ekleyin. Haftadan haftaya gerçekleşen değişiklikleri izleyerek regresyonları hızlıca belirleyebilir veya kodunuzda yapılan son değişikliklerin performansı artırdığını doğrulayabilirsiniz.
Metrik panonuza metrik eklemek için Firebase konsolunda Performans kontrol paneline gidin ve Kontrol paneli sekmesini tıklayın. Boş bir metrik kartını tıklayın, ardından panonuza eklemek için mevcut bir metriği seçin. Bir metriği değiştirme veya kaldırma gibi daha fazla seçenek için doldurulmuş bir metrik kartında dikey üç nokta simgesini (⋮) tıklayın.
Metrikler panosu, toplanan metrik verilerini zaman içinde 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.
İzlemeleri ve verilerini görüntüleme
İzlerinizi görüntülemek için Firebase konsolunda Performans kontrol paneline gidin, izler tablosuna gidin ve uygun alt sekmeyi tıklayın. Tabloda her izlemeyle ilgili bazı önemli metrikler gösterilir. Listeyi belirli bir metriğin yüzde değişimine göre de sıralayabilirsiniz.
İzleme tablosunda bir izleme adını tıkladığınızda, izlemeyi keşfetmek ve ilgilendiğiniz metrikleri ayrıntılı olarak incelemek için çeşitli ekranları tıklayabilirsiniz. Çoğu sayfada, verileri özelliğe göre filtrelemek için Filtrele düğmesini (ekranın sol üst kısmı) 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 belirli bir bölgeyi etkilemediğinden emin olmak için Ülke'ye göre filtreleme
İzlemelerinizin verilerini 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.
Firebase Console'da performans sorunlarını izleme 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.