Theo dõi lỗi cho Node.js

Trả lời nhanh#

• Dùng SDK chính thức @sentry/node với DSN Belvador của bạn.

• Tuỳ chọn khởi tạo và hook lọc của Belvador bỏ request body, cookie và thông tin đăng nhập trước khi gửi.

• Cron job báo check-in bằng Sentry.withMonitor(), và trace OpenTelemetry liên kết với lỗi.

• Đây là cách cài tương thích: Belvador kiểm thử hook của mình, không kiểm thử bản thân Sentry SDK.

Cài đặt#

npm install @sentry/node@11.9.0 @belvador/core@0.6.1

Tạo instrument.mjs#

import * as Sentry from "@sentry/node";import { scrubBreadcrumb, scrubEvent } from "@belvador/core/sentry";Sentry.init({  dsn: process.env.BELVADOR_DSN ?? "https://<public-key>@ingest.belvador.dev/<project-id>",  release: process.env.APP_VERSION,  environment: process.env.NODE_ENV,  sendDefaultPii: false,  tracesSampleRate: 0,  maxBreadcrumbs: 50,  maxValueLength: 8192,  // Belvador's scrubbing: request bodies, cookies and credentials never leave the app.  beforeSend: scrubEvent,  beforeBreadcrumb: scrubBreadcrumb,});

Nạp file này trước#

node --import ./instrument.mjs server.js

Nạp file này trước app để SDK gắn được vào framework của bạn. Hướng dẫn Node.js giải thích từng tuỳ chọn.

Cách cài này là gì#

Đây là cách cài tương thích, không phải gói của Belvador. Test của Belvador chạy hook lọc trên dữ liệu độc hại, nhưng Belvador không chứng nhận bản thân @sentry/node hay các tích hợp framework của nó. Node của bạn lọc lần nữa trước khi lưu (bảo vệ dữ liệu).

Cron job và worker#

import * as Sentry from "@sentry/node";await Sentry.withMonitor("nightly-invoices", async () => {  // Your job.}, { schedule: { type: "crontab", value: "0 2 * * *" }, timezone: "UTC" });

Job lỗi, chạy quá lâu hoặc không hề bắt đầu sẽ mở sự cố (theo dõi cron).

Trace và log#

Thêm OpenTelemetry Node SDK với OTLP exporter chuẩn; khi dùng chung Sentry và OpenTelemetry, lỗi mang trace id của request nơi lỗi xảy ra (OpenTelemetry cho Node.js).

Đã kiểm ngày 2026-10-24 với node 22.23.4, @opentelemetry/sdk-node 0.300.0, @opentelemetry/auto-instrumentations-node 0.82.0, pino 10.4.0: traces đạt, logs đạt, log mang trace/span của request.

Giới hạn#

• Phiên bản Node.js được hỗ trợ theo bản @sentry/node hiện hành.

• Không có profiling và dashboard hiệu năng; trace được giữ để debug.

Câu hỏi thường gặp#

Trong lúc thử, tôi vẫn gửi sang Sentry được không?#

Được, bằng một SDK client thứ hai hoặc một môi trường thứ hai. Quay lại chỉ là đổi DSN.