Check out what’s new from Firebase at Google I/O 2022. Learn more

Dostosuj agregację danych żądań sieciowych

Monitorowanie wydajności Firebase automatycznie agreguje dane dla podobnych żądań sieciowych, aby pomóc Ci zrozumieć trendy w wydajności żądań sieciowych.

Czasami jednak musisz dostosować sposób, w jaki Firebase gromadzi określone dane żądań sieciowych, aby lepiej obsługiwać przypadki użycia Twojej aplikacji. Zapewniamy dwa sposoby dostosowywania agregacji danych dla żądań sieciowych: agregowanie danych w ramach niestandardowych wzorców adresów URL i dostosowywanie sposobu obliczania współczynnika sukcesu .

Agreguj dane w ramach niestandardowych wzorców adresów URL

W przypadku każdego żądania Firebase sprawdza, czy adres URL żądania sieciowego jest zgodny ze wzorcem adresu URL . Jeśli adres URL żądania jest zgodny ze wzorcem adresu URL, Firebase automatycznie agreguje dane żądania według wzorca adresu URL.

Możesz tworzyć niestandardowe wzorce adresów URL, aby monitorować określone wzorce adresów URL, których Firebase nie przechwytuje za pomocą pochodnego automatycznego dopasowywania wzorców adresów URL . Możesz na przykład użyć niestandardowego wzorca adresu URL, aby rozwiązywać problemy 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 tabeli śladów, która znajduje się na dole panelu wydajności konsoli Firebase.

Jak działa dopasowanie niestandardowego wzorca adresu URL?

Firebase próbuje dopasować adresy URL żądań do dowolnych skonfigurowanych niestandardowych wzorców adresów URL, zanim powróci do automatycznego dopasowywania wzorców adresów URL. W przypadku dowolnych żądań pasujących do niestandardowego wzorca adresu URL Firebase gromadzi dane żądań w ramach niestandardowego wzorca adresu URL.

Jeśli adres URL żądania pasuje do więcej niż jednego niestandardowego wzorca adresu URL, Firebase mapuje żądanie tylko na najbardziej konkretny niestandardowy wzorzec adresu URL, zgodnie z następującą kolejnością: zwykły tekst > * > ** od lewej do prawej w ścieżce . Na przykład żądanie do example.com/books/dog pasuje do dwóch 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 z lewej strony w example.com/books/* ma pierwszeństwo przed segmentem z lewej example.com/*/dog *

Tworząc nowy niestandardowy wzorzec adresu URL, pamiętaj o następujących kwestiach:

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

  • Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Może być konieczne odczekanie do 12 godzin, zanim monitorowanie wydajności zbierze i zagreguje dane w ramach nowego niestandardowego wzorca adresu URL.

Utwórz niestandardowy wzorzec adresu URL

Możesz utworzyć niestandardowy wzorzec adresu URL na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się na dole panelu wydajności konsoli Firebase.

Członek projektu musi być właścicielem lub redaktorem , aby utworzyć nowy niestandardowy wzorzec adresu URL; jednak wszyscy członkowie projektu mogą wyświetlać niestandardowe wzorce adresów URL i ich zagregowane dane.

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

Aby utworzyć niestandardowy wzorzec adresu URL, zacznij od nazwy hosta, po której następują segmenty ścieżki. Nazwa hosta musi zawierać prawidłową domenę i opcjonalnie może zawierać subdomenę. Użyj następującej składni segmentu ścieżki, aby utworzyć wzorzec pasujący do adresów URL.

  • zwykły tekst — dopasowuje dokładny ciąg
  • * — pasuje do pierwszego segmentu subdomeny lub dowolnego ciągu w pojedynczym segmencie ścieżki
  • ** — pasuje do dowolnego sufiksu ścieżki

W poniższej tabeli opisano niektóre potencjalne dopasowania wzorców niestandardowych adresów URL.

Aby dopasować... Utwórz niestandardowy wzorzec adresu URL, taki jak... Przykładowe dopasowania 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 pasuje 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świetl niestandardowe wzorce adresów URL i ich dane

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

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

