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

Firebase Performance Monitoring, ağ isteği performansınızdaki eğilimleri anlamanıza yardımcı olmak için benzer ağ istekleri için verileri otomatik olarak toplar.

Ancak bazen, uygulamanızın kullanım durumları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ştirmeniz için iki yol sunuyoruz: verileri özel URL kalıpları altında toplayın ve başarı oranının nasıl hesaplandığını özelleştirin .

Verileri özel URL kalıpları altında toplayın

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 modeliyle eşleşirse Firebase, isteğin verilerini otomatik olarak URL modeli altında toplar.

Firebase'in türetilmiş otomatik URL kalıbı eşleştirmesiyle 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 kümesini zaman içinde izlemek için özel bir URL modeli 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ında bulunan izleme tablosunun Ağ istekleri alt sekmesinde görüntüler.

Ö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ış herhangi bir özel URL kalıbıyla eşleştirmeye çalışır. Özel bir URL modeliyle eşleşen istekler için Firebase, isteklerin verilerini özel URL modeli altında toplar.

Bir isteğin URL'si birden fazla özel URL modeliyle eşleşirse Firebase, isteği şu belirlilik sırasına göre yalnızca en belirli özel URL modeliyle eşler: düz metin > * > ** yolda soldan sağa . Örneğin, example.com/books/dog adresine yapılan bir istek, iki özel URL modeliyle eşleşir:

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

Bununla birlikte, example.com/books/* kalıbı en spesifik eşleşen URL kalıbıdır çünkü example.com/books/* içindeki en soldaki books segmenti example.com/*/dog içindeki en soldaki * segmentine göre önceliklidir.

Yeni bir özel URL kalıbı oluşturduğunuzda şunlara dikkat edin:

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

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

Özel bir URL kalıbı oluşturun

Firebase konsolunun Performans panosunun alt kısmında bulunan izlemeler tablosundaki Ağ istekleri alt sekmesinden özel bir URL kalıbı oluşturabilirsiniz.

Bir proje üyesinin, yeni bir özel URL kalıbı oluşturmak için Sahip veya Düzenleyici olması gerekir; ancak, tüm proje üyeleri özel URL modellerini ve bunların birleştirilmiş verilerini görüntüleyebilir.

Uygulama başına toplam 400 adede kadar özel URL kalıbı ve söz konusu uygulama için alan adı başına 100 adede kadar özel URL kalıbı oluşturabilirsiniz.

Özel bir URL modeli oluşturmak için, bir ana bilgisayar adıyla başlayın ve ardından yol segmentlerini takip edin. Ana bilgisayar adı, geçerli bir etki alanı içermelidir ve isteğe bağlı olarak alt etki alanını içerebilir. URL'lerle eşleşebilecek bir model oluşturmak için aşağıdaki yol segmenti sözdizimini kullanın.

• düz metin — tam bir dizeyle eşleşir
• * — ilk alt etki alanı segmentiyle veya tek bir yol segmentindeki herhangi bir dizeyle eşleşir
• ** — rastgele bir yol son ekiyle eşleşir

Aşağıdaki tablo, bazı olası özel URL kalıbı eşleştirmelerini açıklamaktadır.

Eşleştirmek...	Şunun gibi özel bir URL kalıbı oluşturun...	Bu URL modeliyle örnek eşleşmeler
Tam bir URL	example.com/foo/baz	example.com/foo/baz
Herhangi bir tek yol parçası ( * )	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şmeyecektir.
Rastgele bir yol soneki ( ** )	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 segmenti ( * )	*.example.com/foo	bar.example.com/foo baz.example.com/foo

Not: Firebase, özel URL kalıpları için *. file-extension *.png veya *.css gibi *. file-extension .

Özel URL modellerini ve verilerini görüntüleyin

Firebase, tüm URL kalıplarını (özel URL kalıpları dahil) ve bunların birleştirilmiş verilerini, Firebase konsolunun Performans kontrol panelinin altında bulunan izleme tablosunun Ağ istekleri alt sekmesinde görüntüler.

Yalnızca özel URL modellerini görüntülemek için, izleme tablosunun Ağ istekleri alt sekmesindeki açılır menüden Özel modeller'i seçin. Özel bir URL modelinin toplanmış verileri yoksa yalnızca bu listede görüneceğini unutmayın.

Bir URL modeli altında toplanan veriler için veri saklama süresi sona erdiğinde, Firebase bu verileri URL modelinden siler. Özel bir URL modeli altında toplanan tüm verilerin süresi dolarsa Firebase, özel URL modelini Firebase konsolundan silmez . Bunun yerine Firebase, izleme tablosunun Ağ istekleri alt sekmesinin Özel modeller listesinde "boş" özel URL kalıplarını listelemeye devam eder.

Özel bir URL kalıbını kaldırma

Özel URL kalıplarını projenizden kaldırabilirsiniz. Otomatik bir URL kalıbını kaldıramayacağınızı unutmayın.

1. Performans panosundan izleme tablosuna ilerleyin, ardından Ağ istekleri alt sekmesini seçin.

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

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

4. Satırın en sağındaki tıklayın, Özel kalıbı kaldır öğesini seçin, ardından iletişim kutusunda kaldırma işlemini onaylayın.

Özel bir URL kalıbını kaldırdığınızda şunlara dikkat edin:

• Gelecekteki tüm istekler, bir sonraki en spesifik eşleşen özel URL modeliyle eşlenir. Firebase eşleşen özel URL kalıbı bulamazsa, otomatik URL kalıbı eşleştirmeye geri döner.

• Önceki isteklerden gelen eşleşmeler ve birleştirilmiş veriler, özel bir URL modelinin kaldırılmasından etkilenmez.

  Geçerli veri saklama süresinin sonuna kadar, kaldırılan bir özel URL kalıbına ve onun birleştirilmiş verilerine Ağ istekleri alt sekmesinden ( Tüm ağ istekleri seçili olarak) 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çili olarak), kaldırılan herhangi bir özel URL kalıbı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 modeli için 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 hesaplandığını özelleştirin

Firebase'in her ağ isteği için izlediği ölçümlerden 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 ölçüm, ağ ve sunucu arızalarını ölçmenize yardımcı olur.

Özellikle Firebase, 100 - 399 aralığında bir yanıt koduna sahip ağ isteklerini başarılı yanıtlar 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ızın bir arama uç noktası API'si varsa, 404 yanıtı "başarılı" olarak sayabilirsiniz çünkü bir arama uç noktası için 404 yanıt beklenir. Bu arama uç noktası için her saat 100 örnek olduğunu ve bunların 60'ının 200 yanıt ve 40'ının 404 yanıt olduğunu varsayalım. Başarı oranını yapılandırmadan önce, başarı oranı %60 olacaktır. Başarı oranı hesaplamasını 404 yanıtı başarılı olarak sayacak şekilde yapılandırdıktan sonra, başarı oranı %100 olacaktır.

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ırın

Bir ağ URL modeli için başarı oranı hesaplamasını yapılandırmak için firebaseperformance.config.update iznine sahip olmanız gerekir. Aşağıdaki roller bu gerekli izni varsayılan olarak içerir: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin ve proje Sahibi veya Düzenleyici .

1. Firebase konsolundaki Performance Monitoring Dashboard sekmesine gidin, ardından bir başarı oranı hesaplaması yapılandırmak istediğiniz uygulamayı seçin.
2. Ekranın altındaki iz tablosuna ilerleyin ve Ağ istekleri sekmesini seçin.
3. Başarı oranı hesaplamasını yapılandırmak istediğiniz URL modelini 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ı izleyin.

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