Dodawanie niestandardowego monitorowania na potrzeby określonego kodu aplikacji

Monitorowanie wydajności gromadzi ślady, które ułatwiają monitorowanie wydajności aplikacji. Ślad to raport z danymi o wydajności zebranymi w aplikacji między dwoma punktami w czasie.

Możesz tworzyć własne logi czasu, aby monitorować dane o wydajności powiązane z określonym kodem w aplikacji. Za pomocą niestandardowego śledzenia kodu możesz sprawdzić, ile czasu zajmuje aplikacji wykonanie określonego zadania lub zestawu zadań, na przykład wczytanie zestawu obrazów lub wysłanie zapytania do bazy danych.

Domyślnym wskaźnikiem niestandardowego logu czasu jest „czas trwania” (czas między jego punktem początkowym a końcowym). Możesz też dodać dane niestandardowe.

W swoim kodzie definiujesz początek i koniec niestandardowego śledzenia kodu za pomocą interfejsów API udostępnianych przez pakiet SDK Performance Monitoring. Niestandardowe ślady kodu można uruchamiać w dowolnym momencie po utworzeniu i są bezpieczne w wątkach.

Ponieważ domyślne dane zbierane dla tych logów czasu to „czas trwania”, czasami są one nazywane „śladami czasu trwania”.

Dane z tych logów czasu możesz wyświetlić na podkarcie Niestandardowe logi czasu tabeli logów czasu u dołu panelu Wydajność (więcej informacji o korzystaniu z konsoli znajdziesz w dalszej części tej strony).

Atrybuty domyślne, atrybuty niestandardowe i dane niestandardowe

Możesz dodatkowo skonfigurować niestandardowy log czasu śledzenia, aby rejestrować dane niestandardowe dla zdarzeń związanych z wydajnością, które występują w zakresie logu czasu. Możesz np. utworzyć dane niestandardowe obejmujące liczbę trafień i niepowodzeń w pamięci podręcznej lub liczbę przypadków, gdy interfejs użytkownika nie odpowiada przez zauważalny okres.

Niestandardowe atrybuty i dane są wyświetlane w konsoli Firebase wraz z domyślnymi atrybutami i domyślnymi danymi śledzenia.

Dodaj niestandardowe logi czasu kodu

Za pomocą interfejsu Performance Monitoring Trace API (Swift | Obj-C) możesz dodać niestandardowe logi czasu kodu do 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 muszą spełniać te wymagania: nie mogą się pojawiać odstępy na początku ani na końcu, nie mogą występować znaki podkreślenia (_), a maksymalna długość to 100 znaków.
• Niestandardowe logi czasu kodu obsługują dodawanie niestandardowych danych i atrybutów niestandardowych.

Aby rozpocząć i zatrzymać niestandardowy log czasu, opakuj kod, który chcesz śledzić, za pomocą wierszy kodu podobnego do tych:

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Dodawanie niestandardowych wskaźników do niestandardowych logów czasu kodu

Używaj interfejsu Performance Monitoring Trace API (Swift) | Obj-C, aby dodawać niestandardowe dane do niestandardowych logów czasu kodu.

Pamiętaj:

• Nazwy danych niestandardowych muszą spełniać te wymagania: bez znaków odstępu na początku ani na końcu, bez znaku podkreślenia (_) i nie mogą mieć więcej niż 100 znaków.
• Każdy niestandardowy ślad kodu może rejestrować maksymalnie 32 wskaźniki (wliczając domyślne dane Czas trwania).

Aby dodać dane niestandardowe, za każdym razem, gdy wystąpi zdarzenie, dodaj wiersz kodu podobny do tego poniżej. Te dane niestandardowe zliczają na przykład zdarzenia związane z wydajnością, które wystąpiły w aplikacji, takie jak trafienia w pamięci podręcznej lub ponowienia próby.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Tworzenie atrybutów niestandardowych na potrzeby niestandardowych logów czasu

Użyj interfejsu Performance Monitoring Trace API (Swift) | Obj-C, aby dodać atrybuty niestandardowe do niestandardowych logów czasu kodu.

Aby używać atrybutów niestandardowych, dodaj do aplikacji kod, który definiuje atrybut i powiąże go z konkretnym niestandardowym logem czasu w kodzie. Atrybut niestandardowy możesz ustawić w dowolnym momencie między rozpoczęciem śledzenia a jego zatrzymaniem.

Pamiętaj:

