Node.js ログライブラリ8選を比較:Pino、Winston、Morgan など

Node.js のログライブラリ8種を、JSON 出力、出力先別の設定、収集方法から比較。アプリケーション、CLI、Express のアクセスログに合う選択肢を解説します。

ベストプラクティス
ログの収集、処理、検索を表すイラスト

Node.js のロガーを選ぶときは、障害時にどんなログを探すかを考えると判断しやすくなります。リクエスト ID でエラーを絞れるか。スタックトレースは一つのイベントとして届くか。コンソールとファイルで別々のレベルを設定できるか。

構造化 JSON が中心なら Pino、出力先ごとに形式とレベルを変えたいなら Winston が候補です。CLI の端末表示には Signale、Express のアクセスログには Morgan が向いています。各プロジェクトのドキュメントとパッケージの公開履歴に沿って、それぞれの使いどころを見ていきます。

Node.js ログライブラリ8選を比較

ライブラリ 主な出力 向いている用途 選定時の注意点
Pino JSON 本番アプリケーションや API シリアライズは呼び出し側で実行。設定した transport で後段の処理を worker に移せる
Winston transport とフォーマットによる 出力先が複数あるアプリケーション ローテーションと例外ハンドラーは別途設定する
Log4js-node Layout による。一般的にはテキスト カテゴリ別の振り分け JSON で出力する場合は形式を明示して設定する
Bunyan JSON 既存の Bunyan 採用サービス npm の latest が古いため、実行環境と保守状況を確認する
Roarr JSON アプリケーションやライブラリ Node.js では出力の有効化が必要。ブラウザーでは書き込みコールバックを使う
Signale 人が読む端末向けテキスト CLI やスクリプト 対話モードは端末表示向け
Tracer テンプレートで整形したテキスト 呼び出し箇所を追うデバッグ ファイル名や行番号のプレースホルダーを使える
Morgan 定義済みまたはカスタムのリクエスト行 Express のアクセスログ アプリケーション内のイベントには別途ロガーを用意する

Pino:アプリケーションから JSON を出力する

Pino の既定の出力は JSON です。子ロガーで後続のログにリクエスト ID などの項目を付けられます。エラーをシリアライズするときにスタックを残せるほか、redact で指定したパスをマスクしたり削除したりできます。Fastify の組み込みログ機能は、有効にすると Pino を使います。

worker transport を設定しても、レコードの組み立てとシリアライズはロガーを呼び出した側で行われます。worker が担うのは設定した transport の処理です。ログ呼び出し元のファイル名と行番号は既定では含まれません。必要な場合は、その情報を取得する負荷も構成の比較に含めます。

Winston:出力先ごとに形式とレベルを変える

Winston ではレベル、フォーマット、transport を別々に設定できます。たとえばコンソールには読みやすい info 以上のログを、ファイルには error 以上の JSON を書き出せます。リモートへ出力する場合も、その宛先に対応する transport を用意します。

アプリケーション側でファイルをローテーションするなら、別パッケージの winston-daily-rotate-file を設定します。時刻とエラーのスタックはフォーマットを明示して、実際の出力を確認します。キャッチされなかった例外や未処理の Promise の拒否を記録する場合は、対応するハンドラーも設定します。

Log4js-node:カテゴリ別にログを振り分ける

Log4js-node は Log4j に近い構成です。Category がレベルと使う Appender を、Appender が出力先を、Layout が出力形式を決めます。たとえば監査ログとアプリケーションログで保管先を分けたいときに扱いやすい設計です。一般的な Layout はテキストを出力します。JSON が必要なら自作または互換性のあるサードパーティーの Layout を選び、出力項目を確認します。

Bunyan:既存の構成を見直すとき

Bunyan は構造化 JSON を出力し、子ロガーとエラーのシリアライザーを備えています。付属 CLI では整形やレベルの絞り込みができます。Bunyan をインストール済みのプロジェクトで、Unix 系のシェルから error 以上を表示する例です。

node app.js | ./node_modules/.bin/bunyan -l error

2026年11月6日時点で、npm の latest は2021年1月公開の 1.8.15 を指しています。新規採用では Node.js との互換性や保守の負担を確認しておきます。既存サービスの場合は、ログの項目やアラートを移行する工数と照らし合わせて判断できます。

Roarr:ログの受け取り方をホスト側で決める

Roarr は Node.js とブラウザーのどちらでも直接インポートできます。Node.js では既定で出力が無効です。ROARR_LOG=true を設定すると標準出力に JSON が書かれます。ブラウザーでは ROARR.write を設定してレコードを受け取れます。Node.js の adopt() を使うと、非同期コールバックの範囲内で出すログにコンテキストを付けられます。ライブラリ側は情報を添え、出力の扱いはホストアプリケーションに任せられます。

