Dostosowywanie agregacji danych żądań sieciowych

Firebase Performance Monitoring automatycznie agreguje dane dotyczące podobnych żądań sieciowych aby pomóc Ci w zrozumieniu trendów w zakresie wydajności żądań sieciowych.

Czasami jednak musisz dostosować sposób, w jaki Firebase agreguje dane dotyczące konkretnych żądań sieciowych, aby lepiej obsługiwać przypadki użycia aplikacji. Udostępniamy 2 sposoby dostosowywania agregacji danych dotyczących żądań sieciowych: agregowanie danych według niestandardowych wzorców adresów URL i dostosowywanie sposobu obliczania wskaźnika sukcesu.

Agregowanie danych według niestandardowych wzorców adresów URL

W przypadku każdego żądania Firebase sprawdza, czy adres URL żądania sieciowego pasuje do wzorca adresu URL . Jeśli adres URL żądania pasuje do wzorca adresu URL, Firebase automatycznie agreguje dane żądania według tego wzorca.

Możesz utworzyć niestandardowe wzorce adresów URL , aby monitorować konkretne wzorce adresów URL, których Firebase nie rejestruje za pomocą automatycznego dopasowywania wzorców adresów URL. Możesz na przykład użyć niestandardowego wzorca adresu URL, aby rozwiązać problem z konkretnym adresem URL lub monitorować określony zestaw adresów URL w czasie.

Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe wzorce adresów URL) i ich zagregowane dane na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu Wydajność panelu konsoli Firebase.

Jak działa dopasowywanie do niestandardowych wzorców adresów URL?

Zanim Firebase przejdzie do automatycznego dopasowywania wzorców adresów URL, próbuje dopasować adresy URL żądań do skonfigurowanych niestandardowych wzorców adresów URL. W przypadku wszystkich żądań pasujących do niestandardowego wzorca adresu URL Firebase agreguje dane żądań według tego wzorca.

Jeśli adres URL żądania pasuje do więcej niż 1 niestandardowego wzorca adresu URL, Firebase mapuje żądanie tylko na najdokładniejszy niestandardowy wzorzec adresu URL zgodnie z tą kolejnością dokładności: zwykły tekst > * > ** od lewej do prawej w ścieżce. Na przykład żądanie do example.com/books/dog pasuje do 2 niestandardowych wzorców adresów URL:

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

Jednak wzorzec example.com/books/* jest najdokładniejszym pasującym wzorcem adresu URL, ponieważ segment books po lewej stronie w example.com/books/* ma pierwszeństwo przed segmentem * po lewej stronie w example.com/*/dog.

Podczas tworzenia nowego niestandardowego wzorca adresu URL pamiętaj o tych kwestiach:

  • Utworzenie nowego niestandardowego wzorca adresu URL nie ma wpływu na dopasowania i zagregowane dane z poprzednich żądań. Firebase nie agreguje danych żądań wstecznie.

  • Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Zbieranie i agregowanie danych według nowego niestandardowego wzorca adresu URL przez Performance Monitoring może potrwać do 12 godzin.

Tworzenie niestandardowego wzorca adresu URL

Niestandardowy wzorzec adresu URL możesz utworzyć na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu Wydajność panelu konsoli Firebase.

Aby utworzyć nowy niestandardowy wzorzec adresu URL, członek projektu musi mieć rolę Właściciel lub Edytujący. Wszyscy członkowie projektu mogą jednak wyświetlać niestandardowe wzorce adresów URL i ich zagregowane dane.

Możesz utworzyć maksymalnie 400 niestandardowych wzorców adresów URL na aplikację i maksymalnie 100 niestandardowych wzorców adresów URL na domenę w przypadku tej aplikacji.

Aby utworzyć niestandardowy wzorzec adresu URL, zacznij od nazwy hosta, a następnie dodaj segmenty ścieżki. Nazwa hosta musi zawierać prawidłową domenę i opcjonalnie może zawierać subdomenę. Aby utworzyć wzorzec, który może pasować do adresów URL, użyj tej składni segmentu ścieżki:

  • zwykły tekst – pasuje do konkretnego ciągu;
  • * – pasuje do pierwszego segmentu subdomeny lub dowolnego ciągu w pojedynczym segmencie ścieżki;
  • ** – pasuje do dowolnego sufiksu ścieżki.

W tabeli poniżej znajdziesz opis niektórych potencjalnych dopasowań do niestandardowych wzorców adresów URL.

Aby dopasować... Utwórz niestandardowy wzorzec adresu URL, taki jak... Przykłady dopasowań do tego wzorca adresu URL
Dokładny adres URL example.com/foo/baz example.com/foo/baz
Dowolny pojedynczy segment ścieżki (*) 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

Uwaga: Ten wzorzec nie będzie pasować do example.com/foo.
Dowolny sufiks ścieżki (**) 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
Pierwszy segment subdomeny (*) *.example.com/foo bar.example.com/foo
baz.example.com/foo

Wyświetlanie niestandardowych wzorców adresów URL i ich danych

Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe wzorce adresów URL) i ich zagregowane dane na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu Wydajność panelu konsoli Firebase.

