Monitorowanie wydajności zbiera ślady, które ułatwiają monitorowanie działania aplikacji. O jest raport zawierający dane dotyczące wydajności zebrane między dwoma punktami w czasie do aplikacji.
Możesz tworzyć własne logi czasu, aby monitorować dane o wydajności powiązane z konkretnego kodu w aplikacji. Za pomocą niestandardowego śledzenia kodu możesz sprawdzić, wykonanie określonego zadania lub zestawu zadań przez aplikację, Wczytanie zbioru obrazów lub wysłanie zapytania do bazy danych.
Domyślnym wskaźnikiem niestandardowego śledzenia kodu jest jego „czas trwania” (czas między punkt początkowy i końcowy śledzenia), ale możesz dodać danych niestandardowych.
Początek i koniec niestandardowego logu czasu w kodzie definiujesz za pomocą interfejsy API udostępniane przez pakiet SDK Performance Monitoring.
Niestandardowe logi czasu kodu można uruchamiać w dowolnym momencie po ich utworzeniu. są bezpieczne dla wątków.
Jako że domyślne dane zbierane dla tych logów czasu to „duration”, są one czasem nazywany „logami czasu trwania”.
Dane z tych logów możesz wyświetlić na podkarcie Niestandardowe logi czasu. znajdującą się u dołu panelu Skuteczność (dowiedz się więcej o za pomocą konsoli na tej stronie).
Atrybuty domyślne, atrybuty niestandardowe i dane niestandardowe
W przypadku niestandardowych logów czasu Monitorowanie wydajności loguje automatycznie atrybuty domyślne (wspólne metadane, np. wersja aplikacji, kraj, urządzenie itp.) Dzięki temu możesz przefiltrować dane logu czasu w konsoli Firebase. Ty może też dodawać i monitorować atrybuty niestandardowe. (np. poziom gry lub właściwości użytkownika).
Możesz dodatkowo skonfigurować niestandardowy log czasu, aby rejestrować danych niestandardowych do zdarzeń związanych ze skutecznością, nie występują w zakresie logu czasu. Możesz np. utworzyć dane niestandardowe o nazwie liczba trafień i braków w pamięci podręcznej lub liczba przypadków, gdy interfejs użytkownika nie odpowiada przez zauważalny okres.
Niestandardowe atrybuty i dane są wyświetlane w konsoli Firebase obok domyślnych atrybutów i domyślnych danych śledzenia.
Dodaj niestandardowe logi czasu kodu
Używanie interfejsu Performance Monitoring Trace API , aby dodać niestandardowe ślady kodu w celu monitorowania konkretnego kodu aplikacji.
Pamiętaj:
- Aplikacja może mieć wiele niestandardowych logów czasu.
- Jednocześnie może być uruchomiony więcej niż 1 niestandardowy log czasu kodu.
- Nazwy niestandardowych logów czasu kodu muszą spełniać te wymagania:
bez spacji na początku ani na końcu, bez znaku podkreślenia (
_), a maksymalna długość to 100 znaków. - Niestandardowe logi czasu obsługują dodawanie niestandardowych danych atrybutów niestandardowych.
Aby rozpocząć i zatrzymać niestandardowy log czasu, opakuj kod, za pomocą którego chcesz śledzić kod podobny do tego:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Dodawanie niestandardowych wskaźników do niestandardowych logów czasu kodu
Używanie interfejsu Performance Monitoring Trace API , aby dodać niestandardowe wskaźniki do niestandardowych logów czasu kodu.
Pamiętaj:
- Nazwy danych niestandardowych muszą spełniać te wymagania:
bez spacji na początku ani na końcu, bez znaku podkreślenia (
_), a maksymalna długość to 100 znaków. - Każdy niestandardowy ślad kodu może rejestrować maksymalnie 32 wskaźniki (w tym domyślne Czas trwania).
Aby dodać dane niestandardowe, dodaj za każdym razem wiersz kodu podobny do tego poniżej zdarzenia zdarzenia. Te dane niestandardowe zliczają np. zdarzeń związanych z wydajnością, które występują w aplikacji, takich jak trafienia w pamięci podręcznej czy ponownych prób.
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 na potrzeby niestandardowych logów czasu
Aby używać atrybutów niestandardowych, dodaj do aplikacji kod, który je definiuje wiąże go z określonym niestandardowym śladem kodu. Możesz określić w dowolnym momencie od rozpoczęcia śledzenia do jego zakończenia.
Pamiętaj:
Nazwy atrybutów niestandardowych muszą spełniać te wymagania: bez spacji na początku ani na końcu, bez znaku podkreślenia (
_), a maksymalna długość to 32 znaki.Każdy niestandardowy ślad kodu może rejestrować maksymalnie 5 atrybutów niestandardowych.
Nie należy używać atrybutów niestandardowych, które zawierają informacje, które identyfikuje osobę fizyczną.
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 określonych danych w panelu
Aby poznać trendy dotyczące kluczowych wskaźników, dodaj je do tablicy wskaźników na u góry panelu Skuteczność. Możesz szybko zidentyfikować regresje, zobaczyć zmiany w skali tygodniowej lub sprawdzić, czy ostatnie zmiany w kodzie na poprawę skuteczności.
Aby dodać rodzaj danych do tablicy wskaźników, otwórz panel Skuteczność. w konsoli Firebase, a następnie kliknij kartę Panel informacyjny. Kliknij pusty wskaźnik a następnie wybierz istniejący wskaźnik, który chcesz dodać do swojej tablicy. Kliknij branżę wielokropek (⋮) na wypełnionej karcie wskaźnika, aby zobaczyć więcej opcji, takich jak zastąpić lub usunąć dane.
Tablica wskaźników przedstawia zebrane dane w postaci graficznej w ujęciu czasowym. i liczbowa zmiana procentowa.
Dowiedz się więcej o korzystaniu z panelu.
Wyświetlanie logów czasu i ich danych
Aby wyświetlić logi czasu, otwórz panel Wydajność w konsoli Firebase przewiń w dół do tabeli logów czasu i kliknij na odpowiedniej podkarcie. Tabela zawiera najważniejsze wskaźniki dla każdego logu czasu, a Ty może nawet sortować listę według zmiany procentowej określonych danych.
Jeśli klikniesz nazwę logu czasu w tabeli logów czasu, możesz kliknąć różnych ekranów, aby zbadać ślad i przeanalizować interesujące Cię dane. Na większości stron możesz użyć przycisku Filtruj (w lewym górnym rogu ekranu), aby filtrować dane według atrybutu, na przykład:
- Aby wyświetlić dane o poprzedniej lub najnowszej wersji aplikacji, zastosuj filtrowanie według wersji aplikacji. wersja produkcyjna
- Filtruj według opcji Urządzenie, aby dowiedzieć się, jak starsze urządzenia obsługują Twoją aplikację
- Przefiltruj listę 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 logów czasu.
Następne kroki
Więcej informacji o za pomocą atrybutów, by analizować dane o skuteczności.
Dowiedz się więcej o tym, śledź problemy ze skutecznością w konsoli Firebase.
Skonfiguruj alerty o zmianach w kodzie, które mogą się pogarszać wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla: Twojego zespołu, jeśli czas trwania niestandardowego śledzenia kodu przekracza wyznaczoną przez Ciebie wartość progową.