Ağ isteği veri toplamasını özelleştirme

Firebase Performance Monitoring Ağ isteği performansınızdaki trendleri anlamanıza yardımcı olmak için benzer ağ istekleriyle ilgili verileri otomatik olarak toplar.

Ancak bazen, Firebase'in belirli ağ isteği verilerini nasıl topladığını özelleştirmeniz gerekebilir. Bu sayede uygulamanızın kullanım alanlarını daha iyi destekleyebilirsiniz. Ağ istekleri için veri toplamayı özelleştirmenin iki yolu vardır: Verileri özel URL kalıpları altında toplama ve başarı oranının nasıl hesaplanacağını özelleştirme.

Verileri özel URL kalıpları altında toplama

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 otomatik olarak URL kalıbı altında toplar.

Firebase'in türetilmiş otomatik URL kalıbı eşleştirme ile yakalamadığı belirli URL kalıplarını izlemek için özel URL kalıpları oluşturabilirsiniz. Örneğin, belirli bir URL'de sorun 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 toplu verilerini, Firebase konsolunun Performans kontrol panelinin alt kısmındaki 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. Özel bir URL kalıbıyla eşleşen tüm istekler için Firebase, 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 belirgin özel URL kalıbına eşler. Bu eşleme, düz metin > * > ** yolundaki soldan sağa olacak şekilde özgüllük sırasına göre yapılır. Ö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ı, example.com/books/* içindeki en soldaki segment books, example.com/*/dog içindeki en soldaki segment *'den öncelikli olduğu için en spesifik eşleşen URL kalıbıdır.

Yeni bir özel URL kalıbı oluştururken aşağıdakilere dikkat edin:

• Önceki isteklerden gelen eşleşmeler ve birleştirilmiş veriler, yeni bir özel URL kalıbı oluşturmaktan etkilenmez. Firebase, istek verilerini geriye dönük olarak yeniden toplamamaktadır.

• Yeni bir özel URL kalıbı oluşturmaktan yalnızca gelecekteki istekler etkilenir. Performance Monitoring'nın yeni bir özel URL kalıbı altında veri toplaması ve toplaması için 12 saat kadar beklemeniz gerekebilir.

Özel URL kalıbı oluşturma

Firebase konsolunun Performans kontrol panelinin alt kısmındaki izleme tablosunda yer alan 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 toplanmış verilerini görüntüleyebilir.

Uygulama başına toplamda 400'e kadar özel URL kalıbı ve bu uygulama için alan başına 100'e kadar özel URL kalıbı oluşturabilirsiniz.

Özel URL kalıbı oluşturmak için ana makine adıyla başlayıp yol segmentleriyle devam edin. Ana makine adı geçerli bir alan adı içermeli ve isteğe bağlı olarak alt alan adı da 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 olarak bir dizeyle eşleşir
• *: İlk alt alan adı segmentiyle veya tek bir yol segmentindeki herhangi bir dizeyle eşleşir.
• **: Rastgele bir yol sonekiyle eşleşir.

Aşağıdaki tabloda, olası bazı özel URL kalıbı eşleşmeleri açıklanmaktadır.

