Firebase Performance Monitoring automatycznie agreguje dane dotyczące podobnych żądań sieciowych, aby ułatwić Ci zrozumienie trendów w skuteczności żądań sieciowych.
Czasami jednak musisz dostosować sposób, w jaki Firebase gromadzi dane dotyczące konkretnych żądań sieciowych, aby lepiej obsługiwać przypadki użycia w Twojej 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 odsetka powodzeń.
Agregowanie danych w ramach 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 we wzorcu adresu URL.
Możesz utworzyć niestandardowe wzorce adresów URL, aby monitorować konkretne wzorce adresów URL, które nie są rejestrowane przez Firebase 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 karcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Wydajność w Firebase konsoli.
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 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ą szczegółowości: zwykły tekst > * > ** od lewej do prawej w ścieżce. Na przykład żądanie 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ż najbardziej z lewej strony segment books we wzorcu example.com/books/* ma pierwszeństwo przed najbardziej z lewej strony segmentem * we wzorcu 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 ani dane zbiorcze z poprzednich żądań. Firebase nie agreguje wstecznie danych żądań.
Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Zbieranie i agregowanie danych w ramach nowego niestandardowego wzorca adresu URL może potrwać do 12 godzin.Performance Monitoring
Utwórz niestandardowy wzorzec adresu URL
Niestandardowy wzorzec adresu URL możesz utworzyć na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Skuteczność w 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 tej 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 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 – dopasowuje dokładnie do konkretnego ciągu znaków;
*– pasuje do pierwszego segmentu subdomeny lub dowolnego ciągu znaków w jednym segmencie ścieżki.**– pasuje do dowolnego sufiksu ścieżki.
W tabeli poniżej znajdziesz przykłady dopasowywania niestandardowych wzorców 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 znaku |
|
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 ich danych
Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe wzorce adresów URL) i ich zagregowane dane na karcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Wydajność w Firebase konsoli.
Aby wyświetlić tylko niestandardowe wzorce adresów URL, w menu w podkarcie Żądania sieciowe w tabeli śladów wybierz Wzorce niestandardowe. Pamiętaj, że jeśli niestandardowy wzorzec adresu URL nie zawiera żadnych zagregowanych danych, pojawia się tylko na tej liście.
Gdy okres przechowywania danych zagregowanych w ramach wzorca adresu URL dobiegnie końca, Firebase usunie te dane ze wzorca adresu URL. Jeśli wszystkie dane zagregowane w ramach niestandardowego wzorca adresu URL wygasną, Firebase nie usunie tego wzorca z konsoliFirebase. Zamiast tego Firebase nadal wyświetla „puste” niestandardowe wzorce adresów URL na liście Wzorce niestandardowe na karcie podrzędnej Żądania sieci w tabeli śladów.
Usuwanie niestandardowego wzorca adresu URL
Możesz usuwać z projektu niestandardowe wzorce adresów URL. Pamiętaj, że nie możesz usunąć automatycznego wzorca adresu URL.
Na panelu Skuteczność przewiń w dół do tabeli śladów, a następnie wybierz kartę Żądania sieciowe.
W menu na karcie Żądania sieciowe kliknij Wzorce niestandardowe.
Najedź kursorem na wiersz niestandardowego wzorca adresu URL, który chcesz usunąć.
Kliknij po prawej stronie wiersza, wybierz Usuń wzór niestandardowy, a następnie potwierdź usunięcie w oknie.
Gdy usuwasz niestandardowy wzorzec 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, przełączy się na automatyczne dopasowywanie wzorców adresów URL.
Usunięcie niestandardowego wzorca adresu URL nie ma wpływu na dopasowania ani dane zbiorcze z poprzednich żądań.
Do końca obowiązującego okresu przechowywania danych możesz nadal uzyskiwać dostęp do usuniętego wzorca niestandardowego adresu URL i jego zagregowanych danych na karcie Żądania sieciowe (po wybraniu opcji Wszystkie żądania sieciowe). Gdy wszystkie zagregowane dane w usuniętym niestandardowym wzorcu 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 pogarszają wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla zespołu, jeśli czas odpowiedzi dla określonego wzorca adresu URL przekroczy ustawiony przez Ciebie próg.
Dostosowywanie sposobu obliczania wskaźnika sukcesu
Jednym z rodzajów danych, które Firebase monitoruje w przypadku każdego żądania sieciowego, jest odsetek powodzeń żądania. Wskaźnik sukcesu to odsetek pomyślnych odpowiedzi w porównaniu z łączną liczbą odpowiedzi. Te dane pomagają 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 odsetka pomyślnych odpowiedzi, uwzględniając określone kody błędów jako „pomyślne odpowiedzi” oprócz kodów odpowiedzi, które Firebase automatycznie uznaje za pomyślne.
Jeśli na przykład Twoja aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz uznać odpowiedzi 404 za „pomyślne”, ponieważ są one oczekiwane w przypadku punktu końcowego wyszukiwania. Załóżmy, że co godzinę mamy 100 próbek dla tego punktu końcowego wyszukiwania, z czego 60 to odpowiedzi 200, a 40 to odpowiedzi 404. Zanim skonfigurujesz wskaźnik powodzenia, będzie on wynosić 60%. Po skonfigurowaniu obliczania odsetka powodzeń tak, aby odpowiedzi 404 były traktowane jako pomyślne, odsetek powodzeń wyniesie 100%.
Konfigurowanie obliczania wskaźnika sukcesu
Aby skonfigurować obliczanie odsetka powodzeń dla wzorca adresu URL sieci, musisz mieć uprawnienie firebaseperformance.config.update. Te uprawnienia są domyślnie przypisane do tych ról: Administrator wydajności Firebase, Administrator jakości w Firebase, Administrator Firebase oraz Właściciel lub Edytujący projekt.
- W Firebase konsoli otwórz Performance Monitoring kartę Panel, a następnie wybierz aplikację, dla której chcesz skonfigurować obliczanie współczynnika sukcesu.
- Przewiń w dół do tabeli śladów u dołu ekranu i kliknij kartę Żądania sieciowe.
- Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować obliczanie współczynnika powodzenia.
- Po prawej stronie wiersza otwórz menu dodatkowe () i wybierz Skonfiguruj odsetek udanych prób.
- Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które chcesz uznać za kody odpowiedzi oznaczające powodzenie.