Dostosowywanie agregacji danych żądań sieciowych

Firebase Performance Monitoring automatycznie agreguje dane dotyczące podobnych żądań sieciowych, aby ułatwić Ci analizowanie trendów 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 aplikacji. Udostępniamy 2 sposoby dostosowywania agregacji danych dotyczących żądań sieciowych: agregowanie danych za pomocą niestandardowych wzorów adresów URL i dostosowywanie sposobu obliczania skuteczności.

Dane zbiorcze według niestandardowych wzoró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 zgodnie z tym wzorcem.

Możesz utworzyć niestandardowe wzorce adresów URL, aby monitorować konkretne wzorce adresów URL, których Firebase nie rejestruje za pomocą swego automatycznego dopasowywania wzorca adresu 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) oraz ich zagregowane dane na podtabeli Żądania sieciowe w tabeli Ślady, która znajduje się na dole panelu Wydajność w konsoli Firebase.

Jak działa dopasowywanie niestandardowych wzorów adresów URL?

Firebase próbuje dopasować adresy URL żądań do skonfigurowanych niestandardowych wzorów adresów URL, a potem stosuje automatyczne dopasowywanie wzorów adresów URL. W przypadku żądań pasujących 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 najbardziej szczegółowy wzorzec niestandardowego adresu URL, zgodnie z tym porządkiem szczegółowości: tekst zwykły > * > ** od lewej do prawej na ścieżce. Na przykład żądanie example.com/books/dog pasuje do 2 niestandardowych wzorów adresów URL:

• example.com/books/*
• example.com/*/dog

