Performance Monitoring używa śladów do zbierania danych o monitorowanych procesach w aplikacji. Ślad to raport zawierający dane zarejestrowane między 2 punktami w czasie w aplikacji.
W przypadku wszystkich typów aplikacji Performance Monitoring automatycznie zbiera log czasu dla każdego żądania sieciowego wysyłanego przez aplikację, zwanego logiem czasu żądania sieciowego HTTP/S. Te ślady zbierają dane o czasie od momentu, w którym aplikacja wysyła żądanie do punktu końcowego usługi, do momentu, w którym otrzymuje odpowiedź z tego punktu. W przypadku każdego punktu końcowego, do którego aplikacja wysyła żądanie, Performance Monitoring rejestruje kilka wskaźników:
Czas odpowiedzi – czas od przesłania żądania do pełnego otrzymania odpowiedzi.
Rozmiar ładunku odpowiedzi – rozmiar w bajtach ładunku sieciowego pobranego przez aplikację.
Rozmiar ładunku żądania – rozmiar w bajtach ładunku sieciowego przesłanego przez aplikację.
Wskaźnik sukcesu – odsetek pomyślnych odpowiedzi (kody odpowiedzi z zakresu 100–399) w porównaniu z łączną liczbą odpowiedzi.
Dane z tych śladów możesz wyświetlić na karcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Skuteczność (więcej informacji o korzystaniu z konsoli znajdziesz w dalszej części tej strony).
Dostosowywanie agregacji danych żądań sieciowych
Oprócz gotowych narzędzi i agregacji danych dotyczących żądań sieciowych Performance Monitoring obsługuje też te opcje:
- Ręczne instrumentowanie logów czasu żądań sieciowych: gotowe monitorowanie obejmuje większość żądań sieciowych w Twojej aplikacji. Niektóre żądania mogą jednak nie być raportowane lub możesz używać innej biblioteki do wysyłania żądań sieciowych. W takich przypadkach możesz użyć interfejsu Performance Monitoring API do ręcznego instrumentowania niestandardowych śladów żądań sieciowych.
- Agregowanie danych według niestandardowych wzorców adresów URL: jeśli istnieją konkretne adresy URL, których Firebase nie rejestruje za pomocą automatycznego dopasowywania wzorców adresów URL, możesz utworzyć niestandardowe wzorce adresów URL, aby śledzić określony zestaw adresów URL w czasie.
- Dostosowywanie sposobu obliczania odsetka udanych wywołań: w przypadku niektórych punktów końcowych interfejsu API kod błędu jest oczekiwany lub jest już obsługiwany w aplikacji. W takich przypadkach możesz skonfigurować sposób obliczania odsetka udanych wywołań i dokładniej monitorować odsetek udanych wywołań sieciowych w aplikacji.
Agregacja danych według wzorców adresu URL
Firebase Performance Monitoring automatycznie agreguje dane dotyczące podobnych żądań sieciowych, aby ułatwić Ci zrozumienie trendów w skutecznoś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 w ramach tego wzorca. Firebase wyświetla wzorce adresów URL i ich zagregowane dane na karcie Sieć na panelu Wydajność w Firebase konsoli.
Co to jest wzorzec adresu URL?
Wzorzec adresu URL zawiera domenę oraz wzorzec, który może pasować do ścieżki adresu URL, np. example.com/*/animals/**
.
Wzorce adresów URL mogą zawierać te segmenty ścieżki:
- zwykły tekst – dopasowuje dokładnie do konkretnego ciągu znaków;
*
– dopasowuje dowolny ciąg w jednym segmencie ścieżki.**
– pasuje do dowolnego sufiksu ścieżki.
Wzorce adresów URL mogą być:
- Wzorce pochodzące z Firebase, zwane automatycznymi wzorcami adresów URL.
- wzorce zdefiniowane przez użytkownika, zwane niestandardowymi wzorcami adresów URL.
Na przykład do wzorca adresu URL example.com/*/animals/**
mogą pasować te żądania URL:
example.com/singapore/animals
example.com/australia/animals/spiders
example.com/australia/animals/marsupials/koala.png
Domena wzorca adresu URL może też zawierać symbol *
jako pierwszy segment, np. *.example.com/*/fruits/**
.
Firebase mapuje każde żądanie na tylko jeden wzorzec adresu URL. Jeśli masz skonfigurowane niestandardowe wzorce adresów URL, Firebase najpierw próbuje dopasować adresy URL żądań do tych wzorców. Jeśli Firebase nie znajdzie pasującego niestandardowego wzorca adresu URL, dopasuje adres URL żądania do najbardziej reprezentatywnego automatycznego wzorca adresu URL. Więcej informacji o automatycznych i niestandardowych wzorcach adresów URL znajdziesz w kolejnych sekcjach.
Automatyczne wzorce adresów URL
Bez Twojej konfiguracji Performance Monitoring próbuje odzwierciedlić najnowsze zachowania użytkowników aplikacji, dopasowując żądania aplikacji do automatycznych wzorców URL.
Jak działa automatyczne dopasowywanie wzorców URL?
Firebase dopasowuje każde żądanie do najbardziej reprezentatywnego automatycznego wzorca adresu URL, który został utworzony na podstawie żądań wysyłanych przez Twoją aplikację. Pamiętaj jednak, że Firebase najpierw próbuje dopasować adresy URL żądań do skonfigurowanych niestandardowych wzorców adresów URL.
Poniżej znajdziesz podstawowy przykład tego, jak Firebase próbuje dopasować żądania do najbardziej reprezentatywnego automatycznego wzorca adresu URL w Twojej aplikacji.
Aplikacja wysyła wiele żądań do adresów URL takich jak:
example.com/germany/animals/bears
example.com/germany/animals/birds
example.com/germany/cars
Firebase stwierdza, że
example.com/germany/**
jest typowym wzorcem żądania w Twojej aplikacji, i dodaje go jako automatyczny wzorzec adresu URL w Twoim projekcie.W przypadku wszystkich nowych żądań pasujących do tego wzorca adresu URL Firebase agreguje dane żądań we wzorcu adresu URL
example.com/germany/**
.Po tygodniu większość żądań wysyłanych przez aplikację jest kierowana do
example.com/germany/animals/bears
iexample.com/germany/animals/birds
. Dlatego Firebase wyodrębnia bardziej reprezentatywny wzorzec adresu URLexample.com/germany/animals/**
.W przypadku wszystkich 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ń wysyłanych do
example.com/germany/cars
w ramachexample.com/germany/**
.W ciągu kilku najbliższych tygodni liczba żądań wysyłanych przez Twoją aplikację do
example.com/germany/animals/bears
iexample.com/germany/animals/birds
znacznie się zmniejszy. Firebase stwierdza, żeexample.com/germany/animals/**
nie odzwierciedla najnowszych zachowań użytkowników aplikacji, więc zaczyna dopasowywać te 2 żądania doexample.com/germany/**
.Firebase nie agreguje już żadnych dodatkowych danych żądań w sekcji
example.com/germany/animals/**
, ponieważ nie jest to już najbardziej reprezentatywny automatyczny wzorzec adresu URL.
Automatyczne dopasowywanie wzorców adresów URL jest dynamiczne, dlatego pamiętaj o tych kwestiach:
Nowe wzorce adresów URL nie mają wpływu na dopasowania ani dane zbiorcze z poprzednich żądań. Firebase nie ponownie agreguje wstecznie danych o żądaniach.
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 URL żądań do skonfigurowanych niestandardowych wzorców adresów URL.
Wyświetlanie automatycznych wzorców URL i ich danych
Firebase wyświetla wszystkie wzorce adresów URL i ich zagregowane dane na podkarcie Żądania sieciowe w tabeli śladów, która znajduje się u dołu panelu Wydajność w Firebase konsoli.
Możesz zobaczyć wzorce adresów URL z etykietą Bez kategorii. Są to „ogólne” 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 zagregowanych w ramach wzorca adresu URL dobiegnie końca, Firebase usunie te dane ze wzorca adresu URL. Jeśli wszystkie dane zagregowane w ramach automatycznego wzorca adresu URL wygasną, Firebase usunie ten wzorzec adresu URL z Firebase konsoli.
Niestandardowe wzorce adresów URL
Możesz tworzyć niestandardowe wzorce adresów URL, aby monitorować konkretne wzorce adresów URL, które nie są rejestrowane przez Firebase za pomocą automatycznego dopasowywania wzorców 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 w czasie.
Więcej informacji znajdziesz w artykule 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, upewnij się, że Twoja aplikacja korzysta z pakietu SDK do monitorowania wydajności w wersji zgodnej 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 tablicy danych u góry panelu Skuteczność. Możesz szybko identyfikować regresje, obserwując zmiany tydzień do tygodnia, lub sprawdzać, czy ostatnie zmiany w kodzie poprawiają skuteczność.

Aby dodać dane do tablicy danych, wykonaj te czynności:
- W konsoli Firebase otwórz panel Wydajność.
- Kliknij pustą kartę danych, a potem wybierz istniejące dane, które chcesz dodać do tablicy.
- Kliknij na karcie z danymi, aby wyświetlić więcej opcji, np. zastąpienia lub usunięcia danych.
Tablica danych zawiera zebrane dane w formie wykresów i liczbowych zmian procentowych.
Dowiedz się więcej o korzystaniu z panelu.
Wyświetlanie logów czasu i ich danych
Aby wyświetlić ślady, otwórz panel Skuteczność w konsoli Firebase, przewiń w dół do tabeli śladów, a potem kliknij odpowiednią kartę. Tabela zawiera najważniejsze dane dotyczące każdego śladu. Możesz nawet posortować listę według zmiany procentowej dla określonych danych.
Performance Monitoring udostępnia w Firebase konsoli stronę rozwiązywania problemów, która wyróżnia zmiany wskaźników, co ułatwia szybkie reagowanie na problemy z wydajnością i minimalizowanie ich wpływu na aplikacje i użytkowników. Strony rozwiązywania problemów możesz używać, gdy dowiesz się o potencjalnych problemach z wydajnością, np. w tych sytuacjach:
- Wybierasz w panelu odpowiednie dane i zauważasz dużą różnicę.
- W tabeli śladów sortujesz dane tak, aby największe różnice były wyświetlane u góry, i widzisz znaczną zmianę procentową.
- Otrzymasz e-maila z powiadomieniem o problemie z wydajnością.
Stronę rozwiązywania problemów możesz otworzyć w ten sposób:
- Na panelu danych kliknij przycisk Wyświetl szczegóły danych.
- Na dowolnej karcie danych wybierz
. Na stronie rozwiązywania problemów wyświetlą się informacje o wybranych danych. => Wyświetl szczegóły - W tabeli logów czasu kliknij nazwę logu czasu lub dowolną wartość danych w wierszu powiązanym z tym logiem czasu.
- W alercie e-mail kliknij Zbadaj teraz.
Gdy w tabeli śladów klikniesz nazwę śladu, możesz przejść do szczegółowych danych, które Cię interesują. Aby filtrować dane według atrybutu, kliknij przycisk

- Filtruj według Wersji aplikacji, aby wyświetlić dane dotyczące poprzedniej lub najnowszej wersji.
- Filtruj według Urządzenia, aby dowiedzieć się, jak starsze urządzenia obsługują Twoją aplikację.
- Filtruj według kraju, aby sprawdzić, czy lokalizacja bazy danych nie wpływa na konkretny region.
Dowiedz się więcej o wyświetlaniu danych dotyczących śladów.
Następne kroki
Dowiedz się więcej o używaniu atrybutów do analizowania danych o skuteczności.
Dowiedz się więcej o tym, jak śledzić problemy z wydajnością w konsoli Firebase.
Skonfiguruj alerty dotyczące żądań sieciowych, które pogarszają wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla zespołu, jeśli czas odpowiedzi dla określonego wzorca adresu URL przekroczy ustawiony przez Ciebie próg.
- Wyświetlaj szczegółowe raporty dotyczące sesji użytkowników, w których możesz zobaczyć konkretny ślad w kontekście osi czasu innych śladów zebranych podczas tej samej sesji.