Ta strona została przetłumaczona przez Cloud Translation API.

Filtrowanie danych za pomocą atrybutów

Dzięki monitorowaniu wydajności możesz używać atrybutów do segmentowania danych o skuteczności i koncentrowania się na skuteczności aplikacji w różnych realnych sytuacjach.

Po kliknięciu nazwy logu czasu w tabeli logów czasu (u dołu panelu Skuteczność) możesz przejść do interesujących Cię danych. Za pomocą przycisku Filtruj (w lewym górnym rogu ekranu) możesz filtrować dane według atrybutu, na przykład:

obraz przedstawiający dane Monitorowania wydajności Firebase filtrowane według atrybutu

Aby wyświetlić dane na temat konkretnej strony w witrynie, zastosuj filtrowanie według adresu URL strony.
Filtruj według efektywnego typu połączenia, aby zobaczyć, jak połączenie 3G wpływa na Twoją aplikację.
Filtruj według kraju, aby sprawdzić, czy lokalizacja bazy danych nie ma wpływu na konkretny region

Atrybuty domyślne

Monitorowanie wydajności automatycznie zbiera różne atrybuty domyślne w zależności od typu logu czasu.

Oprócz tych atrybutów domyślnych możesz też tworzyć atrybuty niestandardowe w niestandardowych zrzutach kodu, aby dzielić dane na segmenty według kategorii związanych z Twoją aplikacją. Na przykład w grze możesz podzielić dane według jej poziomu.

Domyślne atrybuty zbierane dla aplikacji internetowych

Wszystkie logi czasu aplikacji internetowych domyślnie zbierają te atrybuty:

Przeglądający
Kraj
Efektywny typ połączenia
URL strony
Stan skryptu service worker
Stan widoczności

Zbieranie danych użytkownika

Zbieranie danych użytkowników: Monitorowanie wydajności samo w sobie nie gromadzi żadnych informacji umożliwiających identyfikację, takich jak imiona i nazwiska, adresy e-mail czy numery telefonów. Deweloperzy mogą zbierać dodatkowe dane za pomocą Monitorowania wydajności, tworząc niestandardowe atrybuty w niestandardowych logach czasu kodu. Takie dane zbierane za pomocą Monitorowania wydajności nie powinny zawierać informacji umożliwiających identyfikację osoby.

Oto przykład komunikatu logu, który nie zawiera informacji umożliwiających identyfikację:

trace.putAttribute("experiment", "A");

Oto przykład, który zawiera informacje umożliwiające identyfikację osoby (nie używaj tego typu atrybutu niestandardowego w swojej aplikacji):

trace.putAttribute("email", user.getEmailAddress());

Dane ujawniające informacje umożliwiające identyfikację mogą zostać usunięte bez powiadomienia.

Tworzenie atrybutów niestandardowych

W każdej z instrumentowanych niestandardowych logów czasu możesz tworzyć atrybuty niestandardowe.

Za pomocą interfejsu Performance Monitoring Trace API możesz dodawać niestandardowe atrybuty 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
Zbieranie danych użytkowników: Monitorowanie wydajności samo w sobie nie gromadzi żadnych informacji umożliwiających identyfikację, takich jak imiona i nazwiska, adresy e-mail czy numery telefonów. Deweloperzy mogą zbierać dodatkowe dane za pomocą Monitorowania wydajności, tworząc niestandardowe atrybuty w niestandardowych logach czasu kodu. Takie dane zbierane za pomocą Monitorowania wydajności nie powinny zawierać informacji umożliwiających identyfikację osoby.

Oto przykład komunikatu logu, który nie zawiera informacji umożliwiających identyfikację:
```
trace.putAttribute("experiment", "A");
```
Oto przykład, który zawiera informacje umożliwiające identyfikację osoby (nie używaj tego typu atrybutu niestandardowego w swojej aplikacji):
```
trace.putAttribute("email", user.getEmailAddress());
```
Dane ujawniające informacje umożliwiające identyfikację mogą zostać usunięte bez powiadomienia.

Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();perf_add_custom_attributes.js

Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

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

// Read attributes
const traceAttributes = trace.getAttributes();index.js