Dostosowywanie agregacji danych żądań sieciowych

Monitorowanie wydajności Firebase 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.

Agreguj dane według niestandardowych wzorców adresów URL

W przypadku każdego żądania Firebase sprawdza, czy adres URL żądania sieciowego pasuje do Wzorzec 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 . Przykład: możesz użyć niestandardowego wzorca URL-a, by rozwiązać problemy z konkretnym adresem URL lub monitorować określonego zestawu adresów URL w czasie.

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ść w 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 działa wstecz do ponownego zagregowania danych żądania.

  • Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Może minąć do 12 godzin, zanim Monitorowanie wydajności zbierze 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ść w 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 subdomeny lub dowolny ciąg 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/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 wzór nie będzie się zgadzać. 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ś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ść w 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 dla danych agregowanych według wzorca adresu URL, Firebase usunie te dane, ze wzorca adresu URL. Jeśli wszystkie dane są zbierane według niestandardowego wzorca adresu URL utraci ważność, Firebase nie usunie niestandardowego wzorca 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 usunąć z projektu niestandardowe wzorce adresów URL. Pamiętaj, że nie możesz usunąć automatyczny wzorzec adresu URL.

  1. W sekcji Skuteczność panel, przewiń w dół do tabeli logów czasu i kliknij podkartę Żądania sieciowe.

  2. Kliknij Wzorce niestandardowe w menu w sekcji Żądania sieci. .

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

  4. 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.

    Nadal masz dostęp do usuniętego niestandardowego wzorca adresu URL i jego zagregowanych danych dane na podkarcie Żądania sieciowe (z zaznaczoną opcją Wszystkie żądania sieciowe) do końca obowiązującego okresu 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 o żądaniach sieciowych, które pogarszają wyniki wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla: Twojego zespołu, jeśli czas odpowiedzi dla określonego wzorca adresu URL przekracza wyznaczoną przez Ciebie wartość progową.

Dostosuj sposób 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 zlicza żądania sieciowe z odpowiedzią jako kod z zakresu 100–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 Firebase automatycznie liczy się jako skuteczne.

Jeśli na przykład aplikacja ma interfejs API punktu końcowego wyszukiwania, możesz zliczać 404 odpowiedzi jako „sukces” ponieważ punkt końcowy wyszukiwania powinien zawierać odpowiedź 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%.

Skonfiguruj obliczanie 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.

  1. Otwórz panel monitorowania wydajności. w konsoli Firebase i wybierz aplikację, dla której chcesz utworzyć skonfigurować obliczenie wskaźnika sukcesu.
  2. Przewiń w dół do tabeli logów czasu na dole ekranu i wybierz Karta Żądania sieciowe.
  3. Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować wskaźnik sukcesu. obliczeń.
  4. Po prawej stronie wiersza otwórz rozszerzone menu () i wybierz Skonfigurowano udane konw.
  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które chcesz otrzymać. liczą się jako kody udanych odpowiedzi.
.