Dostosuj agregację danych żądań sieciowych

Monitorowanie wydajności Firebase automatycznie agreguje dane dotyczące 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. Oferujemy dwa sposoby dostosowywania agregacji danych dla żądań sieciowych: agregowanie danych w ramach niestandardowych wzorców adresów URL i dostosowywanie sposobu obliczania współczynnika powodzenia .

Agreguj dane w ramach niestandardowych wzorców adresów URL

Dla 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 na podstawie wzorca 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ć problemy 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 śladów, która znajduje się na dole panelu Wydajność konsoli Firebase.

Jak działa niestandardowe dopasowywanie wzorców adresów URL?

Firebase próbuje dopasować adresy URL żądań do dowolnych skonfigurowanych niestandardowych wzorców adresów URL, zanim powróci do automatycznego dopasowywania wzorców adresów URL. W przypadku żądań pasujących 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ż jednego niestandardowego wzorca adresu URL, Firebase mapuje żą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 strony ścieżki . 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 szczegółowym pasującym wzorcem 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 ponownie agreguje danych żądań z mocą wsteczną.

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

Utwórz niestandardowy wzorzec adresu URL

Możesz utworzyć niestandardowy wzorzec adresu URL na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się na dole panelu Wydajność konsoli Firebase.

Aby utworzyć nowy niestandardowy wzorzec adresu URL, członek projektu musi być właścicielem lub redaktorem ; jednak wszyscy członkowie projektu mogą przeglądać niestandardowe wzorce adresów URL i ich zagregowane dane.

Możesz utworzyć łącznie do 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
  • ** — dopasowuje dowolny przyrostek ścieżki

W poniższej tabeli opisano niektóre potencjalne dopasowania niestandardowych wzorców adresów URL.

Aby dopasować... Utwórz niestandardowy wzorzec adresu URL, taki jak... Przykładowe 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 wzorzec nie będzie pasował do example.com/foo .

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

Aby wyświetlić tylko niestandardowe wzorce adresów URL, wybierz opcję Wzorce niestandardowe z menu rozwijanego na podkarcie Żądania sieciowe tabeli śladów. Pamiętaj, że jeśli niestandardowy wzorzec adresu URL nie zawiera żadnych danych zagregowanych, pojawi się on 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 zagregowane w ramach niestandardowego wzorca adresu URL wygasną, Firebase nie usunie niestandardowego wzorca adresu URL z konsoli Firebase. Zamiast tego Firebase w dalszym ciągu wyświetla „puste” niestandardowe wzorce adresów URL na liście Wzorce niestandardowe na podkarcie Żądania sieciowe tabeli śladów.

Usuń niestandardowy wzorzec adresu URL

Możesz usunąć niestandardowe wzorce adresów URL ze swojego projektu. Pamiętaj, że nie można usunąć automatycznego wzorca adresu URL.

  1. W panelu Wydajność przewiń w dół do tabeli śladów, a następnie wybierz podkartę Żądania sieciowe .

  2. Wybierz opcję Wzorce niestandardowe z menu rozwijanego na karcie podrzędnej Żądania sieciowe .

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

  4. Kliknij po prawej stronie wiersza, wybierz opcję Usuń niestandardowy wzór , a następnie potwierdź usunięcie w oknie dialogowym.

Usuwając niestandardowy wzorzec adresu URL, należy pamiętać o następujących kwestiach:

  • Wszelkie przyszłe żądania są mapowane na następny, najbardziej szczegółowy , pasujący niestandardowy wzorzec 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 zagregowane 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 zaznaczoną opcją Wszystkie żądania sieciowe ) do końca obowiązującego okresu przechowywania danych. Kiedy wszystkie zagregowane dane w usuniętym niestandardowym wzorcu adresu URL wygasną, Firebase usunie niestandardowy wzorzec adresu URL.

  • Podkarta Żądania sieciowe (z wybraną opcją Wzorce niestandardowe ) nie zawiera listy usuniętych niestandardowych wzorców adresów URL.

Następne kroki

  • Skonfiguruj alerty dla żądań sieciowych, które obniżają wydajność Twojej aplikacji. Możesz na przykład 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 monitorowanych przez Firebase dla każdego żądania sieciowego jest współczynnik powodzenia żądania. Wskaźnik sukcesu to odsetek pomyślnych odpowiedzi w porównaniu do całkowitej liczby odpowiedzi. Ta metryka pomaga mierzyć awarie sieci i serwerów.

W szczególności Firebase automatycznie zlicza żądania sieciowe z kodem odpowiedzi z zakresu 100–399 jako odpowiedzi pomyślne.

Możesz dostosować obliczenia współczynnika powodzenia, zliczając określone kody błędów jako „pomyślne 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 policzyć 404 odpowiedzi jako „pomyślne”, ponieważ oczekuje się 404 odpowiedzi dla punktu końcowego wyszukiwania. Załóżmy, że co godzinę dla tego punktu końcowego wyszukiwania pojawia się 100 próbek, a 60 z nich to 200 odpowiedzi, a 40 z nich to 404 odpowiedzi. Przed skonfigurowaniem współczynnika powodzenia będzie on wynosić 60%. Po skonfigurowaniu obliczania współczynnika powodzenia w celu zliczenia 404 odpowiedzi jako pomyślnych, wskaźnik sukcesu wyniesie 100%.

Skonfiguruj obliczanie wskaźnika sukcesu

Aby skonfigurować obliczanie współczynnika powodzenia dla wzorca adresu URL sieci, musisz mieć uprawnienie firebaseperformance.config.update . Następujące role domyślnie obejmują to wymagane uprawnienie: Administrator wydajności Firebase , Administrator jakości Firebase , Administrator Firebase oraz Właściciel lub redaktor projektu.

  1. Przejdź do zakładki Panel monitorowania wydajności w konsoli Firebase, a następnie wybierz aplikację, dla której chcesz skonfigurować obliczanie współczynnika powodzenia.
  2. Przewiń w dół do tabeli śladów na dole ekranu i wybierz kartę Żądania sieciowe .
  3. Znajdź wzorzec adresu URL, dla którego chcesz skonfigurować obliczanie współczynnika powodzenia.
  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 kody pomyślnej odpowiedzi.