Vercel 在 2026 年 11 月 6 日宣布 Tracing 正式 GA,Hobby、Pro 與 Enterprise 都可使用。新版不再只能從單一 request 的 Logs 開啟 trace,而是提供集中式 Traces 頁面、span 與 trace 清單、Kibana Query Language 查詢、Live mode,以及可用相同 KQL 的 CLI 搜尋。Hobby trace 保留期從 1 小時延長為 3 天,Pro 從 1 天延長為 14 天,Enterprise 從 3 天延長為 14 天。
真正需要立即盤點的是預設行為。2026 年 11 月 5 日起建立、在 Vercel 建置 Next.js 16.5 以上、且至少包含一個 Node.js Function 的新 project,第一次成功 build 後會自動加入「所有環境、100% requests」的 sampling rule。Vercel 也會在符合條件的 build 注入 @vercel/otel 以取得 framework spans;這不會改寫 package.json 或 lockfile,但會產生可計費的 span units。
先確認哪些專案會自動啟用
不是所有 Next.js 部署都會自動開 tracing。vercel deploy --prebuilt、純 static export、只有 Edge runtime、既有 project,或團隊已關閉 tracing 的 project,不符合這次預設條件。若專案已有 instrumentation.ts、直接或間接使用較新的 @opentelemetry/api,或設定 instrumentationInject,Vercel 不會自動加入 @vercel/otel;基礎 infrastructure spans 仍可收集,但 framework spans 需要自行配置。
團隊應在建立新 project 的 checklist 加入 Settings → Tracing 檢查,不要只看 repository dependency 判斷。對新專案記錄建立日期、Next.js 版本、runtime、sampling rules、預計每月 requests 與每 request 的平均 spans。Preview 與 production 若共用 All Environments 規則,開發測試流量也會一起計入。
如果目的是抓 production 的罕見錯誤,可把 production 設較低基準採樣,對關鍵 API path 提高比例;Preview 則依除錯需求另設。健康檢查、監控探測與高頻低價值 endpoint 可用 0% path rule 排除。規則依第一個 match 生效,且 Dashboard 不能直接重新排序;若廣泛的 100% rule 已在上方,要先移除,再新增精確排除規則,最後補回較廣規則。
Span units 怎麼估,不要把 100% 當成免費預設
Vercel 以 sampling 後被索引的 span 計算 span units。每個不超過 2 KiB 的 indexed span 算一 unit,較大的 span 會以每 2 KiB 增加。官方在 2026 年 11 月 9 日可查到的方案資訊是:Hobby 每月含 100 萬 span units;Pro 為每 100 萬 units 0.50 美元;Enterprise 從相同單位價格起,實際仍應以帳戶合約與當日定價頁為準。
估算可以從 每月 request × 採樣率 × 每個 trace 的 indexed spans × 大小倍率 開始。這只是容量模型,不要在沒有真實資料時猜一個固定 span 數。先在低流量環境觀察一週,分 path 計算 trace 數與 span 分布,再設定預算與採樣率。自訂 span 的 attributes 若放入大物件,不只增加用量,也可能帶入敏感資料。
Hobby 用完當期包含量後,Vercel 會暫停 team 的所有 project tracing,且新週期開始不會自動恢復;具備更新所有 project 權限的人要手動 Resume Tracing,或升級方案。這代表低價值專案的 100% rule 可能讓真正需要偵錯的專案一起失去追蹤。至少按 team 盤點用量,並為突然成長設定告警與處理 owner。
從一個事故查詢流程開始
不要為了「有 tracing」而蒐集所有資料。先挑一種常見故障,例如 API 逾時、資料庫慢查詢或外部付款服務錯誤,定義需要哪些 spans 與 attributes。Vercel 會自動取得 infrastructure 與 fetch spans;framework 與 custom spans 則透過 OpenTelemetry 補足。Attribute 只放診斷需要且不含密碼、token、完整個資或付款資料的值。
建立三個可重複查詢:最近一小時的 error traces、超過服務門檻的慢 spans、指定 request ID 的完整 trace。Dashboard 與 vercel traces search 使用相同 KQL,值班人員可把已驗證的 query 放進 runbook;從 log 取得 request ID 後,再用 vercel traces inspect 查看單一請求。驗收要確認 preview、production、不同 routes 與外部 fetch 都能串起,而不是只確認 Traces 頁面有資料。
14 天保留期適合回查兩週內的間歇問題,但不是長期稽核保存。需要更長 retention、跨雲追蹤或既有 Datadog、Grafana、Honeycomb 等工作流時,可評估 Trace Drains。官方 Trace Drains 使用 OTLP/HTTP 傳送 OpenTelemetry traces,可接 native integration 或自管 HTTPS endpoint;不支援只提供 OTLP/gRPC 的接收端。外送前同樣要審查 sampling、資料欄位、傳輸失敗、重送與供應商費用。
內建 Tracing、Session Tracing 或外部平台怎麼選
持續採樣的 Vercel Tracing 適合「問題發生後才回頭查」與跨真實流量找罕見錯誤;Session Tracing 適合由特定瀏覽器重現操作;外部 OpenTelemetry 平台適合跨多個供應商與較長保存。三者可以組合,但不要重複蒐集同一批高比例 spans 卻沒有人使用。
小型 Vercel-only 專案可先用內建 Tracing,以 path 與 environment 控制採樣;已有成熟可觀測性平台的團隊,則把 Vercel traces 接到既有告警與 retention 政策。只有 Edge custom spans 的需求要特別注意:官方目前列出的限制是 Edge runtime functions 的 custom spans 不會出現在 traces,不能假設和 Node.js runtime 完全相同。
正式啟用前應完成:確認自動啟用條件、將預設 100% rule 調成有依據的比例、排除低價值 path、檢查敏感 attributes、以真實用量估算 units、設定 team owner 與預算告警,並演練一個從 log 到 trace 的事故。Tracing GA 降低了開始觀測的門檻,但預設打開並不等於治理完成;能查到需要的訊號、又不讓成本與資料無限制擴張,才是這次升級真正帶來的價值。