使用 Sentry 進行錯誤追蹤
INFO
Sentry 會捕獲 JavaScript 應用程式中未處理的例外、未處理的 Promise 拒絕,以及手動回報的錯誤,將它們分群為 Issue,透過已上傳的 source map 解析堆疊追蹤,並將每個 Issue 與引入它的 Release 及提交關聯起來。本文涵蓋 React、Vue 與純 JavaScript 的 SDK 設定;用於在雜訊耗盡事件配額前過濾雜訊的 beforeSend 與 ignoreErrors 模式;用於分診的使用者情境與麵包屑;透過建置插件與 sentry-cli 上傳 source map;以及將分群後的 Issue 轉為通知的警示規則。每個程式碼範例都以目前的 SDK 為準,並非虛擬碼。
背景脈絡
每一個 JavaScript 應用程式都會在正式環境中拋出例外。DOM 操作與網路回應之間存在競爭條件、第三方腳本干擾全域狀態、舊版瀏覽器對規範的解讀各有差異,而使用者也總能找到開發者未曾預料的操作路徑。無論團隊是否密切監控,這些例外都會發生。
若沒有適當的監控工具,錯誤就是隱形的。使用者遇到空白畫面、關掉分頁、繼續下一件事。團隊只有在使用者主動發出客服工單、且工單被路由到工程部門時,才能得知問題的存在。大多數使用者不會填寫工單,因此團隊會誤以為系統一切正常,因為沒有收到任何損壞回報。
錯誤追蹤填補了這個缺口。嵌入應用程式中的 SDK 會捕獲每一個未處理的例外、未處理的 Promise 拒絕、網路失敗,以及手動回報的錯誤。每個事件都附帶堆疊追蹤(stacktrace)、瀏覽器與作業系統指紋、導致錯誤的麵包屑序列,以及可選的已登入使用者身份資訊。這些事件會傳送到一個平台,該平台按根本原因將事件分群、追蹤頻率變化,並在超過閾值時觸發警示。
Sentry 是這個領域中廣泛使用的平台。它於 2008 年以 django-db-log(David Cramer 為 Django 專案撰寫的開源錯誤記錄器)起家,後來發展成本文範例所使用的全端錯誤追蹤平台;其背後的公司 Functional Software, Inc. 於 2012 年成立。其功能集包括:
- 開源起源與自架選項。 核心平台為開源(sentry.io/from-source)。對資料所在地有嚴格要求的團隊可在自有基礎設施上運行完整平台。大多數團隊使用托管雲端版本,但開源選項消除了供應商鎖定的風險。
- 內建於 SDK 工作流程的 Source Map 支援。 官方的 Vite、webpack 和 Rollup 插件會在建置步驟中自動上傳 source map,讓壓縮後的堆疊追蹤無需手動上傳步驟即可還原為原始碼位置。
- 豐富的 SDK 生態系統。 所有主流框架都有官方 SDK:
@sentry/react、@sentry/vue、@sentry/angular、@sentry/svelte、@sentry/browser(純 JS)、@sentry/node(Node.js 伺服器端),以及@sentry/nextjs(Next.js 全端專案)。 - Issue 生命週期管理。 Sentry 將每個分群的錯誤視為具有明確生命週期的 Issue:新建、已看見、已忽略、已解決。版本追蹤功能可顯示已解決的 Issue 是否在後續部署中重現。
完整的 Sentry 工作流程涵蓋 SDK 初始化、source map 上傳、麵包屑、使用者情境、版本追蹤、雜訊過濾與警示設定。Source map 上傳與版本追蹤同時也是 FEE-1402 與 FEE-1407 中 RUM 與 Session Replay 工作流程的前提條件。
設計思維
選擇錯誤追蹤平台
這個領域有多個平台可供選擇,包括 Datadog RUM、Rollbar、Bugsnag、LogRocket 與 Highlight。本文以 Sentry 作為範例平台,但無論團隊評估哪個平台,都有三項能力值得檢查:
Source map 上傳整合至建置工具。 能在建置期間自動上傳 source map 的插件(@sentry/vite-plugin、@sentry/webpack-plugin,或其他平台的對應方案),能將手動且容易出錯的上傳步驟,簡化為單一的建置設定項目。
自架或地端部署選項。 有資料主權要求、GDPR 義務,或安全審查流程限制第三方資料共享的團隊,需要能在自有基礎設施上運行的平台,而不只是 SaaS 產品。
版本與提交的關聯性。 若平台能將每次部署與提交範圍建立關聯,並回報哪些 Issue 在該 Release 中出現或重現,工程師就能直接問「哪個版本引入了這個錯誤?」,而不必手動交叉比對錯誤峰值與部署記錄。
為何 source map 必須在 CI 中上傳,而非提交至版本庫
Source map 包含你的原始程式碼。從 TypeScript 檔案生成的 source map 包含 TypeScript 原始碼,包括變數名稱、註解、內部 API 路徑,以及沒有理由對外公開的商業邏輯。將 source map 提交至版本庫並在 CDN 上提供服務,等同於在已編譯輸出旁邊公開你的源碼。
正確的做法是:
- 在 CI 中建置應用程式,產生
.js和.js.map檔案。 - 透過插件或
sentry-cli將.map檔案上傳至 Sentry。 - 從建置輸出中刪除
.map檔案。 - 將
.js檔案(不含.map檔案)部署至 CDN。
Sentry 在伺服器端使用已上傳的 source map 解析堆疊追蹤。可讀的堆疊追蹤只對你的 Sentry 組織的已驗證成員可見。公開套件中不包含任何 source map 參考。
為何 beforeSend 是必要的
一個在正式環境中剛完成監控部署的應用程式,通常會產生遠超預期的事件量。主要的雜訊來源有:
- 瀏覽器擴充功能。 廣告攔截器、密碼管理器、無障礙工具和開發者擴充功能都在頁面情境中運行 JavaScript。它們拋出的例外會出現在你的
window.onerror處理器中,並被回報至 Sentry,彷彿是你的錯誤。 - 第三方腳本的未處理 Promise 拒絕。 分析標籤、A/B 測試平台和客服聊天工具通常會附著在頁面上,並從它們自己的網路程式碼中產生未處理的拒絕。
- 使用者連線造成的網路錯誤。 在不穩定行動連線上的使用者,如果在會話中途失去連線,會產生源自使用者網路、團隊無法採取行動的
TypeError: Failed to fetch事件。 - 已知的良性錯誤。 部分瀏覽器在正常運作中會拋出
"ResizeObserver loop limit exceeded"或"Script error."(無有用細節的跨來源腳本錯誤)。
廣告攔截器也會從另一個方向影響事件:許多攔截器會封鎖對 *.ingest.sentry.io 的請求,因為該網域符合常見的廣告追蹤器封鎖清單樣式,導致使用廣告攔截器的使用者所產生的事件根本無法離開瀏覽器。Sentry.init() 中的 tunnel 選項會將事件透過同源路徑傳送,再由你自己的伺服器或邊緣代理轉發至 Sentry,藉此完全避開該封鎖清單的比對。
若不進行過濾,這些事件會淹沒 Issue 追蹤器,埋葬真正的錯誤,並耗盡事件配額。beforeSend 是 Sentry.init() 中在每個事件發送前執行的回呼函式。它可以檢查事件並返回 null 以丟棄它,或在發送前修改事件。一個設定良好的 beforeSend 能過濾掉大部分來自擴充功能、第三方腳本與良性瀏覽器怪癖的雜訊,讓真正的錯誤不被埋沒,事件配額也不會被沒有人會處理的事件耗盡。
為何版本追蹤改變了除錯工作
診斷通常是事故應對中最耗時的部分。「哪一行壞了?」可以用堆疊追蹤回答。「這是什麼時候開始壞的?」需要將錯誤頻率的時間變化與部署時間戳進行關聯。「哪次部署引入了這個問題?」需要手動交叉比對錯誤峰值與部署記錄。
版本追蹤會自動回答後兩個問題。當一個 Release 被建立並關聯了提交記錄後,平台可以顯示:
- 該 Release 中部署的確切提交範圍。
- 哪些 Issue 在這個 Release 中首次出現。
- 哪些先前已解決的 Issue 在這個 Release 中重現。
- 負責引入新 Issue 的提交的團隊成員。
工程師看到錯誤、看到它出現在 Release 1.4.7 中、點擊進入提交範圍,並在幾分鐘內找出有問題的變更。
最佳實踐
必須(MUST)在應用程式進入點的最前面初始化 Sentry SDK,優先於任何可能拋出例外的其他匯入。 在框架初始化之後才呼叫 Sentry.init() 會導致早期啟動階段的錯誤完全無法被捕獲。團隊必須(MUST)確保在進入點檔案中,Sentry.init() 先於任何框架設定匯入執行。
禁止(MUST NOT)將 source map 提交至公開套件或從 CDN 提供服務。 Source map 包含原始 TypeScript 原始碼,包括變數名稱、內部 API 路徑和商業邏輯。團隊必須(MUST)在 CI 建置步驟中使用官方 Vite 或 webpack 插件將 .map 檔案上傳至 Sentry,然後在 CDN 部署前刪除這些 .map 檔案,確保它們不會出現在公開套件中。
必須(MUST)設定 beforeSend 以在事件到達 Sentry 前過濾雜訊。 若不進行過濾,瀏覽器擴充功能錯誤、第三方腳本拒絕和瀏覽器良性怪癖會在新的正式環境部署後數天內耗盡事件配額。團隊必須(MUST)在上線前設定 beforeSend,並應該(SHOULD)同時使用 ignoreErrors 處理已知的良性模式,例如 "Script error." 和 "ResizeObserver loop limit exceeded"。
應該(SHOULD)在 Sentry.init() 中設定 release 並為每次正式部署關聯提交記錄。 沒有 Release 識別符,平台就無法回答「哪次部署引入了這個錯誤?」這個問題。Release 字串應該(SHOULD)在 CI 建置時作為環境變數注入(例如 VITE_RELEASE=$(git rev-parse --short HEAD)),以確保在 Sentry.init() 和建置插件設定中使用相同的值。
應該(SHOULD)在登入成功後立即呼叫 Sentry.setUser(),並在登出時呼叫 Sentry.setUser(null)。 附加使用者情境能讓團隊篩選所有影響特定使用者的錯誤並主動聯繫受影響使用者。團隊應該(SHOULD)只記錄不透明的內部使用者 ID,絕不使用電子郵件地址或真實姓名,以避免在 Sentry 平台上產生 GDPR 資料保留義務。
必須(MUST)在 Sentry.init() 中設定 enabled: import.meta.env.PROD 以防止開發工作階段消耗事件配額。 開發流量對正式環境事故沒有診斷價值,卻會消耗與真實錯誤相同的配額。團隊必須(MUST)透過環境旗標閘控初始化,確保 Sentry 只在正式環境中發送事件,因為設定錯誤的本地環境可能在數小時內耗盡月度配額。
應該(SHOULD)以錯誤率而非原始錯誤計數設定告警規則。 原始計數閾值在每次流量高峰時都會觸發,無論應用程式是否真的壞了。團隊應該(SHOULD)設定快速燃燒告警(錯誤率 > 2% 持續 10 分鐘)和迴歸告警(已解決的 Issue 在新 Release 中重現),每條告警均附上 runbook URL。
視覺化
錯誤捕獲與處理流程
下圖展示了從 JavaScript 例外到可行動警示的完整路徑。Sentry 的 SDK 在拋出點攔截錯誤,附加整個會話中收集到的麵包屑和使用者情境,將事件傳送至平台,平台再應用已上傳的 source map 產生可讀的堆疊追蹤,最後將事件與具有相同指紋的其他事件進行分群。
範例
SDK 設定:React
安裝 SDK 並在應用程式渲染前進行初始化。dsn(資料來源名稱)是在 Sentry 專案設定中找到的專案專屬 URL。它可以安全地提交:它識別專案,但不授予對 Issue 資料的寫入權限。
npm install @sentry/react// src/main.tsx
import * as Sentry from "@sentry/react";
import { createRoot } from "react-dom/client";
import App from "./App";
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
environment: import.meta.env.MODE, // "production" | "staging" | "development"
release: import.meta.env.VITE_RELEASE, // 由 CI 注入,例如 "1.4.7"
// 這兩個整合預設皆未啟用。若未在此列出,
// 下方的取樣率設定將不會生效。
integrations: [
Sentry.browserTracingIntegration(),
Sentry.replayIntegration(),
],
tracesSampleRate: 0.1, // 10% 的交易用於效能監控
replaysSessionSampleRate: 0.05, // 5% 的會話用於 Session Replay
replaysOnErrorSampleRate: 1.0, // 包含錯誤的會話 100% 錄製
beforeSend(event) {
// 丟棄來自瀏覽器擴充功能的事件(非從你的來源載入的腳本)
const frames = event.exception?.values?.[0]?.stacktrace?.frames ?? [];
const hasExtensionFrame = frames.some(
(f) =>
f.filename?.startsWith("chrome-extension://") ||
f.filename?.startsWith("moz-extension://")
);
if (hasExtensionFrame) return null;
// 丟棄通用網路錯誤——無法採取行動
const message = event.exception?.values?.[0]?.value ?? "";
if (message === "TypeError: Failed to fetch") return null;
if (message.includes("ResizeObserver loop")) return null;
return event;
},
ignoreErrors: [
"Script error.", // 無細節的跨來源腳本錯誤
/^Non-Error exception captured/, // Sentry SDK 內部:非 Error 物件被拋出
],
});
const root = createRoot(document.getElementById("root")!);
root.render(<App />);SDK 設定:Vue
npm install @sentry/vue// src/main.ts
import { createApp } from "vue";
import { createRouter } from "vue-router";
import * as Sentry from "@sentry/vue";
import App from "./App.vue";
import router from "./router";
const app = createApp(App);
Sentry.init({
app,
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
environment: import.meta.env.MODE,
release: import.meta.env.VITE_RELEASE,
integrations: [
Sentry.browserTracingIntegration({ router }),
],
tracesSampleRate: 0.1,
beforeSend(event) {
const message = event.exception?.values?.[0]?.value ?? "";
if (message === "TypeError: Failed to fetch") return null;
return event;
},
});
app.use(router);
app.mount("#app");SDK 設定:純 JavaScript
對於沒有框架的專案,直接使用 @sentry/browser。
npm install @sentry/browserimport * as Sentry from "@sentry/browser";
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
environment: process.env.NODE_ENV,
release: process.env.RELEASE_VERSION,
integrations: [Sentry.browserTracingIntegration()], // 預設未啟用
beforeSend(event) {
const message = event.exception?.values?.[0]?.value ?? "";
if (message === "TypeError: Failed to fetch") return null;
return event;
},
});設定使用者情境
在登入成功後立即呼叫 Sentry.setUser()。這會將後續所有錯誤事件與已驗證的使用者關聯,讓你可以搜尋「所有影響使用者 X 的錯誤」,並主動聯繫受影響的使用者。只傳送不透明的識別符,例如內部使用者 ID 或角色;請勿傳送電子郵件地址或真實姓名,否則會在 Sentry 內部產生 GDPR 資料保留義務。
// src/auth/authService.ts
import * as Sentry from "@sentry/react";
export function onLoginSuccess(user: { id: string; role: string }) {
// 只使用 id 與 role。刻意省略電子郵件與真實姓名,
// 以避免在 Sentry 中產生 GDPR 資料保留義務。
Sentry.setUser({
id: user.id,
role: user.role,
});
}
export function onLogout() {
// 清除使用者情境,避免後續事件被歸因於前一位使用者
Sentry.setUser(null);
}自訂麵包屑
Sentry 會自動為 DOM 點擊、XHR 和 fetch 請求、console.log 呼叫,以及瀏覽器導航事件收集麵包屑。對於不會自動產生麵包屑的應用程式層級事件(例如使用者在多步驟表單中前進、收到 WebSocket 訊息、評估 Feature Flag),請手動添加。
import * as Sentry from "@sentry/react";
function handleCheckoutStep(step: string) {
Sentry.addBreadcrumb({
category: "checkout",
message: `使用者前進到步驟:${step}`,
level: "info",
data: {
step,
timestamp: Date.now(),
},
});
// ... 繼續結帳邏輯
}手動捕獲錯誤
對於已捕獲但不想重新拋出的例外:
import * as Sentry from "@sentry/react";
async function loadUserProfile(userId: string) {
try {
const response = await fetch(`/api/users/${userId}`);
if (!response.ok) {
throw new Error(`載入 ${userId} 的個人資料時發生 HTTP ${response.status}`);
}
return await response.json();
} catch (error) {
Sentry.captureException(error, {
tags: { feature: "user-profile" },
extra: { userId },
});
return null; // 優雅降級
}
}對於非例外的資訊性訊息:
Sentry.captureMessage("收到包含未預期貨幣的付款 Webhook", "warning");使用 ErrorBoundary 捕獲渲染錯誤
在 React 渲染過程中拋出的錯誤,若沒有 React 錯誤邊界先行攔截,會導致元件樹被卸載。@sentry/react 匯出了 Sentry.ErrorBoundary,這個元件會將錯誤連同 React 元件堆疊回報至 Sentry,在失敗的子樹位置渲染備援 UI,並隔離該失敗,使樹的其餘部分不會被卸載。
import * as Sentry from "@sentry/react";
function ErrorFallback() {
return <p>發生錯誤,團隊已收到通知。</p>;
}
function Dashboard() {
return (
<Sentry.ErrorBoundary fallback={<ErrorFallback />} showDialog>
<WidgetGrid />
</Sentry.ErrorBoundary>
);
}請將 ErrorBoundary 包在頁面中可獨立失敗的區域,例如單一小工具或單一路由,而不是整個應用程式。放在根層級的邊界,會讓任何渲染錯誤變成整頁空白,而非隔離的局部失敗。
Source Map 上傳:Vite 插件
@sentry/vite-plugin 套件將 source map 上傳作為 Vite 建置流程的一部分處理。它在建置完成後將 source map 上傳至 Sentry,然後從輸出目錄中刪除它們。
npm install @sentry/vite-plugin --save-dev// vite.config.ts
import { defineConfig } from "vite";
import { sentryVitePlugin } from "@sentry/vite-plugin";
export default defineConfig({
build: {
sourcemap: true, // 必須啟用,插件才能找到 source map
},
plugins: [
sentryVitePlugin({
org: "your-sentry-org-slug",
project: "your-sentry-project-slug",
authToken: process.env.SENTRY_AUTH_TOKEN, // 設定於 CI 密鑰中,絕不寫死
release: {
name: process.env.VITE_RELEASE, // 與注入 Sentry.init() 的值相同
deploy: {
env: process.env.NODE_ENV ?? "production",
},
},
sourcemaps: {
// 上傳建置輸出中的所有 .map 檔案
assets: "./dist/**",
// 上傳後刪除 .map 檔案,使其不被部署至 CDN
filesToDeleteAfterUpload: "./dist/**/*.map",
},
}),
],
});SENTRY_AUTH_TOKEN 是在 Sentry 專案設定中建立的內部整合 Token(設定 > Auth Tokens)。它對指定組織的 Release 和 source map 具有寫入權限。請將其儲存為 CI 密鑰(GitHub Actions secret、GitLab CI 變數等)。絕不提交至版本庫。
Source Map 上傳:webpack
對於基於 webpack 的專案(Create React App、自訂 webpack 設定):
npm install @sentry/webpack-plugin --save-dev// webpack.config.js
const { sentryWebpackPlugin } = require("@sentry/webpack-plugin");
module.exports = {
devtool: "source-map",
plugins: [
sentryWebpackPlugin({
org: "your-sentry-org-slug",
project: "your-sentry-project-slug",
authToken: process.env.SENTRY_AUTH_TOKEN,
release: {
name: process.env.RELEASE_VERSION,
},
sourcemaps: {
assets: "./build/**",
filesToDeleteAfterUpload: "./build/**/*.map",
},
}),
],
};透過 sentry-cli 進行版本追蹤
對於偏好將部署步驟作為 Shell 命令管理的團隊,sentry-cli 提供了相同的功能。這種模式在已將部署步驟管理為 Shell 命令的 Pipeline 中很常見。
# 安裝 sentry-cli
npm install -g @sentry/cli
# 建立 Release
sentry-cli releases new "$RELEASE_VERSION"
# 為每個建置後的 .js 檔案及其 .js.map 標記 debug ID,
# 讓 Sentry 無需 --url-prefix 即可將堆疊訊框比對至對應的 source map
sentry-cli sourcemaps inject ./dist
# 上傳已標記的 source map
sentry-cli sourcemaps upload ./dist --release "$RELEASE_VERSION"
# 關聯提交記錄(需要在 Sentry 中設定版本庫整合)
sentry-cli releases set-commits "$RELEASE_VERSION" --auto
# 完成 Release
sentry-cli releases finalize "$RELEASE_VERSION"
# 標記 Release 為已部署
sentry-cli releases deploys "$RELEASE_VERSION" new -e productionsourcemaps inject 透過 debug ID 將堆疊訊框比對至對應的 source map,這與上方 Vite 及 webpack 插件所使用的機制相同,因此一旦 source map 完成標記,就不再需要依賴檔名或 URL 前綴比對。
CI Pipeline 整合(GitHub Actions)
# .github/workflows/deploy.yml
name: Deploy
on:
push:
branches: [main]
jobs:
build-and-deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0 # sentry-cli 提交關聯需要完整歷史
- uses: actions/setup-node@v4
with:
node-version: "20"
- run: npm ci
- name: 設定 Release 版本
run: echo "VITE_RELEASE=$(git rev-parse --short HEAD)" >> $GITHUB_ENV
- name: 建置(透過 Vite 插件上傳 source map,然後刪除 .map 檔案)
run: npm run build
env:
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
VITE_RELEASE: ${{ env.VITE_RELEASE }}
- name: 部署至 CDN
run: |
# 此時 ./dist 包含 .js 檔案但沒有 .map 檔案
# (Vite 插件在上傳後已將其刪除)
aws s3 sync ./dist s3://your-bucket/static/
env:
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}警示規則
在 Sentry 的專案設定中,警示規則定義了何時以及向哪裡發送通知。正式環境前端的基線警示設定:
| 規則 | 條件 | 動作 |
|---|---|---|
| 新 Issue 警示 | 建立了新 Issue | Slack #frontend-alerts |
| 錯誤峰值 | 5 分鐘內錯誤數 > 100 | Slack #frontend-alerts + PagerDuty |
| 迴歸警示 | 已解決的 Issue 在新 Release 中重現 | Slack #frontend-alerts |
| 高優先級使用者影響 | 錯誤影響 > 50 位獨立使用者 | Slack #frontend-on-call |
Sentry 也與 GitHub 整合以自動為新錯誤建立 Issue,並與 Jira 整合以將 Sentry Issue 連結至 Sprint 工作項目。
常見錯誤
使用 console.error 代替 Sentry.captureException
console.error 寫入瀏覽器控制台,對錯誤追蹤而言是不可見的。在 catch 區塊中用 console.error 記錄的已捕獲例外,在正式環境中會靜默消失。任何值得記錄的已捕獲例外,都值得回報至 Sentry。將 catch 區塊中的 console.error(err) 替換為 Sentry.captureException(err),並接以優雅降級邏輯。
在非正式環境中取樣
在開發環境中設定 tracesSampleRate: 1.0 會用本地開發會話的事件淹沒平台。請始終根據環境設定 DSN 和取樣率。常見的做法是只在 import.meta.env.MODE === "production" 時呼叫 Sentry.init(),或在 init 設定中設定 enabled: import.meta.env.PROD。
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
enabled: import.meta.env.PROD, // 在開發或測試環境中不發送事件
tracesSampleRate: 0.1,
});不將提交記錄與 Release 關聯
沒有提交關聯的版本追蹤可以顯示哪個 Release 引入了錯誤,但無法顯示是哪個提交或作者。透過在你的組織中安裝 Sentry GitHub / GitLab 整合,並向 sentry-cli releases set-commits 傳遞 --auto(或在 Vite 插件設定中啟用自動關聯)來啟用提交關聯。這需要 CI 工作流程中的 actions/checkout 以 fetch-depth: 0 執行。
相關 FEE
- FEE-1400:可觀測性與錯誤追蹤概觀 — 類別情境與前端可觀測性的三大支柱
- FEE-1402:真實使用者監控與 Core Web Vitals — 從真實使用者捕獲效能指標,以補充錯誤資料
- FEE-1403:日誌記錄與結構化日誌 — 結構化日誌透過 traceId 補充 Sentry 錯誤事件,用於業務層級稽核追蹤與關聯
- FEE-1405:功能旗標可觀測性與 A/B 測試 — 將 Feature Flag 情境附加至錯誤事件,以將錯誤與 Flag 變體相關聯
- FEE-1406:告警、儀表板與服務等級目標 — 錯誤預算與消耗率框架,用於管理 Sentry 警示閾值的設定與審查
- FEE-1407:工作階段重播與正式環境除錯 — 將 Session Replay 與 Sentry 錯誤事件相關聯以進行根本原因分析
- FEE-1205:軟體供應鏈安全 — lockfile 與 SRI 減少未驗證程式碼進入正式環境,補充錯誤監控的覆蓋範圍
- FEE-1500:CI/CD 與部署概觀 — Source map 上傳作為部署 Pipeline 中的必要步驟
參考資料
- Sentry JavaScript SDK 文件
- Sentry React SDK 文件
- Sentry Vue SDK 文件
- @sentry/vite-plugin on npm
- Sentry Source Maps 文件
- Sentry Release 追蹤
- sentry-cli releases 文件
- Sentry beforeSend 文件
- Sentry 警示規則文件
- David Cramer, "Sentry: From the Beginning," cra.mr (2019). https://cra.mr/sentry-from-the-beginning/
- MDN Web Docs, "Window: error event," Mozilla. https://developer.mozilla.org/en-US/docs/Web/API/Window/error_event
- MDN Web Docs, "Window: unhandledrejection event," Mozilla. https://developer.mozilla.org/en-US/docs/Web/API/Window/unhandledrejection_event