Monitorowanie wydajności zbiera logi, które pomagają monitorować wydajność aplikacji. Log to raport danych o wydajności zarejestrowanych między 2 punktami w czasie w aplikacji.
Możesz tworzyć własne logi czasu, aby monitorować dane o wydajności powiązane z określonym kodem w aplikacji. Za pomocą niestandardowego logu czasu kodu możesz mierzyć, ile czasu zajmuje aplikacji wykonanie określonego zadania lub zestawu zadań, np. wczytanie zestawu obrazów lub wysłanie zapytania do bazy danych.
Domyślne dane w przypadku logu czasu kodu niestandardowego to „czas trwania” (czas między punktem początkowym a końcowym logu czasu), ale możesz też dodać dane niestandardowe.
W kodzie definiujesz początek i koniec śledzenia kodu niestandardowego za pomocą interfejsów API udostępnianych przez pakiet SDK Performance Monitoring.
Śledzenie kodu niestandardowego można rozpocząć w dowolnym momencie po jego utworzeniu. Jest ono bezpieczne dla wątków.
Domyślnym wskaźnikiem zbieranym w przypadku tych śladów jest „czas trwania”, dlatego czasami są one nazywane „śladami czasu trwania”.
Dane z tych śladów możesz wyświetlić na karcie Ślady niestandardowe 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).
Atrybuty domyślne, atrybuty niestandardowe i dane niestandardowe
W przypadku śladów kodu niestandardowego Monitorowanie wydajności automatycznie rejestruje atrybuty domyślne (typowe metadane, takie jak wersja aplikacji, kraj, urządzenie itp.), aby umożliwić filtrowanie danych śladu w konsoli Firebase. Możesz też dodawać i monitorować atrybuty niestandardowe (np. poziom gry lub właściwości użytkownika).
Możesz dodatkowo skonfigurować śledzenie kodu niestandardowego, aby rejestrować dane niestandardowe dotyczące zdarzeń związanych z wydajnością, które występują w zakresie śledzenia. Możesz na przykład utworzyć dane niestandardowe dotyczące liczby trafień i nietrafień pamięci podręcznej lub liczby przypadków, w których interfejs użytkownika przestaje odpowiadać na zauważalny okres czasu.
Atrybuty niestandardowe i dane niestandardowe są wyświetlane w konsoli Firebase obok atrybutów domyślnych i danych domyślnych śledzenia.
Dodawanie niestandardowych śladów kodu
Użyj interfejsu Performance Monitoring Trace API, aby dodać niestandardowe logi kodu i monitorować określony kod aplikacji.
Pamiętaj:
- Aplikacja może mieć wiele śladów kodu niestandardowego.
- W tym samym czasie może być uruchomionych więcej niż 1 ślad kodu niestandardowego.
- Nazwy śladów kodu niestandardowego muszą spełniać te wymagania:
nie mogą zawierać spacji na początku ani na końcu, nie mogą zaczynać się od znaku podkreślenia (
_) i mogą mieć maksymalnie 100 znaków. - Logi czasu z kodu niestandardowego obsługują dodawanie danych niestandardowych i atrybutów niestandardowych.
Aby rozpocząć i zatrzymać śledzenie kodu niestandardowego, umieść kod, który chcesz śledzić, w kodzie podobnym do tego:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Dodawanie wskaźników niestandardowych do logów czasu z kodu niestandardowego
Użyj interfejsu Performance Monitoring Trace API, aby dodać niestandardowe dane do niestandardowych logów czasu kodu.
Pamiętaj:
- Nazwy niestandardowych danych muszą spełniać te wymagania: nie mogą zawierać spacji na początku ani na końcu, nie mogą zaczynać się od podkreślenia (
_) i mogą mieć maksymalnie 100 znaków. - Każdy log czasu z kodu niestandardowego może rejestrować do 32 rodzajów danych (w tym domyślne dane Czas trwania).
Aby dodać dane niestandardowe, dodaj wiersz kodu podobny do tego poniżej za każdym razem, gdy wystąpi zdarzenie. Na przykład te dane niestandardowe zliczają zdarzenia związane z wydajnością, które występują w aplikacji, np. trafienia w pamięci podręcznej lub ponowne próby.
Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();
// Code you want to trace
customTrace.incrementMetric("metric-name", 1);
// More code
await customTrace.stop();
Tworzenie atrybutów niestandardowych dla śladów kodu niestandardowego
Aby używać atrybutów niestandardowych, dodaj do aplikacji kod, który definiuje atrybut i wiąże go z określonym śladem kodu niestandardowego. Atrybut niestandardowy możesz ustawić w dowolnym momencie od rozpoczęcia do zakończenia śledzenia.
Pamiętaj:
Nazwy atrybutów niestandardowych muszą spełniać te wymagania: nie mogą zawierać spacji na początku ani na końcu, nie mogą zaczynać się od podkreślnika (
_) i mogą mieć maksymalnie 32 znaki.Każdy ślad kodu niestandardowego może rejestrować maksymalnie 5 atrybutów niestandardowych.
Nie należy używać atrybutów niestandardowych, które zawierają informacje umożliwiające identyfikację konkretnej osoby.
Trace trace = FirebasePerformance.instance.newTrace("test_trace");
// Update scenario.
trace.putAttribute("experiment", "A");
// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");
// Delete scenario.
trace.removeAttribute("experiment");
// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
Śledzenie, wyświetlanie i filtrowanie danych o skuteczności
Ś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, otwórz panel Skuteczność w konsoli Firebase, a potem kliknij kartę Panel. Kliknij pustą kartę danych, a potem wybierz istniejące dane, które chcesz dodać do tablicy. Na karcie z danymi kliknij pionowy wielokropek (⋮), aby wyświetlić więcej opcji, np. zastąpienia lub usunięcia danych.
Tablica danych pokazuje zebrane dane w czasie w formie graficznej i jako liczbową zmianę procentową.
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 i 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.
Jeśli w tabeli śladów klikniesz nazwę śladu, możesz następnie klikać różne ekrany, aby przejrzeć ślad i wyświetlić szczegółowe dane, które Cię interesują. Na większości stron możesz użyć przycisku Filtruj (w lewym górnym rogu ekranu), aby filtrować dane według atrybutu, np.:
- 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 ma wpływu na określony 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 śledzeniu problemów z wydajnością w konsoli Firebase.
Skonfiguruj alerty dotyczące zmian w kodzie, które pogarszają skuteczność aplikacji. Możesz na przykład skonfigurować alert e-mail dla zespołu, który będzie wysyłany, gdy czas trwania określonego śledzenia niestandardowego kodu przekroczy ustawiony przez Ciebie próg.