日誌與錯誤追蹤的差異:各自保留什麼,如何搭配排查
從收集範圍、問題分組、情境資訊、告警與成本比較日誌和錯誤追蹤,釐清當機分析、受影響使用者數及觀測雲請求與日誌關聯的條件。
付款請求失敗時,例外可能指出程式停在哪裡,卻未必能說明之前是否已保留庫存、下游服務回了什麼。要繼續查,這些資訊也得有相應紀錄。
日誌保留應用實際記錄的事件,錯誤追蹤則把收集到的錯誤整理成便於調查與跟進的問題。 不能簡單分成「日誌靠手動搜尋、錯誤追蹤會自動診斷」:兩者都可以提供查詢與告警,也都無法重建未收集的資料。即使是受影響使用者數,也取決於實際事件和識別資訊。
核心差異速覽
- 日誌可包含正常處理、除錯資訊、警告與錯誤,實際範圍受記錄、收集與保留策略影響;錯誤追蹤以錯誤事件為主,也能接收明確上報的訊息。
- 錯誤追蹤可依指紋等規則分組,日誌平台也能使用結構化欄位、查詢、分群與告警整理錯誤。
- 堆疊、裝置、版本與麵包屑取決於 SDK、整合與設定,不保證完整;日誌也能帶有結構化情境資訊。
- 兩者可以搭配:錯誤追蹤協助發現、整理及分派問題,日誌補上已記錄的業務流程與下游細節。
日誌記錄什麼?
開發者、框架與中介軟體會輸出請求處理、狀態變更、除錯等選定事件,不是把系統發生的一切都記下來。日誌可以是自由文字,也可以是帶有 service、status、請求識別碼的結構化紀錄。價值取決於記錄、收集和保留了什麼。OpenTelemetry 日誌資料模型(英文)也能在訊息內容之外保留結構化屬性。
調查入口不只有關鍵字搜尋,也可以是結構化查詢、監控事件或相關請求。日誌能補充業務狀態與處理順序,但一行 error 仍不足以確認完整根本原因。
錯誤追蹤增加什麼?
Sentry 等產品的錯誤追蹤功能透過 SDK 或整合收集錯誤事件。自動捕捉範圍取決於執行環境、SDK 初始化與設定,常見例子是未處理例外與未處理的 Promise rejection。應用已攔截並處理的例外,可能需要透過 captureException 等介面明確上報,不能假設所有當機或錯誤的業務結果都會自動被發現。Sentry 錯誤捕捉(英文)
通常會圍繞三類工作整理錯誤,但不代表日誌平台絕對做不到:
- 問題分組。 堆疊、例外類型、訊息、自訂 fingerprint 等都可能影響分組。Sentry 的預設演算法有版本,規則也可以調整。相似訊息未必是同一問題,同一原因也可能形成不同群組。分組演算法與規則(英文)
- 補充情境。 可帶上堆疊、環境、版本、裝置、使用者與麵包屑,但實際欄位取決於 SDK 和啟用的整合。使用者資料需要依目的設定、控制或去識別,接入 SDK 不代表已識別全部訪客。SDK 資料收集範圍(英文)
- 告警與復發處理。 新問題或已解決問題再次出現,可觸發相應規則。過濾、取樣、配額、條件與通知頻率都會影響是否通知,不是每個新例外都會立即送出告警。告警條件與過濾(英文)
當機分析(crash analytics)更聚焦當機事件及其版本、裝置與觀測到的影響範圍。拋出例外不一定造成程序當機,各執行環境支援的當機、原生錯誤類型也不同,需要核對對應 SDK 與符號檔要求。「受影響使用者數」來自實際收到的事件與識別欄位,不能直接當成全部受影響訪客或業務損失。
比較實際處理方式
| 面向 | 日誌 | 錯誤追蹤 |
|---|---|---|
| 範圍 | 實際記錄並保留的事件,可含正常與錯誤資訊 | 收集到的例外、支援的當機或明確上報的訊息 |
| 收集 | 框架輸出、應用記錄與收集器 | SDK/整合自動捕捉,加上明確上報 |
| 彙總 | 依平台使用結構化查詢、統計或分群 | 以問題分組與計數,可調整指紋等規則 |
| 告警 | 依已收集資料設定偵測與通知規則 | 依新問題、復發等條件與通知頻率設定 |
| 情境 | 記錄內容、欄位加工與保留範圍 | SDK、平台、整合、識別碼與隱私設定 |
| 成本 | 依產品方案計算攝取、儲存、查詢或功能費用 | 依產品方案計算事件額度、保留、功能或超量費用 |
分組減少的是需要逐項處理的問題數,不一定會減少攝取的錯誤事件。應按實際產品與方案比較成本,不能把「日誌量」和「事件量」當成所有產品共通、可直接互換的計費單位。
依調查階段搭配使用
入口不同,順序也可能不同;以下三個階段有助於整理工作:
- 發現: 用錯誤追蹤規則或日誌監控發現新問題、錯誤數變化;影響範圍需依實際收集的事件與識別資訊判斷。
- 定界: 透過版本、環境欄位縮小範圍,分派給負責團隊;前提是相關欄位正確記錄。
- 診斷: 依發生時間與請求情境查詢已保留日誌,結合堆疊、業務狀態與下游回應驗證原因。
只保留錯誤事件,可能缺少失敗前正常處理的證據;只儲存分散文字,卻未建立欄位與告警,也可能漏掉需要處理的問題。選擇應依據缺少哪些證據和處理能力,而非資料類型的名稱。
在觀測雲回到同一請求的日誌
接入鏈路收集,並讓業務日誌帶上格式一致的目前 trace_id 後,可在觀測雲的鏈路詳情(英文文件)查看已記錄的錯誤 Span,再查詢同一請求的關聯日誌。時間範圍、服務與環境、日誌索引映射及查詢權限也要一致。未收集、因取樣捨棄或已過保留期限的資料,不會因相同 trace ID 而恢復。接入 APM 並不代表所有例外都已自動收集及分組。
日誌也有集中整理錯誤的入口。觀測雲日誌錯誤追蹤(英文文件)可查看含 error_stack 或 error_message 的已收集日誌。欄位必須實際存在,error 層級本身不能補上缺少的堆疊。
需要通知與分派時,可按日誌或鏈路資料設定監控規則(英文文件),並在事件中加入相關查詢連結。啟用關聯故障與事件等級映射後,符合條件的異常事件可建立故障紀錄;通知仍依告警策略與相關設定執行。這樣能將錯誤文字的查詢,與後續處理工作分開管理。
常見問題
error 層級的日誌還不夠嗎? 層級只是一個欄位。結構化錯誤日誌也能統計、分群與告警。要跟進同一問題、判斷版本或使用者影響,仍需對應堆疊、分組規則與識別資訊。
錯誤追蹤能取代日誌嗎? 通常無法直接取代。錯誤事件適合問題管理,業務稽核與正常處理流程仍需要相應紀錄。邏輯錯誤若未拋出例外,也沒有明確偵測或上報,兩種工具都不會自動知道業務結果錯了。
錯誤日誌如何關聯請求? 記錄目前 trace_id,維持一致的服務與環境欄位,核對時間、索引及權限。先用已知失敗請求確認能查到對應紀錄,再調查前後事件。同時發生並不自動證明因果關係。
前端錯誤也能追蹤嗎? 對應 SDK 可捕捉支援的錯誤,但仍有執行環境、整合與瀏覽器限制。要將壓縮後堆疊映回原始碼,需要與實際部署產物相符的 sourcemap,並透過上傳或支援的存取方式取得映射及必要的原始內容。Sentry 可以用 Debug ID 關聯產物,release/路徑比對是其他方式之一,不代表所有方式都必須有 release;映射與符號也無法補出原事件沒有的堆疊。sourcemap(英文) · Debug ID(英文)
