Firebase Performance Monitoring, ağ isteği performansınızdaki trendleri anlamanıza yardımcı olmak için benzer ağ isteklerine ait verileri otomatik olarak birleştirir.
Ancak bazen uygulamanızın kullanım alanlarını daha iyi desteklemek için Firebase'in belirli ağ isteği verilerini nasıl topladığını özelleştirmeniz gerekir. Ağ istekleri için veri toplamayı özelleştirmenize olanak tanıyan iki yöntem sunuyoruz: Verileri özel URL kalıpları altında toplama ve başarı oranının hesaplanma şeklini özelleştirme.
Özel URL kalıpları altında verileri birleştirme
Firebase, her istek için ağ isteğinin URL'sinin bir URL kalıbıyla eşleşip eşleşmediğini kontrol eder. İstek URL'si bir URL kalıbıyla eşleşirse Firebase, isteğin verilerini URL kalıbı altında otomatik olarak toplar.
Firebase'in türetilmiş otomatik URL kalıbı eşleme özelliğiyle yakalayamadığı belirli URL kalıplarını izlemek için özel URL kalıpları oluşturabilirsiniz. Örneğin, belirli bir URL ile ilgili sorunları gidermek veya belirli bir URL grubunu zaman içinde izlemek için özel bir URL kalıbı kullanabilirsiniz.
Firebase, tüm URL kalıplarını (özel URL kalıpları dahil) ve bunların birleştirilmiş verilerini, Firebase konsolunun Performans kontrol panelinin alt kısmında bulunan izler tablosunun Ağ istekleri alt sekmesinde gösterir.
Özel URL kalıbı eşleştirme nasıl çalışır?
Firebase, otomatik URL kalıbı eşleştirmeye geri dönmeden önce istek URL'lerini yapılandırılmış özel URL kalıplarıyla eşleştirmeye çalışır. Firebase, özel bir URL kalıbıyla eşleşen isteklerin verilerini özel URL kalıbı altında toplar.
Bir isteğin URL'si birden fazla özel URL kalıbıyla eşleşirse Firebase, isteği yalnızca en spesifik özel URL kalıbıyla eşler. Bu eşleme, şu spesifiklik sırasına göre yapılır: düz metin > * > ** yolda soldan sağa doğru. Örneğin, example.com/books/dog isteği iki özel URL kalıbıyla eşleşir:
example.com/books/*example.com/*/dog
Ancak example.com/books/* kalıbı, en spesifik eşleşen URL kalıbıdır. Bunun nedeni, example.com/books/* kalıbındaki en soldaki segmentin (books), example.com/*/dog kalıbındaki en soldaki segmentten (*) daha öncelikli olmasıdır.
Yeni bir özel URL kalıbı oluştururken aşağıdakileri göz önünde bulundurun:
Önceki isteklerden elde edilen eşleşmeler ve birleştirilmiş veriler, yeni bir özel URL kalıbı oluşturulmasından etkilenmez. Firebase, istek verilerini geriye dönük olarak yeniden toplamaz.
Yeni bir özel URL kalıbı oluşturulduğunda yalnızca gelecekteki istekler etkilenir. Performance Monitoring hizmetinin yeni bir özel URL kalıbı altında veri toplayıp birleştirmesi 12 saati bulabilir.
Özel URL kalıbı oluşturma
Firebase konsolunun Performans kontrol panelinin alt kısmında bulunan izler tablosundaki Ağ istekleri alt sekmesinden özel bir URL kalıbı oluşturabilirsiniz.
Yeni bir özel URL kalıbı oluşturmak için proje üyesinin Sahip veya Düzenleyici olması gerekir. Ancak tüm proje üyeleri özel URL kalıplarını ve bunların birleştirilmiş verilerini görüntüleyebilir.
Uygulama başına toplam 400 özel URL kalıbı ve bu uygulama için alan başına en fazla 100 özel URL kalıbı oluşturabilirsiniz.
Özel bir URL kalıbı oluşturmak için ana makine adıyla başlayın ve ardından yol segmentlerini ekleyin. Ana makine adı geçerli bir alan adı içermelidir ve isteğe bağlı olarak alt alan adını içerebilir. URL'lerle eşleşebilecek bir kalıp oluşturmak için aşağıdaki yol segmenti söz dizimini kullanın.
- Düz metin: Tam bir dizeyle eşleşir.
*: İlk alt alan adı segmentiyle veya tek bir yol segmentindeki herhangi bir dizeyle eşleşir.**: Rastgele bir yol son ekiyle eşleşir.
Aşağıdaki tabloda, bazı olası özel URL kalıbı eşleşmeleri açıklanmaktadır.
| Eşleştirmek için... | Şuna benzer bir özel URL kalıbı oluşturun: | Bu URL kalıbıyla eşleşen örnekler |
|---|---|---|
| Tam bir URL | example.com/foo/baz |
example.com/foo/baz
|
Herhangi bir tek yol segmenti (*) |
example.com/*/baz |
example.com/foo/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
Not: Bu kalıp |
|
Rastgele bir yol son eki (**) |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
İlk alt alan adı segmenti (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
Özel URL kalıplarını ve verilerini görüntüleme
Firebase, tüm URL kalıplarını (özel URL kalıpları dahil) ve bunların birleştirilmiş verilerini, Firebase konsolunun Performans kontrol panelinin alt kısmında bulunan izler tablosunun Ağ istekleri alt sekmesinde gösterir.
Yalnızca özel URL kalıplarını görüntülemek için izler tablosunun Ağ istekleri alt sekmesindeki açılır menüden Özel kalıplar'ı seçin. Özel bir URL kalıbının birleştirilmiş verisi yoksa yalnızca bu listede görüneceğini unutmayın.
Bir URL kalıbı altında toplanan verilerin veri saklama süresi sona erdiğinde Firebase, bu verileri URL kalıbından siler. Özel bir URL kalıbı altında toplanan tüm verilerin süresi dolarsa Firebase, özel URL kalıbını Firebase konsolundan silmez. Bunun yerine Firebase, izler tablosunun Ağ istekleri alt sekmesindeki Özel kalıplar listesinde "boş" özel URL kalıplarını listelemeye devam eder.
Özel URL kalıbını kaldırma
Özel URL kalıplarını projenizden kaldırabilirsiniz. Otomatik URL kalıplarını kaldıramayacağınızı unutmayın.
Performans kontrol panelinde izler tablosuna gidin ve Ağ istekleri alt sekmesini seçin.
Ağ istekleri alt sekmesindeki açılır menüden Özel kalıplar'ı seçin.
Kaldırmak istediğiniz özel URL kalıbının satırının üzerine gelin.
Satırın en sağındaki simgesini tıklayın, Özel kalıbı kaldır'ı seçin ve ardından iletişim kutusunda kaldırma işlemini onaylayın.
Özel URL kalıbını kaldırdığınızda aşağıdakileri göz önünde bulundurun:
Gelecekteki tüm istekler, bir sonraki en spesifik eşleşen özel URL kalıbıyla eşleştirilir. Firebase eşleşen özel URL kalıbı bulamazsa otomatik URL kalıbı eşleştirme özelliğini kullanır.
Önceki isteklerden elde edilen eşleşmeler ve birleştirilmiş veriler, özel URL kalıbının kaldırılmasından etkilenmez.
Kaldırılan bir özel URL kalıbına ve bu kalıbın birleştirilmiş verilerine, geçerli veri saklama süresinin sonuna kadar Ağ istekleri alt sekmesinden (Tüm ağ istekleri seçiliyken) erişmeye devam edebilirsiniz. Kaldırılan özel URL kalıbı altındaki tüm birleştirilmiş verilerin süresi dolduğunda Firebase, özel URL kalıbını siler.
Ağ istekleri alt sekmesi (Özel kalıplar seçiliyken) kaldırılan özel URL kalıplarını listelemez.
Sonraki adımlar
- Uygulamanızın performansını düşüren ağ istekleri için uyarılar ayarlayın. Örneğin, belirli bir URL kalıbının yanıt süresi belirlediğiniz eşiği aşarsa ekibiniz için bir e-posta uyarısı yapılandırabilirsiniz.
Başarı oranının nasıl hesaplanacağını özelleştirme
Firebase'in her ağ isteği için izlediği metriklerden biri, isteğin başarı oranıdır. Başarı oranı, toplam yanıt sayısına kıyasla başarılı yanıtların yüzdesidir. Bu metrik, ağ ve sunucu hatalarını ölçmenize yardımcı olur.
Özellikle Firebase, yanıt kodu 100-399 aralığında olan ağ isteklerini otomatik olarak başarılı yanıtlar olarak sayar.
Firebase'in otomatik olarak başarılı saydığı yanıt kodlarına ek olarak belirli hata kodlarını "başarılı yanıtlar" olarak sayarak başarı oranı hesaplamasını özelleştirebilirsiniz.
Örneğin, uygulamanızda bir arama uç noktası API'si varsa 404 yanıtlarını "başarılı" olarak sayabilirsiniz. Çünkü bir arama uç noktası için 404 yanıtları beklenir. Bu arama uç noktası için her saat 100 örnek olduğunu ve bunların 60'ının 200 yanıtı, 40'ının ise 404 yanıtı olduğunu varsayalım. Başarı oranını yapılandırmadan önce başarı oranı %60 olur. Başarı oranı hesaplamasını 404 yanıtlarını başarılı sayacak şekilde yapılandırdıktan sonra başarı oranı %100 olur.
Başarı oranı hesaplamasını yapılandırma
Bir ağ URL kalıbı için başarı oranı hesaplamasını yapılandırmak istiyorsanız firebaseperformance.config.update iznine sahip olmanız gerekir. Aşağıdaki roller, bu gerekli izni varsayılan olarak içerir: Firebase Performance Yöneticisi, Firebase Quality Yöneticisi, Firebase Yöneticisi ve proje Sahibi veya Düzenleyicisi.
- Firebase konsolunda Performance Monitoring Kontrol paneli sekmesine gidin, ardından başarı oranı hesaplamasını yapılandırmak istediğiniz uygulamayı seçin.
- Ekranın alt kısmındaki izler tablosuna gidin ve Ağ istekleri sekmesini seçin.
- Başarı oranı hesaplamasını yapılandırmak istediğiniz URL kalıbını bulun.
- Satırın en sağındaki taşma menüsünü () açın ve Başarı oranını yapılandır'ı seçin.
- Başarılı yanıt kodu olarak saymak istediğiniz yanıt kodlarını seçmek için ekrandaki talimatları uygulayın.