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ğ isteklerine ilişkin 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 biçimini özelleştirmeniz gerekir. Ağ istekleri için veri toplamayı özelleştirmeniz için iki yol sunuyoruz: verileri özel URL modelleri altında toplamak ve başarı oranının nasıl hesaplanacağını özelleştirmek .

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

Firebase, her istek için ağ isteğinin URL'sinin bir URL modeliyle eşleşip eşleşmediğini kontrol eder. İstek URL'si bir URL modeliyle eşleşiyorsa 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'deki sorunları 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ındaki izlemeler tablosunun Ağ istekleri alt sekmesinde görüntüler.

Özel URL kalıbı eşleştirme nasıl çalışır?

Firebase, otomatik URL modeli eşleştirmeye geri dönmeden önce istek URL'lerini yapılandırılmış herhangi bir özel URL modeliyle 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şiyorsa Firebase, aşağıdaki spesifikasyon sırasına göre isteği yalnızca en spesifik özel URL modeliyle eşler: yolda düz metin > * > ** 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/* modeli, en spesifik eşleşen URL modelidir çünkü example.com/books/* adresindeki en soldaki books segmenti, example.com/*/dog adresindeki en soldaki segment * üzerinde önceliklidir.

Yeni bir özel URL modeli oluşturduğunuzda aşağıdakilere dikkat edin:

  • Önceki isteklerden elde edilen eşleşmeler ve toplu veriler, yeni bir özel URL modelinin oluşturulmasından etkilenmez. Firebase, istek verilerini geriye dönük olarak yeniden toplamaz.

  • Yeni bir özel URL modelinin oluşturulmasından yalnızca gelecekteki istekler etkilenir. Performans İzleme'nin verileri yeni bir özel URL modeli altında toplaması ve toplaması için 12 saate kadar beklemeniz gerekebilir.

Özel bir URL modeli oluşturun

Firebase konsolunun Performans kontrol panelinin alt kısmında bulunan izlemeler tablosundaki Ağ istekleri alt sekmesinden özel bir URL modeli oluşturabilirsiniz.

Yeni bir özel URL modeli oluşturmak için proje üyesinin Sahip veya Düzenleyici olması gerekir; ancak tüm proje üyeleri özel URL modellerini ve bunların toplu verilerini görüntüleyebilir.

Uygulama başına toplam 400'e kadar özel URL modeli ve söz konusu uygulama için alan başına en fazla 100 özel URL modeli oluşturabilirsiniz.

Özel bir URL modeli oluşturmak için bir ana makine adıyla başlayın ve ardından yol bölümleriyle devam edin. Ana makine adı geçerli bir etki alanı içermelidir ve isteğe bağlı olarak alt etki alanını da 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 alan adı bölümüyle veya tek bir yol bölümündeki herhangi bir dizeyle eşleşir
  • ** — rastgele bir yol son ekiyle eşleşir

Aşağıdaki tabloda bazı potansiyel özel URL modeli eşleşmeleri açıklanmaktadır.

Eşleştirmek... Şunun gibi özel bir URL modeli oluşturun: Örnek bu URL modeliyle eşleşiyor
Tam bir URL example.com/foo/baz example.com/foo/baz
Herhangi bir tek yol bölümü ( * ) 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 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

Ö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ındaki izlemeler 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ış verisi yoksa yalnızca bu listede görüneceğini unutmayın.

Bir URL kalıbı altında toplanan veriler için veri saklama süresi sona erdiğinde Firebase, söz konusu verileri URL kalıbından 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 modellerini listelemeye devam eder.

Özel bir URL modelini kaldırma

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

  1. Performans panosundan izleme tablosuna ilerleyin ve 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 deseni kaldır'ı seçin ve ardından iletişim kutusunda kaldırma işlemini onaylayın.

Özel bir URL modelini kaldırdığınızda aşağıdakilere dikkat edin:

  • Gelecekteki istekler, bir sonraki en spesifik eşleşen özel URL modeliyle eşleştirilir. Firebase eşleşen özel URL modeli bulamazsa otomatik URL modeli eşleştirmeye geri döner.

  • Önceki isteklerden elde edilen eşleşmeler ve toplu veriler, özel bir URL modelinin kaldırılmasından etkilenmez.

    Geçerli veri saklama döneminin sonuna kadar, kaldırılmış bir özel URL kalıbına ve onun toplu verilerine Ağ istekleri alt sekmesinden ( Tüm ağ istekleri seçili olarak) erişmeye devam edebilirsiniz. Kaldırılan özel URL modeli kapsamında toplanan tüm verilerin süresi dolduğunda Firebase, özel URL modelini siler.

  • Ağ istekleri alt sekmesi ( Özel modeller seçiliyken), kaldırılan özel URL modellerinin hiçbirini listelemez.

Sonraki adımlar

  • Uygulamanızın performansını düşüren ağ istekleri için uyarılar ayarlayın . Örneğin, belirli bir URL modelinin 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ş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 yanıt koduna sahip ağ isteklerini otomatik olarak başarılı yanıtlar olarak sayar.

Firebase'in 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, bir 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 başı 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.

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

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

  1. Firebase konsolundaki Performans İzleme Kontrol Paneli sekmesine gidin ve ardından başarı oranı hesaplamasını yapılandırmak istediğiniz uygulamayı seçin.
  2. Ekranın altındaki izleme 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ğındaki 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.