Jednak wzorzec example.com/books/* jest najbardziej szczegółowym 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 adresów URL nie ma wpływu na dopasowania ani dane zbiorcze z wcześniejszych żądań. Firebase nie agreguje ponownie danych o żądaniach w steczkowej perspektywie czasowej.

• Utworzenie nowego niestandardowego wzorca adresu URL ma wpływ tylko na przyszłe żądania. Może być konieczne zaczekanie do 12 godzin, aby usługa Performance Monitoring zebrała i zbiorczo przeanalizowała dane według nowego niestandardowego wzorca adresu URL.

Utwórz niestandardowy wzorzec adresu URL

Niestandardowy wzór adresu URL możesz utworzyć na karcie Żądania sieciowe w tabeli „Ślady” na dole panelu Wydajność w konsoli Firebase.

Aby utworzyć nowy niestandardowy wzorzec adresu URL, członek projektu musi mieć rolę Właściciel lub Edytujący. Jednak wszyscy członkowie projektu mogą wyświetlać niestandardowe wzorce adresów URL i ich zagregowane dane.

Możesz utworzyć łącznie maksymalnie 400 wzorców adresów URL na aplikację i maksymalnie 100 wzorców adresów URL na domenę 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 subdomenę. Aby utworzyć wzór, który może dopasowywać adresy URL, użyj tej składni segmentu ścieżki:

• zwykły tekst – dopasowuje dokładnie do konkretnego ciągu;
• * – 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 niektóre możliwe dopasowania 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/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 pasować do 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

Uwaga: w przypadku niestandardowych wzorów adresów URL Firebase nie obsługuje składni *.file-extension, np. *.png ani *.css.

Wyświetlanie niestandardowych wzorów adresów URL i ich danych

Firebase wyświetla wszystkie wzorce adresów URL (w tym niestandardowe) oraz ich zagregowane dane na podtabeli Żądania sieciowe w tabeli ścieżek, która znajduje się na dole panelu Wydajność w konsoli Firebase.

Aby wyświetlić tylko niestandardowe wzorce adresów URL, w menu w sekcji Żądania sieciowe w tabeli z wykresami wybierz Wzorce niestandardowe. Pamiętaj, że jeśli niestandardowy szablon adresu URL nie zawiera żadnych danych zbiorczych, 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 zagregowane za pomocą niestandardowego wzorca adresu URL wygasną, Firebase nie usunie niestandardowego wzorca adresu URL z konsoli Firebase. Zamiast tego Firebase nadal wyświetla „puste” niestandardowe wzorce adresów URL na liście Wzorce niestandardowe na karcie Żądania sieci w tabeli dzienników.

Usuwanie niestandardowego wzorca adresu URL

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

1. Na panelu Wyniki przewiń w dół do tabeli prześledowań, a potem kliknij kartę Wnioski sieciowe.

2. W menu na karcie Wnioski sieciowe kliknij Wzory niestandardowe.

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

4. Po prawej stronie wiersza kliknij , wybierz Usuń niestandardowy wzór, a następnie potwierdź usunięcie w oknie.

Podczas usuwania niestandardowego wzorca adresu URL pamiętaj o tych kwestiach:

• Wszystkie przyszłe żądania zostaną zmapowane na następny najbardziej specyficzny wzorzec niestandardowego adresu URL. Jeśli Firebase nie znajdzie pasujących niestandardowych wzorów adresów URL, użyje automatycznego dopasowywania wzorca adresu URL.

• Usunięcie niestandardowego wzorca adresów URL nie ma wpływu na dopasowania ani dane zbiorcze z wcześniejszych żądań.

  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 zagregowane dane w usuniętym niestandardowym wzorze adresu URL wygasną, Firebase usunie niestandardowy wzorzec adresu URL.

• Podtablica Prośby sieci (z wybranym Wzorami niestandardowymi) nie zawiera żadnych usuniętych niestandardowych wzorców 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, 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 ogółem odpowiedzi. Te dane pomagają mierzyć awarie sieci i serwerów.

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

Możesz dostosować obliczenie współczynnika sukcesu, licząc niektóre kody błędów jako „pomyślne odpowiedzi” oprócz kodów odpowiedzi, które Firebase automatycznie liczy jako pomyślne.

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 co godzinę jest 100 próbek tego punktu końcowego wyszukiwania, z których 60 to odpowiedzi 200, a 40 – 404. Zanim skonfigurujesz współczynnik powodzenia, będzie on wynosić 60%. Po skonfigurowaniu obliczenia skuteczności tak, aby traktować odpowiedzi 404 jako skuteczne, skuteczność wyniesie 100%.

Uwaga: nowe konfiguracje współczynnika skuteczności dotyczą tylko danych zebranych po utworzeniu konfiguracji.

Konfigurowanie obliczenia wskaźnika sukcesu

Aby skonfigurować obliczenie skuteczności w przypadku wzoru adresu URL sieci, musisz mieć uprawnienia firebaseperformance.config.update. Te role mają domyślnie wymagane uprawnienia: Administrator wydajności Firebase, Administrator jakości w Firebase, Administrator Firebase oraz Właściciel lub Edytujący projekt.

1. W konsoli Firebase otwórz kartę Performance Monitoring Panel, a potem wybierz aplikację, dla której chcesz skonfigurować obliczenie współczynnika skuteczności.
2. Przewiń w dół do tabeli prześledowań u dołu ekranu i kliknij kartę Prośby o dostęp do sieci.
3. Znajdź wzór adresu URL, dla którego chcesz skonfigurować obliczenie współczynnika skuteczności.
4. W prawym rogu wiersza otwórz menu przepełnienia () i wybierz Konfigurowanie współczynnika skuteczności.
5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kody odpowiedzi, które mają być uznawane za kody odpowiedzi z powodzeniem.

Uwaga: możesz skonfigurować odsetek powodzeń zarówno dla automatycznych, jak i niestandardowych wzorców adresów URL. Zalecamy konfigurowanie odsetka powodzeń tylko w przypadku niestandardowych wzorców adresów URL, ponieważ automatyczne wzorce adresów URL mogą się zmienić w czasie wraz ze zmianami w Twoich danych.