Node.js 日誌函式庫比較:Pino、Winston 等八款怎麼選
從 JSON 輸出、目的地分流與採集方式比較八款 Node.js logger,說明正式環境、CLI 與 Express 存取日誌各適合用哪一款。
選 Node.js 日誌函式庫時,可以先看出事時要查什麼。能不能依請求 ID 找到錯誤?堆疊追蹤送到採集端時,還是不是同一筆事件?如果主控台和檔案需要不同的日誌等級,能不能分開設定?
正式環境主要需要結構化 JSON,可以先看 Pino。若不同輸出目的地需要各自的格式與等級,Winston 更貼近這類需求。Signale 偏向 CLI 的終端機顯示,Morgan 則處理 Express 的 HTTP 存取日誌。以下以各專案文件和套件發布紀錄為依據。
八款 Node.js 日誌函式庫比較
| 函式庫 | 常見輸出 | 適用情境 | 選用時要留意 |
|---|---|---|---|
| Pino | JSON 日誌 | 正式環境應用與 API | 序列化在呼叫端執行,可設定 worker transport 接手後續處理 |
| Winston | 由 transport 和格式決定 | 需要多個輸出目的地的應用 | 檔案輪替和例外處理器需另外設定 |
| Log4js-node | 由 Layout 決定,常見為文字 | 依類別分流 | 輸出 JSON 時要明確指定格式 |
| Bunyan | JSON 日誌 | 既有 Bunyan 服務 | npm latest 發布較早,應查核執行環境與維護狀況 |
| Roarr | JSON 日誌 | 應用與函式庫程式碼 | Node.js 須啟用輸出,瀏覽器可設定寫入回呼 |
| Signale | 適合人讀的終端文字 | CLI 與指令碼 | 互動模式主要用於終端顯示 |
| Tracer | 依範本輸出的文字 | 需要定位呼叫位置的除錯 | 支援檔名與行號預留位置 |
| Morgan | 預設或自訂的請求日誌行 | Express 存取日誌 | 應用事件仍需另外記錄 |
Pino:應用程式直接輸出 JSON
Pino 預設輸出 JSON。子 logger 能為後續日誌帶上請求 ID 等欄位,錯誤序列化可以保留堆疊,redact 可遮蔽或移除指定路徑的資料。Fastify 開啟內建日誌功能後會使用 Pino。
設定 worker transport 後,transport 可在 worker 執行,但呼叫端仍要建立並序列化每筆記錄。Pino 預設也不會在每筆記錄加入呼叫處的檔名與行號。比較設定時,若需要這兩個欄位,也要把取得它們的成本算進去。
Winston:依目的地設定日誌規則
Winston 可分別設定等級、格式和 transport。例如主控台輸出適合人讀的 info 日誌,檔案只保留 error 及以上等級的 JSON。要輸出到遠端,也需要對應的 transport。
應用自行管理檔案時,可另用 winston-daily-rotate-file 設定輪替。時間戳記與錯誤堆疊應明確設定格式並檢查輸出。若需要記錄未捕捉的例外或未處理的 Promise 拒絕,也要依文件設定處理器。
Log4js-node:用 Category 和 Appender 分流
Log4js-node 採用 Log4j 風格。Category 決定等級和使用的 Appender,Appender 決定目的地,Layout 決定輸出格式。例如稽核與應用日誌必須分開保存時,就能透過不同類別分流。常見 Layout 輸出文字,需要 JSON 時可使用自訂或相容的第三方 Layout,再確認實際輸出的欄位。
Bunyan:先盤點既有服務的相依性
Bunyan 輸出結構化 JSON,也提供子 logger、錯誤序列化和 CLI。若專案已安裝 Bunyan,在類 Unix 環境中,可以用下列指令美化輸出並只看 error 及以上等級:
node app.js | ./node_modules/.bin/bunyan -l error
截至 2026 年 11 月 6 日,npm 的 latest 標籤指向 2021 年 1 月發布的 1.8.15。新專案應先了解相容性與維護成本。既有服務則可把這些風險與調整欄位及告警規則的成本一起評估。
Roarr:讓宿主決定輸出方式
Roarr 可直接匯入 Node.js 或瀏覽器程式。Node.js 預設不輸出,設定 ROARR_LOG=true 後才會寫入 stdout。瀏覽器可設定 ROARR.write 接收記錄。Node.js 中的 adopt() 可為非同步回呼範圍內的日誌帶上上下文,函式庫因此可以補上自己的資訊,再由宿主應用決定如何處理輸出。
Signale:把終端機訊息留給人讀
Signale 提供彩色文字、更新終端顯示的互動模式,以及 time()、timeEnd() 計時。secrets 會遮蔽明確設定的值,應用仍應避免把敏感資料傳給 logger。CLI 的進度顯示適合用這種格式。若背景工作還需要可查詢的事件,可以另外提供結構化輸出。
Tracer:在除錯時顯示檔名和行號
Tracer 為主控台風格的輸出加上等級、時間戳記與呼叫位置。格式範本中的 {{file}}:{{line}} 可指出來源,自訂 transport 回呼則可將輸出送到別處。若正式環境要依請求上下文查詢,仍需明確規劃欄位與格式。
Morgan:記錄 Express 的 HTTP 存取
Morgan 可用 Apache combined 等預設格式,也支援自訂 token。可依需要記下方法、URL、狀態碼等欄位。:response-time 量到寫出回應標頭,:total-time 量到回應完成,串流回應的兩個值可能差很多。
Morgan 可將請求日誌行交給指定的 stream,應用事件和錯誤則繼續交給 Pino 或 Winston。新增中介軟體前,也要確認框架是否已產生相同的存取日誌。請求 ID 與 JSON 設定可參考 Morgan 實作指南(簡體中文)。
按輸出需求選擇
- Express 的存取日誌可從 Morgan 開始,再決定送往哪裡。
- CLI 的進度與結果可用 Signale 顯示。
- 需要寫入可採集串流的高流量 JSON 日誌,可先評估 Pino。
- 需要依目的地分級、調整格式或輪替檔案,可先評估 Winston 並設定對應 transport。
- 專案已按日誌類別組織,可考慮 Log4js-node。
把日誌接入觀測雲
先保留三種應用輸出:一般訊息、請求日誌,以及包含堆疊的例外。用 DataKit 採集檔案(簡體中文) 時,確認路徑可讀、來源與預期相符。容器的 stdout 或 stderr 則應檢查容器採集設定(簡體中文)、執行環境存取權限和篩選條件。純文字堆疊跨行時,先確認能依事件邊界合併,再解析欄位。
接著在對應的觀測雲 Pipeline(簡體中文)檢查事件時間、嚴重性和請求識別欄位。換用不同函式庫後,等級與錯誤欄位的表示方式可能改變。原本的查詢還能執行,卻可能少了符合條件的事件,因此要用新格式重查既有條件與錯誤監控。
選定後,先確認輸出可查
應用程式自己的事件交由應用 logger,需要逐筆請求紀錄時再加存取日誌。選定格式後,確認採集器能可靠讀取,查詢也能按預期解析欄位。
常見問題
Pino 比 Winston 快多少?
Pino 專案的基準測試只代表當時的版本、訊息與設定。用相同的資料內容、等級和輸出目的地比較。若遮蔽、背壓或請求延遲會影響服務,也要納入觀察。
既有 Bunyan 專案要遷移嗎?
先看 Node.js 升級計畫、套件的維護情況,以及目前工具對日誌欄位的依賴。決定更換時,先對齊時間戳記、等級與錯誤堆疊,避免影響下游查詢和告警。
Morgan 可以取代 Winston 嗎?
Morgan 處理 Express 的 HTTP 請求日誌。應用事件和錯誤仍由應用 logger 處理。若希望共用輸出目的地,可用 Morgan 的 stream.write 將請求日誌行送給應用 logger。
八款函式庫的輸出都能接入觀測雲嗎?
只要有 DataKit 支援且可讀的來源,就能安排採集。JSON 可擷取欄位,文字可用匹配的 Grok 規則處理,多行記錄則先設定合併。互動式終端畫面與瀏覽器回呼需另外安排可採集的輸出。
延伸閱讀:Pino 日誌實作(簡體中文) · 如何選擇日誌框架(簡體中文)
觀測雲文件:DataKit 日誌採集概覽 · 日誌檢視器 · 監控(簡體中文)
