Catch up on highlights from Firebase at Google I/O 2023. Learn more

Dostosuj agregację danych żądań sieciowych

Firebase Performance Monitoring 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 agreguje 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 według niestandardowych wzorców adresów URL i dostosowywanie sposobu obliczania współczynnika powodzenia .

Agreguj dane 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 zgodnie ze wzorcem 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ązać problem z określonym 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 śledzenia, która znajduje się na dole panelu Wydajność w 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 przed powrotem do automatycznego dopasowywania wzorców adresów URL. W przypadku żądań pasujących do niestandardowego wzorca adresu URL Firebase agreguje dane żądań zgodnie z niestandardowym wzorcem adresu URL.

Jeśli adres URL żądania pasuje do więcej niż jednego niestandardowego wzorca adresu URL, Firebase odwzorowuje żądanie tylko na najbardziej konkretny niestandardowy wzorzec adresu URL, zgodnie z następującą kolejnością szczegółowoś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 najbardziej precyzyjnym wzorcem pasującego adresu URL, ponieważ skrajny lewy segment books w example.com/books/* ma pierwszeństwo przed skrajnym lewym segmentem * w 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 zagregowane dane z poprzednich żądań. Firebase nie agreguje z mocą wsteczną danych żądań.

  • Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Może być konieczne odczekanie do 12 godzin, aby funkcja monitorowania wydajności zebrała i zagregowała dane w ramach nowego niestandardowego wzorca adresu URL.

Utwórz niestandardowy wzorzec adresu URL

Możesz utworzyć niestandardowy wzorzec adresu URL z podrzędnej karty Żądania sieciowe w tabeli śledzenia, która znajduje się na dole panelu Wydajność w 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ć maksymalnie 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, a następnie segmentów ścieżki. Nazwa hosta musi zawierać prawidłową domenę i opcjonalnie może zawierać subdomenę. Użyj poniższej składni segmentu ścieżki, aby utworzyć wzorzec pasujący do adresów URL.

  • zwykły tekst — dopasowuje dokładny ciąg
  • * — dopasowuje pierwszy segment subdomeny lub dowolny ciąg 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ład pasuje 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 .

Sufiks dowolnej ś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

Zobacz 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 śledzenia, która znajduje się na dole panelu Wydajność w konsoli Firebase.

Aby wyświetlić tylko niestandardowe wzorce adresów URL, wybierz Wzorce niestandardowe z menu rozwijanego na podrzędnej karcie Żądania sieciowe tabeli śledzenia. 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 zagregowanych 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 tabeli śledzenia.

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. Na pulpicie nawigacyjnym Wydajność przewiń w dół do tabeli śledzenia, a następnie wybierz podkartę Żądania sieciowe .

  2. Wybierz Wzorce niestandardowe z menu rozwijanego na 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ą odwzorowywane na kolejny najbardziej szczegółowy pasujący niestandardowy wzorzec adresu URL. Jeśli Firebase nie znajdzie pasujących niestandardowych wzorców adresów URL, powraca 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ń.

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

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

Następne kroki

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

Dostosuj sposób obliczania wskaźnika sukcesu

Jednym z wskaźników, które Firebase monitoruje dla każdego żądania sieciowego, jest wskaźnik powodzenia żądania. Współczynnik sukcesu to odsetek pomyślnych odpowiedzi w porównaniu z całkowitą liczbą odpowiedzi. Ta metryka pomaga mierzyć awarie sieci i serwerów.

W szczególności Firebase automatycznie zlicza żądania sieciowe z kodem odpowiedzi w zakresie od 100 do 399 jako pomyślne odpowiedzi.

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

Na przykład, jeśli Twoja aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz liczyć 404 odpowiedzi jako „udane”, ponieważ oczekuje się 404 odpowiedzi dla punktu końcowego wyszukiwania. Załóżmy, że co godzinę jest pobieranych 100 próbek dla tego punktu końcowego wyszukiwania, a 60 z nich to 200 odpowiedzi, a 40 z nich to 404 odpowiedzi. Przed skonfigurowaniem wskaźnika sukcesu wskaźnik sukcesu będzie wynosił 60%. Po skonfigurowaniu obliczania wskaźnika sukcesu w celu zliczania 404 odpowiedzi jako pomyślnych, wskaźnik sukcesu wyniesie 100%.

Skonfiguruj obliczanie wskaźnika sukcesu

Aby skonfigurować obliczanie współczynnika powodzenia dla wzorca sieciowego adresu URL, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie zawierają to wymagane uprawnienie: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin oraz Project Owner or Editor .

  1. Przejdź do karty Pulpit nawigacyjny monitorowania wydajności w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować obliczanie wskaźnika powodzenia.
  2. Przewiń w dół do tabeli śledzenia u dołu ekranu i wybierz 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 wybierz opcję Konfiguruj współczynnik powodzenia .
  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które mają być liczone jako pomyślne kody odpowiedzi.