Performance Monitoring używa wyznaczeń do zbierania danych o monitorowanych procesach w aplikacji. Wyznanie to raport zawierający dane zarejestrowane między 2 momentami w aplikacji.
W przypadku wszystkich typów aplikacji Performance Monitoring automatycznie zbiera ślad każdego żądania sieciowego wysłanego przez aplikację. Taki ślad nazywa się śladem żądania sieciowego HTTP/S. Te ścieżki zbierają dane o czasie od momentu wysłania przez aplikację żądania do punktu końcowego usługi do momentu otrzymania odpowiedzi z tego punktu końcowego. W przypadku każdego punktu końcowego, do którego aplikacja wysyła żądanie, Performance Monitoring rejestruje kilka rodzajów danych:
Czas odpowiedzi – czas od momentu przesłania żądania do momentu otrzymania odpowiedzi
Rozmiar ładunku odpowiedzi – rozmiar bajtów ładunku sieciowego pobranego przez aplikację.
Rozmiar ładunku żądania – rozmiar bajtów ładunku sieciowego przesłanego przez aplikację.
Wskaźnik sukcesu – odsetek pomyślnych odpowiedzi (kodów odpowiedzi w zakresie 100–399) w porównaniu z łączną liczbą odpowiedzi.
Dane z tych ścieżek możesz wyświetlić na podkarcie Prośby o dostęp do sieci w tabeli ścieżek, która znajduje się u dołu panelu Skuteczność (więcej informacji o używaniu konsoli znajdziesz dalej na tej stronie).
Performance Monitoring automatycznie zbiera dane o żądaniach sieciowych, które korzystają z tych bibliotek sieciowych:
Swift
- URLSession
- URLConnection
Objective-C
- NSURLSession
- NSURLConnection
Dostosowywanie agregacji danych żądań sieciowych
Oprócz gotowych narzędzi i zbiorczych danych dotyczących żądań sieci Performance Monitoring obsługuje też te opcje:
- Ręczne tworzenie ścieżek żądań sieciowych: domyślne monitorowanie obejmuje większość żądań sieciowych dotyczących Twojej aplikacji. Niektóre żądania mogą jednak nie zostać zgłoszone lub możesz używać innej biblioteki do wysyłania żądań sieciowych. W takich przypadkach możesz ręcznie skonfigurować Performance Monitoring API do śledzenia niestandardowych żądań sieci.
- Agregowanie danych według niestandardowych wzorców adresów URL: jeśli Firebase nie rejestruje niektórych adresów URL za pomocą pochodnej funkcji automatycznego dopasowywania wzorców adresów URL, możesz utworzyć niestandardowe wzorce adresów URL, aby monitorować określony zestaw adresów URL w ciągu czasu.
- Spersonalizowanie sposobu obliczania współczynnika skuteczności: czasami w przypadku niektórych punktów końcowych interfejsu API oczekuje się kodu błędu lub jest on już obsługiwany w aplikacji. W takich przypadkach możesz skonfigurować sposób obliczania współczynnika skuteczności i bardziej dokładnie monitorować współczynnik skuteczności wywołań sieci aplikacji.
Agregacja danych w ramach wzorca adresu URL
Firebase Performance Monitoring automatycznie agreguje dane dotyczące podobnych żądań sieciowych, aby ułatwić Ci analizowanie trendów w wydajności żądań sieciowych.
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 według tego wzorca. Firebase wyświetla wzorce adresów URL i ich zagregowane dane na karcie Sieć w panelu Skuteczność konsoli Firebase.
Co to jest wzorzec adresu URL?
Wzorzec adresu URL zawiera domenę oraz wzór, który może pasować do ścieżki adresu URL, np. example.com/*/animals/**.
W wzorach adresów URL można stosować te segmenty ścieżki:
- zwykły tekst – dopasowuje dokładnie do konkretnego ciągu;
*– dopasowuje dowolny ciąg w pojedynczym segmencie ścieżki.**– pasuje do dowolnego sufiksu ścieżki
Wzorce adresów URL mogą być:
- wzorce utworzone na podstawie Firebase, czyli automatyczne wzorce adresów URL;
- wzorce zdefiniowane przez użytkownika, czyli niestandardowe wzorce adresów URL;
Przykład: dowolne z tych żądań adresu URL może pasować do wzorca adresu URL example.com/*/animals/**.
example.com/singapore/animalsexample.com/australia/animals/spidersexample.com/australia/animals/marsupials/koala.png
Domena w wzorze adresu URL może też zawierać * jako pierwszy segment, np. *.example.com/*/fruits/**.
Firebase mapuje każde żądanie na tylko 1 wzór adresu URL. Jeśli masz skonfigurowane niestandardowe wzorce adresów URL, Firebase najpierw próbuje dopasować adresy URL żądań do tych wzorów. Jeśli Firebase nie znajdzie pasującego niestandardowego wzorca adresu URL, dopasuje adres URL żądania do najbardziej reprezentatywnego automatycznego wzorca adresu URL. W następnych sekcjach znajdziesz więcej informacji o wzorach adresów URL automatycznych i niestandardowych.
Automatyczne wzorce adresów URL
Bez żadnej konfiguracji Performance Monitoring stara się odzwierciedlać najnowsze zachowanie użytkowników aplikacji, dopasowując jej żądania do automatycznych wzorców adresów URL.
Jak działa automatyczne dopasowywanie wzorców adresów URL?
Firebase dopasowuje każde żądanie do najbardziej reprezentatywnego wzoru adresu URL automatycznego, który został wygenerowany na podstawie żądań wysłanych przez Twoją aplikację. Pamiętaj jednak, że Firebase najpierw próbuje dopasować adresy żądań do skonfigurowanych wzorców adresów URL niestandardowych.
Oto podstawowy przykład tego, jak Firebase próbuje dopasować żądania do najbardziej reprezentatywnego automatycznego wzorca adresu URL Twojej aplikacji.
Twoja aplikacja wysyła wiele żądań do adresów URL, takich jak:
example.com/germany/animals/bearsexample.com/germany/animals/birdsexample.com/germany/cars
Firebase stwierdza, że
example.com/germany/**to typowy wzorzec żądania w Twojej aplikacji, i dodaje go jako automatyczny wzorzec adresu URL w Twoim projekcie.W przypadku nowych żądań pasujących do tego wzorca adresu URL Firebase agreguje dane żądań w ramach automatycznego wzorca adresu URL
example.com/germany/**.Po tygodniu większość żądań wysyłanych przez aplikację jest kierowana do
example.com/germany/animals/bearsiexample.com/germany/animals/birds. Firebase wyprowadza więc bardziej reprezentatywny wzorzec adresu URLexample.com/germany/animals/**.W przypadku nowych żądań pasujących do tego nowego wzorca adresu URL Firebase agreguje dane żądań tylko w ramach nowego wzorca adresu URL. Firebase nadal agreguje dane dotyczące żądań do
example.com/germany/carsw ramachexample.com/germany/**.W ciągu kilku najbliższych tygodni liczba żądań wysyłanych przez Twoją aplikację do adresów
example.com/germany/animals/bearsiexample.com/germany/animals/birdsznacznie się zmniejszy. Firebase stwierdza, żeexample.com/germany/animals/**nie jest reprezentatywny dla najnowszego zachowania użytkowników Twojej aplikacji, więc zaczyna dopasowywać te 2 żądania doexample.com/germany/**.Firebase nie agreguje żadnych innych danych żądań w sekcji
example.com/germany/animals/**, ponieważ nie jest to już najbardziej reprezentatywny automatyczny wzorzec adresu URL.
Automatyczne dopasowywanie wzorca adresu URL jest dynamiczne, dlatego pamiętaj o tych kwestiach:
Nowe wzorce adresów URL nie mają wpływu na dopasowania ani dane zbiorcze z wcześniejszych żądań. Firebase nie agreguje wstecznie danych o zapytaniach.
Nowe wzorce adresów URL mają wpływ tylko na przyszłe żądania. Firebase mapuje każde nowe żądanie na najbardziej reprezentatywny automatyczny wzorzec adresu URL. Pamiętaj jednak, że Firebase najpierw próbuje dopasować adresy żądań do skonfigurowanych wzorców niestandardowych adresów URL.
Wyświetlanie automatycznych wzorców adresów URL i ich danych
Firebase wyświetla wszystkie wzorce adresów URL i ich dane zbiorcze w podtabeli Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Wydajność w konsoli Firebase.
Możesz zobaczyć wzorce adresów URL z etykietą Bez kategorii. Są to „szerokie” automatyczne wzorce adresów URL, w ramach których Firebase może agregować dane dotyczące żądań, które nie pasują do żadnego bardziej szczegółowego wzorca adresu URL.
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 w ramach automatycznego wzorca adresu URL wygasną, Firebase usunie ten wzór adresu URL z konsoli Firebase.
Niestandardowe wzorce adresów URL
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 adresów 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.
Aby dowiedzieć się więcej, przeczytaj artykuł Tworzenie niestandardowych wzorców adresów URL.
Śledzenie, wyświetlanie i filtrowanie danych o skuteczności
Aby wyświetlać dane o wydajności w czasie rzeczywistym, sprawdź, czy Twoja aplikacja używa wersji pakietu Performance Monitoring SDK, która jest zgodna z przetwarzaniem danych w czasie rzeczywistym. Więcej informacji o danych o skuteczności w czasie rzeczywistym
Śledzenie konkretnych danych w panelu
Aby dowiedzieć się, jak zmieniają się Twoje kluczowe dane, dodaj je do panelu danych u góry panelu Skuteczność. Możesz szybko wykrywać regresje, obserwując zmiany z tygodnia na tydzień, lub sprawdzać, czy ostatnie zmiany w kodzie poprawiają skuteczność.
Panel monitorowania wydajności Firebase" />
Aby dodać dane do panelu danych:
- Otwórz panel wydajności w konsoli Firebase.
- Kliknij pustą kartę danych, a potem wybierz istniejące dane, które chcesz dodać do tablicy.
- Aby uzyskać więcej opcji, na wypełnionej karcie danych kliknij . Możesz na przykład zastąpić lub usunąć dane.
Tablica danych pokazuje zebrane dane w ciągu czasu, zarówno w formie graficznej, jak i w postaci liczbowej zmiany procentowej.
Dowiedz się więcej o korzystaniu z panelu.
Wyświetlanie ścieżek i ich danych
Aby wyświetlić ścieżki, otwórz panel Skuteczność w konsoli Firebase, przewiń w dół do tabeli ścieżek, a następnie kliknij odpowiednią kartę podrzędną. Tabela zawiera wybrane dane dotyczące każdego śladu. Możesz nawet posortować listę według zmiany procentowej konkretnego rodzaju danych.
Performance Monitoring udostępnia w konsoli Firebase stronę rozwiązywania problemów, na której wyróżnione są zmiany danych. Dzięki temu możesz szybko rozwiązywać problemy z wydajnością i minimalizować ich wpływ na aplikacje i użytkowników. Strony rozwiązywania problemów możesz używać, gdy dowiesz się o potencjalnych problemach z wydajnością, na przykład w takich sytuacjach:
- Wybierasz odpowiednie dane w panelu i zauważysz dużą różnicę.
- W tabeli śladów sortowanie odbywa się w taki sposób, aby największe wartości różnicy były wyświetlane u góry, a Ty widzisz znaczną zmianę procentową.
- Otrzymasz e-maila z powiadomieniem o problemie ze skutecznością.
Możesz otworzyć stronę rozwiązywania problemów w jeden z tych sposobów:
- Na panelu danych kliknij przycisk Wyświetl szczegóły danych.
- Na dowolnej karcie danych kliknij
=> Wyświetl szczegóły . Na stronie rozwiązywania problemów wyświetlają się informacje o wybranych danych. - W tabeli ścieżek kliknij nazwę ścieżki lub dowolną wartość danych w wierszu powiązanym z tą ścieżką.
- W e-mailu z powiadomieniem kliknij Zbadaj.
Po kliknięciu nazwy śledzenia w tabeli ścieżek możesz rozwinąć interesujące Cię dane. Aby filtrować dane według atrybutu, kliknij przycisk
Dane Monitorowania wydajności Firebase są filtrowane według atrybutu" />
- Aby wyświetlić dane o poprzedniej lub najnowszej wersji, użyj filtra Wersja aplikacji.
- Filtruj według urządzenia, aby dowiedzieć się, jak starsze urządzenia obsługują Twoją aplikację.
- Filtruj według kraja, aby mieć pewność, że lokalizacja bazy danych nie wpływa na konkretny region.
Dowiedz się więcej o wyświetlaniu danych dotyczących prześledowań.
Następne kroki
Dowiedz się więcej o używaniu atrybutów do sprawdzania danych o skuteczności.
Dowiedz się więcej o śledzeniu problemów ze skutecznością w konsoli Firebase.
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.
- wyświetlać szczegółowe raporty o sesjach użytkowników, w których możesz zobaczyć konkretny ślad w kontekście innych śladów zebranych w ramach tej samej sesji;