Tuỳ chọn cấu hình SDK

Các tuỳ chọn cho init (trình duyệt, React, phần client của TanStack Start) và cho callback của withBelvador (Cloudflare Workers, phần máy chủ của TanStack Start). Mọi tuỳ chọn trừ dsn đều không bắt buộc. Giá trị không hợp lệ quay về mặc định thay vì ném lỗi.

Tuỳ chọn chung#

beforeSend và beforeBreadcrumb chạy trước bước lọc bắt buộc của Belvador, nên không thể thêm dữ liệu mà bộ lọc sẽ xoá. Nếu hook ném lỗi hoặc promise bị từ chối, event hoặc breadcrumb đó bị bỏ.

init({  dsn: "https://<public-key>@ingest.belvador.dev/<project-id>",  release: import.meta.env.VITE_APP_VERSION,  environment: import.meta.env.MODE,  sampleRate: 1,  ignoreErrors: ["ResizeObserver loop completed with undelivered notifications"],  beforeSend(event) {    // Bỏ lỗi từ công cụ quản trị nội bộ.    if (event.request?.url?.includes("/internal-admin/")) return null;    return event;  },});

Breadcrumb#

Breadcrumb là các bước trước khi lỗi xảy ra. Breadcrumb tự động tắt trong SDK của Belvador: chúng ghi lại người dùng bấm gì và gọi URL nào, có thể chứa dữ liệu cá nhân. Chỉ bật những gì bạn cần.

Trình duyệt (@belvador/browser, @belvador/react, client của TanStack Start):

init({  dsn: "https://<public-key>@ingest.belvador.dev/<project-id>",  instrument: { console: true, dom: true, fetch: true, xhr: true, history: true },});

Workers (callback của withBelvador): instrument: { console: true, fetch: true }.

Breadcrumb bạn tự thêm bằng addBreadcrumb luôn được ghi, không cần tuỳ chọn nào.

Tuỳ chọn chỉ có trên trình duyệt#

Hành vi riêng của Workers#

Callback của withBelvador trả về các tuỳ chọn như trên nhưng dsn không bắt buộc, thêm instrument: { console, fetch }. Giá trị không trả về sẽ lấy từ biến của Worker:

Belvador cố định#

Những điều sau không đổi được, để SDK chỉ gửi lỗi và không bao giờ tự thêm dữ liệu cá nhân:

• dữ liệu cá nhân do SDK tự thêm (sendDefaultPii) luôn tắt;

• tracing, session replay, log và profiling tắt, dữ liệu của chúng bị bỏ;

• không tunnel, không Spotlight, không tích hợp mặc định ngoài những gì Belvador thiết lập;

• chuỗi bị cắt ở 8.192 ký tự.

Cách gửi#

Khi trang đang đóng, SDK gửi bằng keepalive trong giới hạn của trình duyệt (tối đa 60.000 byte, 15 request cùng lúc). Event không vừa, hoặc còn chờ lúc trang đóng, sẽ bị mất — trừ khi offline: true giữ chúng cho lần tải sau.