@logbrew/sdk0.1.28@logbrew/node0.1.12@logbrew/browser0.1.11
Felder für die Erfassung wählen
Zeichnen Sie für einen fehlgeschlagenen Checkout eine feste Nachricht, eine Routenvorlage und einen Statuscode auf. Zeichnen Sie keine Namen, E-Mail-Adressen oder Zahlungsdaten auf.
Zu Nutzer- und Sitzungskontext lesen Sie
Produktereignisse erfassen.
Eine ID kann eine Person identifizieren, auch wenn sie keinen Namen enthält.
Feldauswahl lokal testen
Verwenden Sie Node.js 18 oder neuer. Installieren Sie das Paket in einem leeren Verzeichnis:safe-capture.mjs:
"ok":false aus und endet mit Code 1.
Ein Validierungsfehler des SDK gibt seinen SDK-Fehlercode aus. Geben Sie
keine Vorschau mit echten Daten aus und laden Sie keine hoch.
Verwenden Sie dasselbe Muster in Ihrem Erfassungscode und behalten Sie die
Assertions in Ihren Tests. Fügen Sie eine Prüfung für jedes Feld und jeden
Wert hinzu, die Ihre App nicht senden darf. Wenn Sie Schwärzung mit Mustern
nutzen, führen Sie die Prüfungen nach jeder Regeländerung erneut aus. Dieser
Test prüft ein Log in der Warteschlange. Er ersetzt keine
Datenschutzprüfung.
Fehlermeldungen und Stacks
Ein eigenes
options.message entfernt metadata.errorMessage nicht. Prüfen
Sie das ganze Ereignis, nicht nur seinen Titel. Halten Sie sensible Werte
schon an der Quelle aus Fehlermeldungen heraus.
Jede Steuerung in ihrem Bereich nutzen
JavaScript-Core und Node.js
LogBrewClient.create nimmt eventFilter an. Geben Sie false zurück, um
ein Ereignis wegzulassen, bevor es in die Warteschlange kommt. Jeder andere
Rückgabewert behält das Ereignis. Der Filter erhält eine Kopie des
Ereignisses. Änderungen daran schwärzen also nichts.
createLogBrewNodeClient und createLogBrewBrowserClient wenden
eventFilter in diesen Versionen nicht an.
droppedEvents() zählt Ereignisse, die wegen Größen- oder
Warteschlangengrenzen verworfen wurden. Ereignisse, die eventFilter
weggelassen hat, zählt es nicht.
Der Node-Client fügt Laufzeitkontext hinzu, zum Beispiel die Node-Version,
das Betriebssystem und die Architektur. Setzen Sie
captureRuntimeContext: false, um ihn wegzulassen. Diese Einstellung
entfernt keinen Kontext, den Ihre App liefert, und stoppt die Erfassung
nicht.
Browser
Der Browser-Client erfasst standardmäßig globale Fehler, unbehandelte Rejections und einen ersten Seitenaufruf. Setzen SiecaptureGlobalErrors,
captureUnhandledRejections oder capturePageViews auf false, um eines
davon auszuschalten.
Seitenaufrufe enthalten den Pfadnamen. Sie lassen Query-String, Fragment,
Dokumenttitel und den vollständigen User-Agent weg, außer Sie setzen
includeQueryString, includeHash, includeDocumentTitle oder
includeUserAgent. Wenn ein Pfadname private Werte enthalten kann, schalten
Sie automatische Seitenaufrufe aus und senden Sie einen eigenen
Seitenaufruf mit einem sicheren Routennamen.
sanitizeMetadata ändert nur Metadaten. Es ändert keine Namen von
Seitenaufrufen oder Aktionen. Der Name eines Seitenaufrufs enthält den
konkreten Pfadnamen, zum Beispiel page_view /orders/1234. Ein
routeTemplate in den Metadaten legt die Oberfläche in den Analysen fest,
ändert aber den Namen nicht. shouldCaptureError lässt nur Issues aus dem
Browser weg. Es filtert keine Logs und keine anderen Signale.
Setzen Sie captureRuntimeContext: false, um Browsermarke, Plattform und
Geräteklasse wegzulassen. Diese Einstellung steuert nicht
includeUserAgent.
Vor der echten Erfassung
Testen Sie jeden aktivierten Erfassungsweg mit synthetischen Daten, auch Fehlerpfade und Logging-Integrationen. Änderungen an der Erfassung gelten nur für neue Ereignisse.purgePendingEvents() leert eine ruhende lokale Warteschlange und schlägt
fehl, solange eine Zustellung läuft. Es stoppt keine spätere Erfassung und
entfernt keine Ereignisse, die LogBrew angenommen hat. uninstall() im
Browser entfernt Listener, behält aber Ereignisse in der Warteschlange.
Diese Methoden sind kein Ablauf für Einwilligung oder Löschung.
Senden Sie dann mit dem Schnellstart ein synthetisches
Ereignis. Wenn es fehlt, lesen Sie Fehlerbehebung.
Zu HTTP-Fehlern lesen Sie API-Fehler.