Firebase Performance Monitoring automatycznie agreguje dane dotyczące podobnych żądań sieciowych, aby ułatwić Ci zrozumienie trendów w 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.
Zbieranie danych zbiorczych 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 w ramach tego wzorca.
Możesz utworzyć niestandardowe wzorce adresów URL, aby monitorować konkretne 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 konkretnym adresem URL lub monitorować określony zestaw adresów URL na przestrzeni czasu.
Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe) i ich dane zbiorcze na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Wydajność w konsoli Firebase.
Jak działa dopasowywanie niestandardowych wzorców adresów URL?
Firebase próbuje dopasować adresy URL żądań do skonfigurowanych niestandardowych wzorców adresów URL, zanim przejdzie do automatycznego dopasowywania wzorców adresów URL. W przypadku wszystkich pasujących żądań do niestandardowego wzorca adresu URL Firebase agreguje dane żądań w ramach niestandardowego wzorca adresu URL.
Jeśli adres URL żądania pasuje do więcej niż 1 niestandardowego wzorca adresu URL, Firebase mapuje żądanie tylko na najbardziej szczegółowy niestandardowy wzorzec adresu URL zgodnie z tą kolejnością: zwykły tekst > * > ** od lewej do prawej w ścieżce. Na przykład żądanie wysłane 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 najbardziej szczegółowym 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 dane zbiorcze z poprzednich żądań. Firebase nie agreguje ponownie danych żądań wstecznie.
Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Zanim Performance Monitoring zacznie zbierać i agregować dane według nowego wzorca niestandardowego adresu URL, może minąć do 12 godzin.
Utwórz niestandardowy wzorzec adresu URL
Niestandardowy wzorzec adresu URL możesz utworzyć na podkarcie Żądania sieciowe w tabeli logów czasu, która znajduje się u dołu panelu Wydajność w konsoli Firebase.
Aby utworzyć nowy niestandardowy wzorzec adresu URL, użytkownik projektu musi być właścicielem lub edytującym. Jednak wszyscy użytkownicy projektu mogą wyświetlać niestandardowe wzorce adresów URL i ich dane zbiorcze.
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 danej aplikacji.
Aby utworzyć niestandardowy wzorzec adresu URL, zacznij od nazwy hosta, a potem dodaj segmenty ścieżki. Nazwa hosta musi zawierać prawidłową domenę i może opcjonalnie 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 – dopasowuje dokładny ciąg znaków;
*– dopasowuje pierwszy segment subdomeny lub dowolny ciąg znaków w pojedynczym segmencie ścieżki.**– pasuje do dowolnego sufiksu ścieżki.
W tabeli poniżej opisano kilka potencjalnych dopasowań wzorców niestandardowych adresów URL.
| Aby dopasować… | Utwórz niestandardowy wzorzec adresu URL, np. | 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/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
Uwaga: ten wzorzec nie będzie pasować do |
|
dowolny sufiks ścieżki (**), |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
pierwszy segment subdomeny (*), |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
Wyświetlanie niestandardowych wzorców adresów URL i powiązanych z nimi danych
Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe) i ich dane zbiorcze na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Wydajność w konsoli Firebase.
Aby wyświetlić tylko niestandardowe wzorce adresów URL, w menu na podkarcie Żądania sieciowe w tabeli logów czasu wybierz Wzorce niestandardowe. Pamiętaj, że jeśli niestandardowy wzorzec adresu URL nie zawiera żadnych danych zbiorczych, pojawi się tylko na tej liście.
Gdy okres przechowywania danych dobiegnie końca w przypadku danych zagregowanych w ramach wzorca adresu URL, Firebase usunie te dane ze wzorca adresu URL. Jeśli wszystkie dane zagregowane w ramach niestandardowego wzorca adresu URL wygasną, Firebase nie usunie niestandardowego wzorca adresu URL z konsoli Firebase. Zamiast tego Firebase nadal wyświetla „puste” wzorce niestandardowych adresów URL na liście Wzorce niestandardowe na podkarcie Żądania sieciowe w tabeli śladów.
Usuwanie niestandardowego wzorca adresu URL
Możesz usunąć niestandardowe wzorce adresów URL z projektu. Pamiętaj, że nie możesz usunąć automatycznego wzorca adresu URL.
W panelu wydajności przewiń w dół do tabeli logów czasu, a następnie wybierz podkartę Żądania sieciowe.
W podkarcie Żądania sieciowe kliknij w menu Wzorce niestandardowe.
Najedź kursorem na wiersz niestandardowego wzorca adresu URL, który chcesz usunąć.
Kliknij po prawej stronie wiersza, wybierz Usuń wzorzec niestandardowy, a następnie potwierdź usunięcie w oknie dialogowym.
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 wzorzec niestandardowego 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ń.
Usunięty niestandardowy wzorzec adresu URL i powiązane z nim dane zbiorcze będą nadal dostępne na podkarcie Żądania sieciowe (po wybraniu opcji Wszystkie żądania sieciowe) do końca obowiązującego okresu przechowywania danych. Gdy wszystkie dane zbiorcze powiązane z usuniętym niestandardowym wzorcem adresu URL wygasną, Firebase usunie ten wzorzec.
Na podkarcie Żądania sieciowe (z wybraną opcją Wzorce niestandardowe) nie ma żadnych usuniętych niestandardowych wzorców adresów URL.
Dalsze kroki
- Skonfiguruj alerty dotyczące żądań sieciowych, które obniżają wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla swojego zespołu, jeśli czas odpowiedzi na określony 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. Te dane pomagają mierzyć błędy sieci i serwera.
Firebase automatycznie zlicza żądania sieciowe z kodem odpowiedzi z zakresu 100–399 jako odpowiedzi udane.
Możesz dostosować obliczanie wskaźnika sukcesu, licząc niektóre kody błędów jako „odpowiedzi zakończone powodzeniem” oprócz kodów odpowiedzi, które Firebase automatycznie liczy jako zakończone powodzeniem.
Jeśli na przykład Twoja aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz liczyć odpowiedzi 404 jako „udane”, ponieważ odpowiedzi 404 są oczekiwane w przypadku punktu końcowego wyszukiwania. Załóżmy, że co godzinę ten punkt końcowy wyszukiwania otrzymuje 100 próbek, z czego 60 to odpowiedzi 200, a 40 to odpowiedzi 404. Zanim skonfigurujesz wskaźnik sukcesu, będzie on wynosił 60%. Po skonfigurowaniu obliczania wskaźnika sukcesu tak, aby odpowiedzi 404 były liczone jako udane, 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. To wymagane uprawnienie jest domyślnie uwzględnione w tych rolach:
Administrator wydajności Firebase,
Administrator jakości w Firebase,
Administrator Firebase,
Właściciel lub Edytujący projektu.
- W konsoli Firebase otwórz kartę Performance Monitoring Panel, a następnie wybierz aplikację, dla której chcesz skonfigurować obliczanie wskaźnika sukcesu.
- Przewiń w dół do tabeli logów czasu trwania u dołu ekranu i wybierz kartę Żądania sieciowe.
- Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować obliczanie wskaźnika sukcesu.
- Po prawej stronie wiersza otwórz rozszerzone menu () i wybierz Skonfiguruj wskaźnik sukcesu.
- Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które chcesz uznać za kody odpowiedzi oznaczające powodzenie.