@logbrew/sdk0.1.28@logbrew/node0.1.12@logbrew/browser0.1.11
Chọn trường để ghi nhận
Với một lần thanh toán thất bại, ghi lại một thông điệp cố định, một mẫu route và một mã trạng thái. Không ghi lại tên, địa chỉ email hoặc dữ liệu thanh toán.
Về ngữ cảnh người dùng và phiên, xem
Ghi nhận sự kiện sản phẩm.
Một ID vẫn có thể nhận diện một người dù ID đó không chứa tên.
Kiểm tra việc chọn trường trên máy cục bộ
Dùng Node.js 18 trở lên. Trong một thư mục trống, cài gói:safe-capture.mjs:
"ok":false và thoát với mã 1. Lỗi kiểm tra hợp lệ của
SDK sẽ in mã lỗi SDK tương ứng. Không in hoặc tải lên bản xem trước có chứa dữ
liệu thật.
Dùng cùng cách làm này trong mã ghi nhận của bạn, và giữ các assertion trong bộ
kiểm thử. Thêm một bước kiểm tra cho mỗi trường và giá trị mà ứng dụng không
được gửi. Nếu bạn che dữ liệu dựa trên pattern, chạy lại các bước kiểm tra sau
mỗi lần đổi quy tắc. Bài kiểm tra này chỉ kiểm tra một log trong hàng đợi. Nó
không thay thế việc rà soát quyền riêng tư.
Thông điệp lỗi và dấu vết ngăn xếp (stack trace)
options.message tùy chỉnh không xóa metadata.errorMessage. Kiểm tra toàn bộ
sự kiện, không chỉ tiêu đề. Loại bỏ giá trị nhạy cảm khỏi thông điệp lỗi ngay
từ nơi tạo ra thông điệp.
Dùng mỗi tùy chọn kiểm soát trong đúng phạm vi của nó
JavaScript core và Node.js
LogBrewClient.create nhận eventFilter. Trả về false để bỏ một sự kiện
trước khi sự kiện vào hàng đợi. Mọi giá trị trả về khác đều giữ sự kiện. Bộ lọc
nhận một bản sao của sự kiện, nên việc sửa bản sao không che được gì. createLogBrewNodeClient và
createLogBrewBrowserClient không áp dụng eventFilter trong các phiên bản
này.
droppedEvents() đếm các sự kiện bị loại bỏ do giới hạn kích thước hoặc giới
hạn hàng đợi. Hàm này không đếm các sự kiện mà eventFilter đã bỏ.
Client Node thêm ngữ cảnh runtime, như phiên bản Node, hệ điều hành và kiến
trúc. Đặt captureRuntimeContext: false để bỏ ngữ cảnh này. Cài đặt này không
xóa ngữ cảnh do ứng dụng cung cấp và không dừng việc ghi nhận.
Trình duyệt
Theo mặc định, client trình duyệt ghi nhận lỗi toàn cục, promise rejection chưa xử lý và một lượt xem trang ban đầu. ĐặtcaptureGlobalErrors,
captureUnhandledRejections hoặc capturePageViews thành false để tắt từng
loại.
Lượt xem trang có pathname. Lượt xem trang không có query string, fragment,
tiêu đề tài liệu và toàn bộ user agent, trừ khi bạn đặt includeQueryString,
includeHash, includeDocumentTitle hoặc includeUserAgent. Nếu pathname có
thể chứa giá trị riêng tư, tắt lượt xem trang tự động và tự gửi lượt xem trang
với tên route an toàn.
sanitizeMetadata chỉ thay đổi metadata. Hàm này không đổi tên lượt xem trang
hoặc tên hành động. Tên lượt xem trang chứa pathname cụ thể, như
page_view /orders/1234. routeTemplate trong metadata đặt trang hoặc màn hình
mà Phân tích hiển thị, nhưng không đổi tên sự kiện. shouldCaptureError chỉ bỏ các vấn đề của trình duyệt. Hàm này không
lọc log hoặc các tín hiệu khác.
Đặt captureRuntimeContext: false để bỏ thương hiệu trình duyệt, nền tảng và
dòng thiết bị. Cài đặt này không điều khiển includeUserAgent.
Trước khi ghi nhận dữ liệu thật
Kiểm tra từng cách ghi nhận đã bật bằng dữ liệu giả lập, kể cả các nhánh xử lý lỗi và các tích hợp ghi log. Thay đổi về ghi nhận chỉ áp dụng cho sự kiện mới.purgePendingEvents() xóa
hàng đợi cục bộ đang rảnh và thất bại khi việc gửi đang diễn ra. Hàm này không
dừng việc ghi nhận về sau và không xóa các sự kiện mà LogBrew đã chấp nhận. uninstall() của trình duyệt gỡ các listener nhưng vẫn giữ
các sự kiện trong hàng đợi. Các phương thức này không phải là quy trình xin đồng
ý hoặc xóa dữ liệu.
Sau đó, gửi một sự kiện giả lập theo hướng dẫn
Bắt đầu nhanh.
Nếu không thấy sự kiện, xem Khắc phục sự cố. Với
lỗi HTTP, xem Lỗi API.