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 実践ガイド(英語)にあります。
出力の要件から選ぶ
- Express のアクセスログなら Morgan を使い、リクエスト行の出力先を決める。
- CLI の進捗や結果を表示するなら Signale を検討する。
- リクエストの多い API で、収集できるストリームに JSON を書くなら Pino から検討する。
- 出力先ごとにレベルや形式を変える場合や、アプリケーションでファイルをローテーションする場合は Winston を検討し、必要な transport を設定する。
- ログをカテゴリ単位で管理する構成には 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 のログ収集概要 · ログエクスプローラー · モニタリング