Şunlarla eşleşmek için:	Aşağıdakine 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/baz example.com/bar/baz
	example.com/*/*/baz	example.com/foo/bar/baz example.com/bah/qux/baz
	example.com/foo/*	example.com/foo/baz example.com/foo/bar Not: Bu desen, example.com/foo ile eşleşmez.
Rastgele bir yol son eki (**)	example.com/foo/**	example.com/foo example.com/foo/baz example.com/foo/baz/more/segments
	subdomain.example.com/foo.bar/**	subdomain.example.com/foo.bar subdomain.example.com/foo.bar/baz subdomain.example.com/foo.bar/baz/more/segments
İlk alt alan adı segmenti (*)	*.example.com/foo	bar.example.com/foo baz.example.com/foo

Not: Firebase, özel URL kalıpları için *.file-extension söz dizimini (ör. *.png veya *.css) desteklemez.

Ö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 toplu verilerini, Firebase konsolunun Performans kontrol panelinin alt kısmındaki izler tablosunun Ağ istekleri alt sekmesinde gösterir.

Yalnızca özel URL kalıplarını görüntülemek için izleme tablosunun Ağ istekleri alt sekmesindeki açılır menüden Özel kalıplar'ı seçin. Özel bir URL kalıbında toplanmış veri yoksa bu kalıbın 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, izleme 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ıbını kaldıramayacağınızı unutmayın.

1. Performans kontrol panelinde, izleme tablosuna gidin ve Ağ istekleri alt sekmesini seçin.

2. Ağ istekleri alt sekmesindeki açılır menüden Özel kalıplar'ı seçin.

3. Kaldırmak istediğiniz özel URL kalıbı satırının üzerine gelin.

4. Satırın en sağında simgesini tıklayın, Özel deseni kaldır'ı seçin ve iletişim kutusunda kaldırma işlemini onaylayın.

Özel URL kalıbını kaldırırken aşağıdakilere dikkat edin:

• Gelecekteki tüm istekler, eşleşen bir sonraki en belirgin özel URL kalıbına eşlenir. Firebase eşleşen özel URL kalıbı bulamazsa otomatik URL kalıbı eşleştirme'ye geri döner.

• Özel bir URL kalıbının kaldırılması, önceki isteklerden gelen eşleşmeleri ve birleştirilmiş verileri etkilemez.

  Geçerli veri saklama süresinin sonuna kadar, kaldırılan bir özel URL kalıbına ve bu kalıbın toplu verilerine 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 toplanmış verilerin süresi dolduğunda Firebase, özel URL kalıbını siler.

• Ağ istekleri alt sekmesinde (Özel kalıplar seçiliyken) kaldırılan özel URL kalıpları listelenmez.

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 hesaplanma şeklini ö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ıtlara kıyasla başarılı yanıtların yüzdesidir. Bu metrik, ağ ve sunucu hatalarını ölçmenize yardımcı olur.

Firebase, özellikle 100-399 aralığında yanıt kodu içeren ağ isteklerini başarılı yanıt olarak otomatik olarak sayar.

Firebase'in otomatik olarak başarılı saydığı yanıt kodlarına ek olarak belirli hata kodlarını "başarılı yanıt" olarak sayarak başarı oranı hesaplamasını özelleştirebilirsiniz.

Örneğin, uygulamanızda bir arama uç noktası API'si varsa 404 yanıtları bir arama uç noktası için beklendiğinden bu yanıtları "başarılı" olarak sayabilirsiniz. Bu arama uç noktası için saatte 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ı olarak sayacak şekilde yapılandırdıktan sonra başarı oranı %100 olur.

Not: Yeni başarı oranı yapılandırmaları yalnızca yapılandırma oluşturulduktan sonra toplanan veriler için geçerlidir.

Başarı oranı hesaplamasını yapılandırma

Bir ağ URL'si kalıbı için başarı oranı hesaplamasını yapılandırmak üzere firebaseperformance.config.update iznine sahip olmanız gerekir. Aşağıdaki rollerde bu gerekli izin varsayılan olarak bulunur: Firebase Performance Yöneticisi, Firebase Quality Yöneticisi, Firebase Yöneticisi, ve proje Sahibi veya Düzenleyicisi.

1. Firebase konsolunda Performance Monitoring Kontrol Paneli sekmesine gidin ve başarı oranı hesaplaması yapılandırmak istediğiniz uygulamayı seçin.
2. Ekranın alt kısmındaki izler tablosuna gidin ve Ağ istekleri sekmesini seçin.
3. Başarı oranı hesaplamasını yapılandırmak istediğiniz URL kalıbını bulun.
4. Satırın en sağında taşma menüsünü () açın ve Başarı oranını yapılandır'ı seçin.
5. Başarılı yanıt kodları olarak saymak istediğiniz yanıt kodlarını seçmek için ekrandaki talimatları uygulayın.

Not: Başarı oranını hem otomatik hem de özel URL kalıpları için yapılandırabilirsiniz. Otomatik URL kalıpları, verileriniz değiştikçe zaman içinde değişebileceğinden başarı oranını yalnızca özel URL kalıpları için yapılandırmanız önerilir.