在 Bun 應用中新增 Sentry

Sentry 是一個錯誤跟蹤和效能監控平臺。其 Bun SDK @sentry/bun 可以為你的應用新增檢測功能，自動收集錯誤和效能資料。

如果你還沒有 Sentry 賬戶和專案，請在 sentry.io 建立一個，然後傳回此頁面。

首先，安裝 Sentry Bun SDK。

terminal

bun add @sentry/bun

然後在單獨的檔案中使用你的 Sentry DSN 初始化 SDK。你可以在 Sentry 專案設定中找到你的 DSN。

sentry.ts

import * as Sentry from "@sentry/bun";

// 確保在匯入任何其他模組之前呼叫此方法！
Sentry.init({
  dsn: "__SENTRY_DSN__",

  // 通過設定 tracesSampleRate 新增效能監控
  // 我們建議在生產環境中調整該值
  tracesSampleRate: 1.0,
});

使用 --preload 啟動你的應用，以便此檔案在應用的任何模組之前執行。Bun 會在執行檔案自身的程式碼之前計算該檔案中的 import，因此在入口檔案頂部呼叫 Sentry.init()，仍會在該檔案匯入的所有內容之後執行。

terminal

bun --preload ./sentry.ts index.ts

通過捕獲測試錯誤來驗證 Sentry 是否正常工作：

sentry.ts

setTimeout(() => {
  try {
    foo();
  } catch (e) {
    Sentry.captureException(e);
  }
}, 99);

要檢視並解決記錄的錯誤，請登入 sentry.io，然後開啟你的專案。點選錯誤標題即可開啟詳情頁面，你可以在該頁面將錯誤標記為已解決。

如需詳細瞭解 Sentry Bun SDK，請參閱 Sentry 文件。