• Nazwy atrybutów niestandardowych muszą spełniać te wymagania:

  • Brak odstępu na początku i na końcu, bez znaku podkreślenia (_) na początku i na końcu.
  • Brak pokoi
  • Maksymalna długość to 32 znaki.
  • Dozwolone znaki w nazwie to A-Z, a-z i _.

• Każdy niestandardowy ślad kodu może rejestrować maksymalnie 5 atrybutów niestandardowych.

• Upewnij się, że atrybuty niestandardowe nie zawierają żadnych informacji umożliwiających Google identyfikację osoby.

  Więcej informacji o tych wytycznych

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Śledzenie, wyświetlanie i filtrowanie danych o skuteczności

Śledzenie określonych danych w panelu

Aby poznać trendy dotyczące kluczowych danych, dodaj je do tablicy wskaźników u góry panelu Skuteczność. Możesz szybko wykrywać regresje, analizując zmiany z tygodnia na tydzień lub sprawdzać, czy ostatnie zmiany w kodzie poprawiają wydajność.

Aby dodać wskaźnik do tablicy wskaźników, wykonaj te czynności:

1. W konsoli Firebase otwórz panel Skuteczność.
2. Kliknij pustą kartę wskaźnika, a potem wybierz jeden z istniejących rodzajów danych, który chcesz dodać do swojej tablicy.
3. Kliknij more_vert na karcie wskaźnika, aby wyświetlić więcej opcji, na przykład zastąpić lub usunąć wskaźnik.

Tablica wskaźników pokazuje zebrane dane wskaźników w czasie, zarówno w postaci graficznej, jak i liczbowej zmiany procentowej.

Dowiedz się więcej o korzystaniu z panelu.

Wyświetlanie logów czasu i ich danych

Aby wyświetlić logi czasu, w konsoli Firebase otwórz panel Skuteczność, przewiń w dół do tabeli logów czasu i kliknij odpowiednią podkartę. Tabela zawiera najważniejsze wskaźniki dla każdego logu czasu. Możesz nawet sortować listę według zmiany procentowej dla konkretnego wskaźnika.

Monitorowanie wydajności to strona rozwiązywania problemów w konsoli Firebase, na której możesz sprawdzić zmiany danych. Dzięki temu możesz szybko rozwiązywać problemy z wydajnością i zminimalizować wpływ problemów z wydajnością na Twoje aplikacje i użytkowników. Znajdziesz na niej informacje o potencjalnych problemach z wydajnością, np. w takich sytuacjach:

• Gdy wybierzesz odpowiednie dane na pulpicie, zauważysz sporą różnicę.
• Po posortowaniu tabeli logów czasu największe delta wyświetlają się u góry. Zauważasz znaczną zmianę procentową.
• Otrzymasz e-maila z powiadomieniem o problemie z wydajnością.

Stronę rozwiązywania problemów możesz otworzyć na kilka sposobów:

• W panelu wskaźników kliknij przycisk Wyświetl szczegóły wskaźnika.
• Na dowolnej karcie wskaźnika kliknij more_vert => Wyświetl szczegóły. Na stronie rozwiązywania problemów wyświetlają się informacje o wybranym wskaźniku.
• W tabeli logów czasu kliknij nazwę logu czasu lub dowolną wartość wskaźnika w wierszu, który jest z nim powiązany.
• W powiadomieniu e-mail kliknij Zbadaj teraz.

Po kliknięciu nazwy logu czasu w tabeli logów czasu możesz przeanalizować interesujące Cię wskaźniki. Kliknij przycisk Filtrujadd, aby przefiltrować dane według atrybutu, na przykład:

• Aby wyświetlić dane o poprzedniej lub najnowszej wersji, zastosuj filtrowanie według wersji aplikacji.
• Filtruj według opcji Urządzenie, 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 logów czasu.

Następne kroki

• Dowiedz się więcej o używaniu atrybutów do badania danych o skuteczności.

• Dowiedz się więcej o tym, jak śledzić problemy z wydajnością w konsoli Firebase.

• Skonfiguruj alerty dotyczące zmian w kodzie, które obniżają wydajność aplikacji. Możesz na przykład skonfigurować alert e-mail dla swojego zespołu, jeśli czas trwania określonego niestandardowego śledzenia kodu przekroczy ustawiony próg.

• Wyświetl szczegółowe raporty sesji użytkowników, w których możesz zobaczyć konkretny log czasu w kontekście osi czasu innych logów czasu zebranych podczas tej samej sesji.