Aby wyświetlić tylko niestandardowe wzorce adresów URL, w menu na podkarcie Żądania sieciowe w tabeli śladów wybierz Wzorce niestandardowe. Pamiętaj, że jeśli niestandardowy wzorzec adresu URL nie ma żadnych zagregowanych danych, pojawia się tylko na tej liście.

Gdy skończy się okres przechowywania danych zagregowanych według wzorca adresu URL, Firebase usuwa te dane z tego wzorca. Jeśli wszystkie dane zagregowane według niestandardowego wzorca adresu URL wygasną, Firebase nie usunie tego wzorca z Firebase konsoli. Zamiast tego Firebase nadal będzie wyświetlać „puste” niestandardowe wzorce adresów URL na liście Wzorce niestandardowe na podkarcie Żądania sieciowe w tabeli śladów.

Usuwanie niestandardowego wzorca adresu URL

Niestandardowe wzorce adresów URL możesz usunąć z projektu. Pamiętaj, że nie możesz usunąć automatycznego wzorca adresu URL.

  1. W panelu Wydajność przewiń w dół do tabeli śladów, a następnie kliknij podkartę Żądania sieciowe.

  2. W menu na podkarcie Żądania sieciowe wybierz Wzorce niestandardowe.

  3. Najedź kursorem na wiersz niestandardowego wzorca adresu URL, który chcesz usunąć.

  4. Po prawej stronie wiersza kliknij , wybierz Usuń wzorzec niestandardowy, a następnie potwierdź usunięcie w oknie.

Podczas usuwania niestandardowego wzorca adresu URL pamiętaj o tych kwestiach:

  • Wszystkie przyszłe żądania są mapowane na następny najbardziej szczegółowy pasujący niestandardowy wzorzec adresu URL. Jeśli Firebase nie znajdzie pasujących niestandardowych wzorców adresów URL, przejdzie do automatycznego dopasowywania wzorców adresów URL.

  • Usunięcie niestandardowego wzorca adresu URL nie ma wpływu na dopasowania i zagregowane dane z poprzednich żądań.

    Do końca obowiązującego okresu przechowywania danych nadal możesz uzyskiwać dostęp do usuniętego niestandardowego wzorca adresu URL i jego zagregowanych danych na podkarcie Żądania sieciowe (z wybraną opcją Wszystkie żądania sieciowe). Gdy wszystkie zagregowane dane według usuniętego niestandardowego wzorca adresu URL wygasną, Firebase usunie ten wzorzec.

  • Na podkarcie Żądania sieciowe (z wybraną opcją Wzorce niestandardowe) nie są wyświetlane żadne usunięte niestandardowe wzorce adresów URL.

Dalsze kroki

  • Skonfiguruj alerty dotyczące żądań sieciowych, które pogarszają wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla zespołu, jeśli czas odpowiedzi na konkretny wzorzec adresu URL przekroczy ustawiony przez Ciebie próg.

Dostosowywanie sposobu obliczania wskaźnika sukcesu

Jednym ze wskaźników, które Firebase monitoruje w przypadku każdego żądania sieciowego, jest wskaźnik sukcesu żądania. Wskaźnik sukcesu to odsetek pomyślnych odpowiedzi w porównaniu z łączną liczbą odpowiedzi. Ten wskaźnik pomaga mierzyć awarie sieci i serwera.

Firebase automatycznie zlicza żądania sieciowe z kodem odpowiedzi w zakresie 100–399 jako pomyślne odpowiedzi.

Możesz dostosować obliczanie wskaźnika sukcesu, zliczając niektóre kody błędów jako „pomyślne odpowiedzi” oprócz kodów odpowiedzi, które Firebase automatycznie zlicza jako pomyślne.

Jeśli na przykład Twoja aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz zliczać odpowiedzi 404 jako „pomyślne”, ponieważ są one oczekiwane w przypadku punktu końcowego wyszukiwania. Załóżmy, że co godzinę jest 100 próbek dla tego punktu końcowego wyszukiwania, z czego 60 to odpowiedzi 200, a 40 to odpowiedzi 404. Zanim skonfigurujesz wskaźnik sukcesu, będzie on wynosić 60%. Gdy skonfigurujesz obliczanie wskaźnika sukcesu tak, aby zliczać odpowiedzi 404 jako pomyślne, wskaźnik sukcesu będzie wynosić 100%.

Konfigurowanie obliczania wskaźnika sukcesu

Aby skonfigurować obliczanie wskaźnika sukcesu dla wzorca adresu URL sieci, musisz mieć uprawnienie firebaseperformance.config.update. Domyślnie to wymagane uprawnienie mają te role: Administrator wydajności Firebase, Administrator jakości Firebase, Administrator Firebase, oraz Właściciel lub Edytujący projekt.

  1. W konsoli Firebase otwórz kartę Performance Monitoring Panel monitorowania wydajności, a następnie wybierz aplikację, dla której chcesz skonfigurować obliczanie wskaźnika sukcesu.
  2. Przewiń w dół do tabeli śladów u dołu ekranu i kliknij kartę Żądania sieciowe.
  3. Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować obliczanie wskaźnika sukcesu.
  4. Po prawej stronie wiersza otwórz rozszerzone menu () i kliknij Skonfiguruj wskaźnik sukcesu.
  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które chcesz zliczać jako pomyślne.