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

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

Ancak bazen Firebase'in belirli veri toplama yöntemlerini ağ isteği verilerini kullanarak uygulamanızın kullanım alanlarını daha iyi desteklemesini sağlayabilirsiniz. Sunumunuzda yer alan ağ istekleri için veri toplamayı özelleştirmenizi sağlar: özel URL kalıpları ve Başarı oranının hesaplanma şeklini özelleştirebilirsiniz.

Özel URL kalıpları altında verileri birleştirme

Firebase, her istek için ağ isteği URL'sinin URL kalıbı. İstek URL'si Bir URL kalıbıyla eşleşirse Firebase, isteğin verilerini otomatik olarak toplar girin.

Yayınladığınız belirli URL kalıplarını izlemek için özel URL kalıpları Firebase türetilen otomatik URL kalıbıyla yakalama yapmıyor eşleştirme. Ö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, istek URL'lerini yapılandırılmış özel URL kalıplarıyla eşleştirmeye çalışır test eder. 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, yalnızca en spesifik özel URL kalıbına yönelik istekte şu kesinlik sırasına göre: düz metin > * ** soldan: tıklayın. Örneğin, example.com/books/dog için yapılan bir istek İki özel URL kalıbı

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

Ancak kalıp example.com/books/*, eşleşen en spesifik URL kalıbıdır, çünkü example.com/books/* içinde en soldaki segment (books) şu segmente göre önceliklidir: example.com/*/dog içinde en soldaki segment (*).

Yeni bir özel URL kalıbı oluştururken aşağıdakileri göz önünde bulundurun:

  • Yeni bir özel URL kalıbı oluşturmak, önceki isteklerden gelen eşleşmeleri ve birleştirilmiş verileri etkilemez. Firebase, geriye dönük olarak talep verilerini yeniden topluyor.

  • Yeni bir özel URL kalıbı oluşturulması yalnızca gelecekteki isteklerden etkilenir. Performance Monitoring adlı paketin veri toplaması ve toplaması için 12 saate kadar beklemeniz gerekebilir. yeni bir özel URL kalıbı altında toplanan verileri birleştirebilirsiniz.

Özel URL kalıbı oluşturma

Ağ istekleri alt sekmesinde Ağ istekleri alt sekmesinden özel bir URL kalıbı oluşturabilirsiniz. en alt kısmında bulunan Performans kontrol paneli Firebase konsolu.

Bir proje üyesinin şu işlemler için Sahip veya Düzenleyici olması gerekir: yeni bir özel URL kalıbı oluşturun; ancak tüm proje üyeleri özel URL kalıpları ve bunların birleştirilmiş verileri.

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 URL kalıbı oluşturmak için bir ana makine adıyla başlayın ve ardından yol ile devam edin segment'e göz atın. Ana makine adı, geçerli bir alan adı içermelidir. İsteğe bağlı olarak, alt alan adını da içerir. Aşağıdaki yol segmenti söz dizimini kullanarak URL'lerle eşleşebilir.

  • 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... Aşağıdaki gibi özel bir URL kalıbı oluşturun... Bu URL kalıbıyla eşleşme örnekleri
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 eşleşmez example.com/foo.

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 kalıplarını ve verilerini görüntüleme

Firebase, tüm URL kalıplarını (özel URL kalıpları dahil) ve Ağ istekleri alt sekmesinde yer alan birleştirilmiş veriler sayfanın en altında Performans kontrol paneli Firebase konsolu.

Yalnızca özel URL kalıplarını görüntülemek için açılır listeden Özel kalıplar'ı seçin Ağ istekleri alt sekmesinde bulabilirsiniz. Özel bir URL kalıbında birleştirilmiş veri bulunmadığından yalnızca bu listede görünür.

Veri saklama süresinin bir URL kalıbı altında toplanan veriler için sonlandırılırsa, Firebase bu verileri siler . Tüm veriler özel bir URL kalıbı altında toplanmışsa süresi dolarsa Firebase, özel URL kalıbını silmek Firebase konsolu. Bunun yerine Firebase, "boş" olarak listelemeye devam eder özel URL Ağ istekleri alt sekmesinin Özel kalıplar listesindeki izler tablosunu kullanın.

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

Özel URL kalıplarını projenizden kaldırabilirsiniz. Bu işlemi yapamayacağınızı lütfen unutmayın. otomatik URL kalıbını kaldırın.

  1. Performans sekmesinden kontrol paneli İzleme tablosuna ilerleyin ve Ağ istekleri alt sekmesini seçin.

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

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

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

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

  • Gelecekteki tüm istekler, bir sonraki en spesifik eşleşmeyle eşlenir özel URL kalıbı. Firebase eşleşen özel URL kalıbı bulamazsa otomatik URL kalıbı eşleştirmeye geçer.

  • Önceki isteklere ait eşleşmeler ve birleştirilmiş veriler etkilenmez. özel bir URL kalıbını kaldırarak.

    Kaldırılan bir özel URL kalıbına ve bu kalıpların birleştirilmiş Ağ istekleri alt sekmesindeki veriler (Tüm ağ istekleri seçili halde) sona erecektir. Tüm kaldırılan özel URL kalıbı altındaki birleştirilmiş verilerin süresi dolar, Firebase özel URL kalıbını siler.

  • Ağ istekleri alt sekmesinde (Özel kalıplar seçiliyken) Kaldırılmış özel URL kalıplarını listelemek.

Sonraki adımlar

  • Kalitesi düşen ağ istekleri için uyarı ayarlarını yapma en iyi uygulamaları paylaşacağız. Örneğin, şunun için bir e-posta uyarısı yapılandırabilirsiniz: belirli bir URL kalıbı için yanıt süresi ne kadar zaman ayırabileceğinizi göstereceğim.

Başarı oranının hesaplanma şeklini özelleştirin

Firebase'ın her ağ isteği için izlediği metriklerden biri, isteğin başarı oranıdır. Başarı oranı, başarılı yanıtların yüzdesidir (toplam yanıtlarla karşılaştırıldığında) Bu metrik sayesinde ağ ve sunucu başarısız olur.

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

Belirli hata kodlarını sayarak başarı oranı hesaplamasını özelleştirebilirsiniz "başarılı yanıtlar" olarak yanıt kodlarının yanı sıra Firebase'in otomatik olarak başarılı sayılır.

Örneğin, uygulamanızda bir arama uç noktası API'si varsa 404 yanıtlarını sayabilirsiniz. "başarılı" olarak çünkü bir arama uç noktası için 404 yanıtları bekleniyor. 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. Yapılandırmadan önce başarı oranı ise %60 olur. Başarıyı yapılandırdıktan sonra başarılı olarak saymak için yeniden hesaplama oranı hesaplamasını istiyorsanız başarı oranı %100.

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

Bir ağ URL'si kalıbının 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 ekle: Firebase Performans Yöneticisi, Firebase Kalite Yöneticisi, Firebase Yöneticisi, Sahibi veya Düzenleyici'yi seçin.

  1. Performance Monitoring Kontrol Paneli'ne gidin sekmesinden Firebase konsolunda kullanmak istediğiniz uygulamayı seçin nasıl yapılandıracağınızı öğreneceksiniz.
  2. Ekranın alt kısmındaki izler tablosuna gidin ve Ağ istekleri sekmesi.
  3. Başarı oranını yapılandırmak istediğiniz URL kalıbını bulun hesaplamanız gerekir.
  4. Satırın en sağındaki taşma menüsünü açın () ve "Başarıyı yapılandır"ı seçin ücret belirtin.
  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.