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 實作指南(簡體中文)。

按輸出需求選擇

  1. Express 的存取日誌可從 Morgan 開始,再決定送往哪裡。
  2. CLI 的進度與結果可用 Signale 顯示。
  3. 需要寫入可採集串流的高流量 JSON 日誌,可先評估 Pino。
  4. 需要依目的地分級、調整格式或輪替檔案,可先評估 Winston 並設定對應 transport。
  5. 專案已按日誌類別組織,可考慮 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 日誌採集概覽 · 日誌檢視器 · 監控(簡體中文)

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

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

立即開始

选择观测云版本

代码托管平台