Firebase Performance Monitoring automatycznie agreguje dane dla podobnych żądań sieciowych , który pomaga poznawać trendy w skuteczności żądań sieciowych.
Czasami trzeba jednak dostosować sposób, w jaki Firebase gromadzi określone danych dotyczących żądań sieciowych, aby lepiej obsługiwały konkretne zastosowania aplikacji. Udostępniamy dwie metody dostosowania agregacji danych dla żądań sieciowych: dane zagregowane w w przypadku niestandardowych wzorców adresów URL dostosować sposób obliczania wskaźnika sukcesu.
Dane zbiorcze 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 URL żądania pasuje do wzorca adresu URL, Firebase automatycznie agreguje dane żądania w ramach wzorca adresu URL.
Możesz tworzyć niestandardowe wzorce adresów URL, aby monitorować określone wzorce adresów URL, Firebase nie przechwytuje danych za pomocą swojego automatycznego wzorca adresu URL . Możesz np. 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 wzorce adresów URL) i ich danych zbiorczych znajdziesz na podkarcie Żądania sieciowe w tabeli logów czasu, która jest na dole Panel Skuteczność konsoli Firebase.
Jak działa dopasowywanie niestandardowego wzorca adresu URL?
Firebase próbuje dopasować adresy URL żądań do dowolnych skonfigurowanych niestandardowych wzorców adresów URL. przed przełączeniem się na automatyczne dopasowywanie do wzorca adresów URL. Dla wszystkich dopasowanych żądań do niestandardowego wzorca adresu URL, Firebase agreguje te żądania, danych w ramach niestandardowej Wzorzec adresu URL.
Jeśli URL żądania pasuje do więcej niż jednego niestandardowego wzorca adresu URL, Firebase mapuje
tylko do najbardziej szczegółowego niestandardowego wzorca adresu URL zgodnie z
następujący porządek szczegółowości: zwykły tekst > * ** od lewej do
bezpośrednio na ścieżce. Na przykład żądanie wysłane do example.com/books/dog pasuje do
dwa niestandardowe wzorce adresów URL:
example.com/books/*example.com/*/dog
Jednak wzorzec
example.com/books/* jest najdokładniejszym wzorcem adresu URL, ponieważ tag
pierwszy segment po lewej stronie books w example.com/books/* ma pierwszeństwo przed
segment * skrajnie po lewej stronie w miejscowości example.com/*/dog.
Tworząc nowy niestandardowy wzorzec adresu URL, pamiętaj o następujących kwestiach:
Nie mają wpływu na dopasowania ani dane zbiorcze z poprzednich żądań tworząc nowy niestandardowy wzorzec adresu URL. Firebase nie agreguje ponownie danych o żądaniach w retrospektywnej kolejności.
Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Może minąć do 12 godzin, zanim funkcja Performance Monitoring zbierze i dane zbiorcze według nowego niestandardowego wzorca adresu URL.
Utwórz niestandardowy wzorzec adresu URL
Niestandardowy wzorzec adresu URL możesz utworzyć na podkarcie Żądania sieciowe w sekcji tabeli logów czasu, która znajduje się na dole Panel Skuteczność konsoli Firebase.
Członek projektu musi być właścicielem lub edytującym, aby utworzyć nowy niestandardowy wzorzec adresu URL; ale wszyscy uczestnicy projektu mogą wyświetlać Wzorce adresów URL i ich dane zbiorcze.
Możesz utworzyć łącznie do 400 niestandardowych wzorców adresów URL na aplikację i do 100 w przypadku każdej aplikacji. dla tej aplikacji.
Aby utworzyć niestandardowy wzorzec adresu URL, zacznij od nazwy hosta, a następnie ścieżki segmentów niestandardowych. Nazwa hosta musi zawierać prawidłową domenę i opcjonalnie zawierać subdomenie. Użyj tej składni segmentu ścieżki, aby utworzyć wzorzec, mogą pasować do adresów URL.
- zwykły tekst – dokładnie pasuje do ciągu
*– dopasowuje pierwszy segment poddomeny lub dowolny ciąg znaków w pojedynczym segmencie ścieżki**– pasuje do dowolnego sufiksu ścieżki
W tej tabeli opisano niektóre potencjalne dopasowania wzorców niestandardowych adresów URL.
| Aby dopasować... | Utwórz niestandardowy wzorzec adresu URL, taki jak... | Przykład 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/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 wzór 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 ich danych
Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe wzorce adresów URL) i ich danych zbiorczych znajdziesz na podkarcie Żądania sieciowe w tabeli logów czasu, która jest na dole Panel Skuteczność konsoli Firebase.
Aby wyświetlić tylko niestandardowe wzorce adresów URL, wybierz Wzorce niestandardowe w menu. na podkarcie Żądania sieciowe tabeli logów czasu. Pamiętaj, że jeśli niestandardowe Wzorzec adresu URL nie zawiera żadnych danych zbiorczych, więc pojawia się tylko na tej liście.
Gdy okres przechowywania danych kończy się w przypadku danych zagregowanych według wzorca adresu URL, Firebase usuwa te dane z wzorca adresu URL. Jeśli wszystkie dane są zbierane według niestandardowego wzorca adresu URL wygasa, Firebase nie usuwa wzorca niestandardowego adresu URL z konsoli Firebase. Zamiast tego Firebase wyświetla jako „puste” informacje niestandardowy URL na liście Wzorce niestandardowe na podkarcie Żądania sieciowe karty tabeli logów czasu.
Usuwanie niestandardowego wzorca adresu URL
Możesz usuwać niestandardowe wzorce adresów URL z projektu. Pamiętaj, że nie możesz usunąć automatyczny wzorzec adresu URL.
W sekcji Skuteczność panel, przewiń w dół do tabeli logów czasu i kliknij podkartę Żądania sieciowe.
Kliknij Wzorce niestandardowe w menu w sekcji Żądania sieci. .
Najedź kursorem na wiersz niestandardowego wzorca adresu URL, który chcesz usunąć.
Kliknij po prawej stronie 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ą przypisywane do następnego najbardziej szczegółowego dopasowania. niestandardowy wzorzec adresu URL. Jeśli Firebase nie znajdzie pasujących niestandardowych wzorców adresów URL, powraca do automatycznego dopasowywania do wzorca adresu URL.
Nie ma to wpływu na dopasowania ani dane zbiorcze z poprzednich żądań usuwając niestandardowy wzorzec adresu URL.
Usuniętego niestandardowego wzorca adresu URL i jego danych zbiorczych możesz nadal używać na karcie Zapytania sieciowe (z opcją Wszystkie zapytania sieciowe), dopóki nie minie odpowiedni okres przechowywania danych. Gdy wszystkie dane zbiorcze powiązane z usuniętym wzorcem niestandardowego adresu URL tracą ważność, Firebase usuwa niestandardowy wzorzec adresu URL.
Podkarta Żądania sieciowe (z wybraną opcją Wzorce niestandardowe) nie będzie wszystkie usunięte niestandardowe wzorce adresów URL.
Dalsze kroki
- Skonfiguruj alerty dotyczące żądań sieciowych, które pogarszają działanie aplikacji. Możesz na przykład skonfigurować alert e-mailowy 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 z danych monitorowanych przez Firebase w przypadku każdego żądania sieci jest wskaźnik sukcesu żądania. Wskaźnik sukcesu to odsetek pomyślnych odpowiedzi w porównaniu z łączną liczbą odpowiedzi. Te dane pomagają mierzyć skuteczność sieci i serwerów błędów.
W szczególności Firebase automatycznie traktuje żądania sieciowe z kodem odpowiedzi w zakresie 100–399 jako pomyślne.
Możesz dostosować obliczanie wskaźnika sukcesu, zliczając określone kody błędów jako „udane odpowiedzi”. oprócz kodów odpowiedzi Firebase automatycznie liczy się jako skuteczne.
Jeśli np. Twoja aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz uznać odpowiedzi 404 za „udane”, ponieważ punkt końcowy wyszukiwania oczekuje odpowiedzi 404. Załóżmy, że w ciągu godziny jest 100 próbek dla tego punktu końcowego wyszukiwania, a 60 z nich to 200 odpowiedzi, z których 40 to odpowiedzi 404. Zanim skonfigurujesz wskaźnik sukcesu wynosi 60%. Po skonfigurowaniu powodzenia obliczysz współczynnik sukcesu, aby liczyć 404 odpowiedzi jako udane, wskaźnik sukcesu będzie 100%.
Konfigurowanie obliczenia wskaźnika sukcesu
Aby skonfigurować obliczanie wskaźnika sukcesu dla wzorca adresu URL sieci, musisz
masz uprawnienie firebaseperformance.config.update. Następujące role
to wymagane uprawnienie domyślnie:
Administrator wydajności Firebase,
Administrator jakości Firebase,
Administrator Firebase,
oraz Właściciel lub Edytujący projektu.
- Przejdź do panelu usługi Performance Monitoring. w konsoli Firebase i wybierz aplikację, której chcesz użyć skonfigurować obliczenie wskaźnika sukcesu.
- Przewiń w dół do tabeli logów czasu na dole ekranu i wybierz Karta Żądania sieciowe.
- Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować wskaźnik sukcesu. obliczeń.
- Po prawej stronie wiersza otwórz rozszerzone menu () i wybierz Skonfigurowano udane konw.
- Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które chcesz otrzymać. liczą się jako kody udanych odpowiedzi.