@logbrew/sdk0.1.28@logbrew/node0.1.12@logbrew/browser0.1.11
Wybierz pola do rejestrowania
Gdy realizacja zakupu się nie powiedzie, zapisz stały komunikat, szablon trasy i kod statusu. Nie zapisuj imion i nazwisk, adresów e-mail ani danych płatniczych.
Kontekst użytkownika i sesji opisuje strona
Rejestrowanie zdarzeń produktowych.
ID może identyfikować osobę, nawet jeśli nie zawiera imienia ani nazwiska.
Przetestuj wybór pól lokalnie
Użyj Node.js 18 lub nowszego. W pustym katalogu zainstaluj pakiet:safe-capture.mjs:
"ok":false i kończy działanie z kodem 1. Błąd
walidacji SDK wypisuje swój kod błędu SDK. Nie wypisuj ani nie przesyłaj
podglądu, który zawiera prawdziwe dane.
Użyj tego samego wzorca w kodzie rejestrowania i zachowaj asercje w testach.
Dodaj sprawdzenie dla każdego pola i każdej wartości, których aplikacja nie
może wysyłać. Jeśli używasz maskowania opartego na wzorcach, uruchom
sprawdzenia ponownie po każdej zmianie reguły. Ten test sprawdza jeden log w
kolejce. Nie zastępuje przeglądu prywatności.
Komunikaty błędów i stosy wywołań
Własne
options.message nie usuwa metadata.errorMessage. Sprawdź całe
zdarzenie, a nie tylko jego tytuł. Usuwaj wrażliwe wartości z komunikatów
błędów już u źródła.
Używaj każdego mechanizmu kontroli tam, gdzie działa
Rdzeń JavaScript i Node.js
LogBrewClient.create przyjmuje eventFilter. Zwróć false, aby pominąć
zdarzenie, zanim trafi do kolejki. Każda inna zwrócona wartość zachowuje
zdarzenie. Filtr dostaje kopię zdarzenia, więc jej zmiany niczego nie
maskują. createLogBrewNodeClient i createLogBrewBrowserClient nie stosują
eventFilter w tych wersjach.
droppedEvents() liczy zdarzenia porzucone z powodu limitów rozmiaru lub
kolejki.
Nie liczy zdarzeń, które pominął eventFilter.
Klient Node dodaje kontekst środowiska uruchomieniowego, taki jak wersja Node,
system operacyjny i architektura. Ustaw captureRuntimeContext: false, aby go
pominąć. To ustawienie nie usuwa kontekstu, który dostarcza aplikacja, i nie
zatrzymuje rejestrowania.
Przeglądarka
Klient przeglądarkowy domyślnie rejestruje błędy globalne, nieobsłużone odrzucenia promise i początkowe wyświetlenie strony. UstawcaptureGlobalErrors, captureUnhandledRejections lub capturePageViews na
false, aby wyłączyć wybrany rodzaj.
Wyświetlenia stron zawierają ścieżkę (pathname). Pomijają parametry zapytania,
fragment, tytuł dokumentu i pełny user agent, chyba że ustawisz
includeQueryString, includeHash, includeDocumentTitle lub
includeUserAgent. Jeśli ścieżka może zawierać prywatne wartości, wyłącz
automatyczne wyświetlenia stron i wysyłaj własne wyświetlenie strony z
bezpieczną nazwą trasy.
sanitizeMetadata zmienia tylko metadane. Nie zmienia nazw wyświetleń stron
ani akcji. Nazwa wyświetlenia strony zawiera konkretną ścieżkę, na przykład
page_view /orders/1234. routeTemplate w metadanych ustawia miejsce
widoczne w sekcji Analityka, ale nie zmienia nazwy. shouldCaptureError pomija
tylko problemy z przeglądarki. Nie filtruje logów ani innych sygnałów.
Ustaw captureRuntimeContext: false, aby pominąć markę przeglądarki,
platformę i rodzinę urządzenia. To ustawienie nie steruje includeUserAgent.
Przed rejestrowaniem prawdziwych danych
Przetestuj każdy włączony sposób rejestrowania na danych syntetycznych, także ścieżki błędów i integracje logów. Zmiany w rejestrowaniu dotyczą tylko nowych zdarzeń.purgePendingEvents()
czyści bezczynną lokalną kolejkę i kończy się błędem, gdy trwa dostarczanie.
Nie zatrzymuje późniejszego rejestrowania ani nie usuwa zdarzeń, które LogBrew
przyjął. Przeglądarkowe uninstall() usuwa listenery, ale zachowuje zdarzenia
w kolejce. Te metody nie są procesem zgody ani usuwania danych.
Potem wyślij jedno syntetyczne zdarzenie według
szybkiego startu. Jeśli go brakuje, zobacz
Rozwiązywanie problemów. Błędy HTTP opisuje
strona Błędy API.