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ğ istekleri için verileri otomatik olarak toplar.

Ancak bazen, uygulamanızın kullanım alanlarını daha iyi desteklemek için Firebase'in belirli ağ isteği verilerini toplama şeklini özelleştirmeniz gerekir. Ağ istekleri için veri toplamayı özelleştirmenin iki yolu vardır: Verileri özel URL kalıpları altında toplayın ve başarı oranının hesaplanmasını özelleştirin.

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, istek verilerini URL kalıbı altında otomatik olarak 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'yle 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 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 geçmeden ö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 tüm istekler için isteklerdeki verileri ö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 aşağıdaki belirginlik sırasına göre yalnızca en belirgin özel URL kalıbına eşler: düz metin > * > ** yolda soldan sağa. Örneğin, example.com/books/dog için gönderilen bir istek iki özel URL kalıbıyla eşleşir:

• example.com/books/*
• example.com/*/dog

Ancak example.com/books/* kalıbı, example.com/*/dog'teki en soldaki segment *'e kıyasla example.com/books/*'teki en soldaki segment books ö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ğıdakileri göz önünde bulundurun:

• Ö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 toplamaz.

• Yeni bir özel URL kalıbı oluşturmak yalnızca gelecekteki istekleri etkiler. Performance Monitoring'ün yeni bir özel URL kalıbı altında veri toplayıp toplaması 12 saati bulabilir.

Özel URL kalıbı oluşturma

Firebase konsolunun Performans kontrol panelinin alt kısmındaki izlemeler tablosundaki Ağ istekleri alt sekmesinden özel bir URL kalıbı oluşturabilirsiniz.

Proje üyelerinin yeni bir özel URL kalıbı oluşturmak için sahibi veya düzenleyicisi olması gerekir. Ancak tüm proje üyeleri özel URL kalıplarını ve bu kalıpların toplanmış verilerini görüntüleyebilir.

Uygulama başına toplam 400'e kadar özel URL kalıbı ve bu uygulamanın alan adı başına 100'e kadar özel URL kalıbı oluşturabilirsiniz.

Özel bir URL kalıbı oluşturmak için bir 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ı da içerebilir. URL'leri eşleştirebilecek 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ı segmentini veya tek bir yol segmentindeki herhangi bir dizeyi eşleştirir.
• **: Rastgele bir yol son ekiyle eşleşir.

Aşağıdaki tabloda, olası bazı ö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/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 kalıp 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ında *.png veya *.css gibi *.file-extension söz dizimini 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 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 izler tablosunun Ağ istekleri alt sekmesindeki açılır menüden Özel kalıplar'ı seçin. Bir özel URL kalıbında toplu 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

Projenizden özel URL kalıplarını kaldırabilirsiniz. Otomatik URL kalıplarını kaldıramayacağınızı unutmayın.

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

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

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

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

Özel URL kalıplarını kaldırırken aşağıdakileri göz önünde bulundurun:

• Gelecekteki 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ştirmeye geçer.

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

  Kaldırılan özel URL kalıplarına ve bu kalıpların birleştirilmiş verilerine, geçerli veri saklama süresi sona erene kadar Ağ istekleri alt sekmesinden (Tüm ağ istekleri seçiliyken) erişebilirsiniz. Kaldırılan özel URL kalıbının altındaki tüm toplu 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 oluşturun. Örneğin, belirli bir URL kalıbının tepki süresi, belirlediğiniz bir 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'ın 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.

Daha açık belirtmek gerekirse Firebase, 100-399 aralığında bir yanıt koduna sahip ağ isteklerini otomatik olarak başarılı yanıt olarak sayar.

Firebase'ın otomatik olarak başarılı olarak 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 arama uç noktası için 404 yanıt beklendiğinden 404 yanıtı "başarılı" olarak sayabilirsiniz. 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'tır. Başarı oranı hesaplamasını 404 yanıtları 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 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 Performans Yöneticisi, Firebase Kalite Yöneticisi, Firebase Yöneticisi ve proje Sahibi veya Düzenleyicisi.

1. Firebase konsolunda Performance Monitoring Gösterge Tablosu sekmesine gidin, ardından başarı oranı hesaplaması yapılandırmak istediğiniz uygulamayı seçin.
2. Ekranın alt kısmındaki izlemeler tablosuna gidip 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ğındaki taşma menüsünü () açıp Başarılı dönüşüm oranını yapılandır'ı seçin.
5. Başarılı yanıt kodu olarak sayılmasını 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 yalnızca özel URL kalıpları için başarı oranını yapılandırmanız önerilir.