Po zakończeniu okresu przechowywania danych zebranych według wzorca adresu URL Firebase usuwa te dane ze wzorca adresu URL. Jeśli wszystkie dane zebrane w ramach niestandardowego wzorca adresu URL wygasną, Firebase nie usunie niestandardowego wzorca adresu URL z konsoli Firebase. Zamiast tego Firebase nadal wyświetla „puste” niestandardowe wzorce adresów URL na liście Wzorce niestandardowe na podkarcie Żądania sieciowe w tabeli śladów.

Usuń niestandardowy wzorzec adresu URL

Możesz usunąć niestandardowe wzorce adresów URL ze swojego projektu. Pamiętaj, że nie możesz usunąć automatycznego wzorca adresu URL.

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

  2. Wybierz Wzorce niestandardowe z menu rozwijanego w podkarcie Żądania sieciowe .

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

  4. Kliknij po prawej stronie wiersza, wybierz Usuń niestandardowy wzór , a następnie potwierdź usunięcie w oknie dialogowym.

Usuwając niestandardowy wzorzec adresu URL, pamiętaj o następujących kwestiach:

  • Wszelkie 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, powróci do automatycznego dopasowywania wzorców adresów URL .

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

    Nadal możesz uzyskać dostęp do usuniętego niestandardowego wzorca adresu URL i jego zagregowanych danych na podkarcie Żądania sieciowe (z zaznaczoną opcją Wszystkie żądania sieciowe ) do końca obowiązującego okresu przechowywania danych. Gdy wszystkie zagregowane dane w ramach usuniętego niestandardowego wzorca adresu URL wygasną, Firebase usunie niestandardowy wzorzec adresu URL.

  • Podkarta Żądania sieciowe (z zaznaczoną opcją Wzorce niestandardowe ) nie zawiera żadnych usuniętych niestandardowych wzorców adresów URL.

Następne kroki

  • Skonfiguruj alerty dla żądań sieciowych, które obniżają wydajność Twojej aplikacji. Możesz na przykład skonfigurować alert e-mail dla swojego zespołu, jeśli czas odpowiedzi dla określonego wzorca adresu URL przekroczy ustawiony przez Ciebie próg.

Dostosuj sposób obliczania wskaźnika sukcesu

Jedną z metryk, które Firebase monitoruje dla każdego żądania sieciowego, jest współczynnik powodzenia żądania. Wskaźnik sukcesu to odsetek udanych odpowiedzi w porównaniu do wszystkich odpowiedzi. Ta metryka pomaga mierzyć awarie sieci i serwerów.

W szczególności Firebase automatycznie liczy żądania sieciowe z kodem odpowiedzi z zakresu od 100 do 399 jako udane odpowiedzi.

Możesz dostosować obliczanie współczynnika sukcesu, licząc niektóre kody błędów jako „udane odpowiedzi” oprócz kodów odpowiedzi, które Firebase automatycznie zalicza jako pomyślne.

Jeśli na przykład Twoja aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz policzyć odpowiedzi 404 jako „pomyślne”, ponieważ odpowiedzi 404 są oczekiwane dla punktu końcowego wyszukiwania. Załóżmy, że co godzinę dla tego punktu końcowego wyszukiwania jest 100 próbek, a 60 z nich to odpowiedzi 200, a 40 z nich to odpowiedzi 404. Zanim skonfigurujesz wskaźnik sukcesu, wskaźnik sukcesu wyniesie 60%. Po skonfigurowaniu obliczania wskaźnika sukcesu tak, aby liczył 404 odpowiedzi jako pomyślne, wskaźnik sukcesu wyniesie 100%.

Skonfiguruj obliczanie wskaźnika sukcesu

Aby skonfigurować obliczanie współczynnika sukcesu dla wzorca adresu URL sieci, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie zawierają to wymagane uprawnienie: Administrator wydajności Firebase , Administrator jakości Firebase , Administrator Firebase oraz Właściciel lub edytujący projekt .

  1. Przejdź do zakładki Panel monitorowania wydajności w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować obliczanie współczynnika sukcesu.
  2. Przewiń w dół do tabeli śladów na dole ekranu i wybierz kartę Żądania sieciowe .
  3. Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować obliczanie współczynnika sukcesu.
  4. Po prawej stronie wiersza otwórz rozszerzone menu ( ) i wybierz opcję Konfiguruj wskaźnik sukcesu .
  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które mają być liczone jako kody pomyślnej odpowiedzi.