Signale:CLI の進捗を見やすくする

Signale は色付きのメッセージ、端末表示を更新する対話モード、time() と timeEnd() による計時を提供します。secrets で明示的に登録した値を伏せられますが、機密情報はログ入力に含めないようにします。人が見守る進捗表示に使い、バックグラウンドジョブの検索用イベントが必要なら構造化データの出力先を別途用意します。

Tracer:呼び出し元のファイルと行を確認する

Tracer はコンソール風の出力にレベル、タイムスタンプ、呼び出し箇所を加えます。{{file}}:{{line}} をテンプレートに含めると場所を確認でき、カスタム transport のコールバックで別の出力先に渡せます。本番でリクエスト単位の検索が必要なら、コンテキストをどの項目として残すかも決めておきます。

Morgan:Express のアクセスログを記録する

Morgan は Apache combined などの定義済み形式やカスタムトークンを使って、メソッド、URL、ステータスなどをリクエスト行に記録します。:response-time が測るのはレスポンスヘッダーの書き出しまでです。:total-time はレスポンスの完了までを測るため、ストリーミング応答では両者に差が出ます。

すでにアプリケーションロガーがあれば、Morgan は設定した stream にリクエスト行を渡し、業務イベントやエラーは既存のロガーで記録できます。ミドルウェアを追加する前に、同じアクセスログがフレームワークから出ていないかを確認しましょう。リクエスト ID と JSON の設定は Morgan 実践ガイド(英語)にあります。

出力の要件から選ぶ

  1. Express のアクセスログなら Morgan を使い、リクエスト行の出力先を決める。
  2. CLI の進捗や結果を表示するなら Signale を検討する。
  3. リクエストの多い API で、収集できるストリームに JSON を書くなら Pino から検討する。
  4. 出力先ごとにレベルや形式を変える場合や、アプリケーションでファイルをローテーションする場合は Winston を検討し、必要な transport を設定する。
  5. ログをカテゴリ単位で管理する構成には Log4js-node が合う。

Guance にログを取り込み、検索を確認する

まず通常のメッセージ、リクエストログ、スタックを含む例外を一件ずつ用意します。DataKit でファイルを収集する場合(英語)は、設定したパスを読み取れるか、収集元が意図どおりかを確認します。コンテナの標準出力や標準エラー出力なら、コンテナ収集設定(英語)、ランタイムへのアクセス、フィルターを見ます。テキストのスタックが複数行にまたがるなら、項目を抽出する前に一つのイベントにまとめます。

Guance Pipeline(英語) ではイベント時刻、レベル、リクエスト識別子が期待どおり取り出せるかを確認します。たとえば Pino から Winston に移すと、レベルやエラーの表現が変わり、従来のクエリが実行できても一部を拾えなくなることがあります。新しい出力でクエリとエラー検知を確認します。

選定後は、必要なログが引けるかを確かめる

業務イベントはアプリケーションロガーで記録し、リクエスト単位の記録が必要ならアクセスログを加えます。出力形式を決めたら、収集側で読み取れ、検索で必要な項目を扱えることまで確かめます。

よくある質問

Pino と Winston の速度はどのくらい違いますか?
Pino が公開するベンチマークの数値は、掲載されているバージョン、メッセージ、設定での結果です。実際のサービスを判断するには、ログの内容、レベル、出力先をそろえて比較します。マスキング、バックプレッシャー、リクエストの遅延も、影響するなら測定に含めます。

既存の Bunyan アプリケーションは移行すべきですか?
Node.js の更新計画、保守状況、既存ツールがどの項目に依存しているかを先に確認します。移行する場合はタイムスタンプ、レベル、エラースタックをそろえ、検索やアラートが引き続き機能するかを確認します。

Morgan で Winston の代わりになりますか?
Morgan は Express の HTTP リクエストを記録するものです。業務イベントとエラーはアプリケーションロガーに任せます。出力先を共通にしたい場合は、Morgan の stream.write からリクエスト行をそのロガーに渡せます。

8種類すべてのログを Guance で収集できますか?
DataKit が対応し、読み取れる収集元に出力されれば取り込めます。JSON は項目を抽出し、テキストは書式に合った Grok で処理します。複数行のログにはグルーピングが必要な場合があります。対話モードの端末表示やブラウザーのコールバックには、収集可能な出力経路を別に用意します。

関連記事:Pino の使い方(英語) · ログフレームワークの選び方(中国語・簡体字)

Guance ドキュメント(英語):DataKit のログ収集概要 · ログエクスプローラー · モニタリング

最適なプランを相談する

お問い合わせ

コミュニティに参加

WeChatでスキャンして
コミュニティに参加

Guanceを試す

オンラインですぐに始めて、使った分だけお支払いください。

利用を開始

Guanceのプランを選択

コードリポジトリ