日誌等級詳解(從 FATAL 到 TRACE)

按處理結果選擇日誌等級,確認哪些記錄 API 會結束程序,並正規化嚴重度供查詢與告警使用。

最佳實務
日誌、指標與追蹤三類可觀測訊號示意圖

結帳服務向庫存 API 查詢庫存,第一次呼叫逾時。重試成功,顧客順利結帳。第一次逾時值得記錄,但單次呼叫失敗和整筆結帳失敗,回答的是不同問題。若用盡重試次數後結帳仍無法繼續,就在掌握結果的地方記錄失敗,並保留能找到這筆請求的資訊。

日誌等級表示事件的嚴重程度或診斷細節的多寡,也讓記錄器和輸出處理器能據此篩選事件。先根據記錄當下已知的結果選擇等級,再確認函式庫和收集器如何解讀它。

在知道處理結果的地方選擇等級

常見等級 結帳服務中的例子
FATAL 必要設定無效,服務無法啟動。
ERROR 重試後仍查不到庫存,結帳失敗。
WARN 第一次查詢庫存逾時,重試後成功。
INFO 服務已啟動,或對帳工作已完成。
DEBUG 在限定的調查範圍內記錄重試的判斷與耗時。
TRACE 在支援此等級的框架裡,追蹤已插入記錄點的重試迴圈分支。

這是採用上述六個名稱的團隊可用的一套約定。若逾時經常在重試後恢復,以指標統計重試次數通常比每次都寫警告更容易看出趨勢。請求確定失敗時,在知道最終結果的那一層記錄即可。若每一層都寫一條 ERROR,顧客遇到的一次失敗就可能被算成多筆錯誤日誌。附上服務、操作名稱以及請求 ID 或追蹤 ID,需要排查原因時再附上例外資訊。憑證和請求內容不宜寫入診斷欄位。INFO 記錄可以確認某個事件發生,判斷整體服務狀態仍需要其他訊號。

確認呼叫是否會終止程序

Log4j 2 定義了 FATAL 到 TRACE 六種一般事件等級。Python 標準的 logging 以 CRITICAL 作為最高的內建事件等級,FATAL 是它的別名,沒有內建 TRACE。Loguru 則另有 TRACE 和 SUCCESS。設定門檻或撰寫查詢前,先查閱使用中的函式庫。Log4j 2 等級 · Python 日誌等級 · Loguru 等級

FATAL 這個名稱本身無法說明程序是否會結束。Python 的 logging.fatal() 與 critical() 行為相同。Go 標準函式庫的 log.Fatal() 寫入日誌後會呼叫 os.Exit(1)。Pino 的 fatal() 用於程序結束前的最後一筆訊息,若該等級已啟用且輸出目的地提供 flushSync(),就會嘗試同步送出緩衝區資料。是否結束仍由應用程式決定。記錄啟動失敗或可以恢復的請求錯誤時,應確認所呼叫的 API 有何行為。Go log · Pino fatal

沿著輸出路徑檢查篩選條件

Log4j 2 採用一般 INFO 門檻時,INFO、WARN、ERROR 和 FATAL 可以通過等級判斷。後續的 Appender 或篩選器仍可能排除事件。找不到 DEBUG 日誌時,先看記錄器和輸出目的地的門檻。應用程式未輸出的事件,收集器無法補回。

若平常的日誌缺少調查所需的耗時資訊,可以只對受影響的模組或執行個體暫時啟用 DEBUG 或 TRACE,並設定結束時間。輸出目的地和收集器可能仍使用原來的篩選條件,開啟後要確認所需的記錄有送達,而且沒有帶入敏感值。執行時調整日誌等級

正規化等級時保留來源值

數字只在各自的格式內有意義。RFC 5424 的 syslog 嚴重度從 Emergency 的 0 到 Debug 的 7。OpenTelemetry 正規化後的 SeverityNumber 則是數值越大越嚴重,WARN 的範圍是 13–16。SeverityText 可以保留來源標籤。syslog 中表示 Warning 的 4,和 OpenTelemetry 中的 4 意義不同,應先按來源轉換,再做跨系統查詢。RFC 5424 嚴重度 · OpenTelemetry 日誌資料模型

例如,Pipeline 將結帳服務的 WARN 對應到觀測雲的 warning,可能得到以下記錄。原始標籤另外保留在一個欄位。

{"service":"checkout","operation":"check_inventory","outcome":"recovered","level":"WARN","status":"warning"}

DataKit 日誌收集器參考文件(簡體中文)說明,未擷取等級時的預設值為 info,畫面會將 trace 和 verbose 歸到 debug。DataKit 日誌收集指南(簡體中文)另有預設為 unknown 的說明。建立偵測規則前,把一筆警告和一筆未帶等級的記錄送進實際收集路徑,確認儲存後的 status。若 SECURITY 這類標籤用於表示事件類型,可將分類和嚴重度分開保留,讓兩者都能查詢。

在觀測雲的日誌檢視器按服務和正規化後的 status 篩選,可以確認偵測規則會計入哪些記錄。可把反覆重試後成功的情況作為趨勢觀察,並針對結帳失敗另設門檻和通知對象。看到錯誤日誌增加時,先比對結帳失敗數、流量或服務水準目標,再判斷顧客受到的影響。觀測雲日誌偵測(簡體中文) · 日誌監控

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

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

立即開始

选择观测云版本

代码托管平台