日誌與錯誤追蹤的差異:各自保留什麼,如何搭配排查

從收集範圍、問題分組、情境資訊、告警與成本比較日誌和錯誤追蹤,釐清當機分析、受影響使用者數及觀測雲請求與日誌關聯的條件。

最佳實務
應用錯誤分析與關聯排查主題插畫

付款請求失敗時,例外可能指出程式停在哪裡,卻未必能說明之前是否已保留庫存、下游服務回了什麼。要繼續查,這些資訊也得有相應紀錄。

日誌保留應用實際記錄的事件,錯誤追蹤則把收集到的錯誤整理成便於調查與跟進的問題。 不能簡單分成「日誌靠手動搜尋、錯誤追蹤會自動診斷」:兩者都可以提供查詢與告警,也都無法重建未收集的資料。即使是受影響使用者數,也取決於實際事件和識別資訊。

核心差異速覽

  • 日誌可包含正常處理、除錯資訊、警告與錯誤,實際範圍受記錄、收集與保留策略影響;錯誤追蹤以錯誤事件為主,也能接收明確上報的訊息。
  • 錯誤追蹤可依指紋等規則分組,日誌平台也能使用結構化欄位、查詢、分群與告警整理錯誤。
  • 堆疊、裝置、版本與麵包屑取決於 SDK、整合與設定,不保證完整;日誌也能帶有結構化情境資訊。
  • 兩者可以搭配:錯誤追蹤協助發現、整理及分派問題,日誌補上已記錄的業務流程與下游細節。

日誌記錄什麼?

開發者、框架與中介軟體會輸出請求處理、狀態變更、除錯等選定事件,不是把系統發生的一切都記下來。日誌可以是自由文字,也可以是帶有 service、status、請求識別碼的結構化紀錄。價值取決於記錄、收集和保留了什麼。OpenTelemetry 日誌資料模型(英文)也能在訊息內容之外保留結構化屬性。

調查入口不只有關鍵字搜尋,也可以是結構化查詢、監控事件或相關請求。日誌能補充業務狀態與處理順序,但一行 error 仍不足以確認完整根本原因。

錯誤追蹤增加什麼?

Sentry 等產品的錯誤追蹤功能透過 SDK 或整合收集錯誤事件。自動捕捉範圍取決於執行環境、SDK 初始化與設定,常見例子是未處理例外與未處理的 Promise rejection。應用已攔截並處理的例外,可能需要透過 captureException 等介面明確上報,不能假設所有當機或錯誤的業務結果都會自動被發現。Sentry 錯誤捕捉(英文)

通常會圍繞三類工作整理錯誤,但不代表日誌平台絕對做不到:

  1. 問題分組。 堆疊、例外類型、訊息、自訂 fingerprint 等都可能影響分組。Sentry 的預設演算法有版本,規則也可以調整。相似訊息未必是同一問題,同一原因也可能形成不同群組。分組演算法與規則(英文)
  2. 補充情境。 可帶上堆疊、環境、版本、裝置、使用者與麵包屑,但實際欄位取決於 SDK 和啟用的整合。使用者資料需要依目的設定、控制或去識別,接入 SDK 不代表已識別全部訪客。SDK 資料收集範圍(英文)
  3. 告警與復發處理。 新問題或已解決問題再次出現,可觸發相應規則。過濾、取樣、配額、條件與通知頻率都會影響是否通知,不是每個新例外都會立即送出告警。告警條件與過濾(英文)

當機分析(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(英文)

延伸閱讀

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

在线开通,按量计费,真正的云服务!

立即開始

选择观测云版本

代码托管平台