---
title: "Node.js のログを Pino か Winston でエラーを失わずに設定する"
description: "Pino も Winston も、呼び出し方によってはエラーが消えます。各ロガーの設定、ログレベル、スタックが残るエラーの渡し方を、Node.js 22 で検証してまとめました。"
canonical: "https://logbrew.co/ja/guides/node-logging"
last_updated: "2026-11-20"
---

# Node.js のログを Pino か Winston でエラーを失わずに設定する

Pino も Winston も、呼び出し方によってはエラーが消えます。各ロガーの設定、ログレベル、スタックが残るエラーの渡し方を、Node.js 22 で検証してまとめました。

2026年11月20日 に Node.js 22.18.0、Pino 10.4.0、Winston 3.19.0、Express 5.3.0、@logbrew/node 0.1.30、@logbrew/sdk 0.1.47、@logbrew/express 0.1.14 で検証

執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。

Canonical: https://logbrew.co/ja/guides/node-logging

## エラーが残る呼び出し方（画面と LogBrew）

| ログの呼び出し | 出力 | LogBrew |
| --- | --- | --- |
| Pino `error(err, msg)` | メッセージとスタック | 名前とメッセージ |
| Pino `error(msg, err)` | 消えた | 消えた |
| Winston `error(err)` | `{"level":"error"}` | 名前とメッセージ |
| Winston `error(err, msg)` | `"message":{}` | 消えた |
| Winston `error(msg, { err })` | `"err":{}` | 名前とメッセージ |
| Winston `error(msg, err)` | メッセージとスタック | 名前とメッセージ |

Pino 10.4 とフォーマットなしの Winston 3.19 で、`new Error("keg empty")` を 6 通りに渡した結果です。

## Pino のロガーを設定する

### ロガーを 1 つ作り、JSON で出力する

`pino()` は `info` 以上を記録し、呼び出しごとに JSON を 1 行出力します。行には数値の `level`、`time`、`pid`、`hostname` が入ります。`debug` の呼び出しは何も出力しませんでした。出力のホスト名は置き換えています。

```bash
import pino from "pino";

const logger = pino();

logger.debug("keg pressure read");
logger.info("tap opened");
logger.warn("keg below 10%");
logger.error("keg empty");
logger.fatal("cooler offline");
```

出力

```text
{"level":30,"time":1795160014210,"pid":27152,"hostname":"taproom","msg":"tap opened"}
{"level":40,"time":1795160014211,"pid":27152,"hostname":"taproom","msg":"keg below 10%"}
{"level":50,"time":1795160014211,"pid":27152,"hostname":"taproom","msg":"keg empty"}
{"level":60,"time":1795160014211,"pid":27152,"hostname":"taproom","msg":"cooler offline"}
```

### レベルを環境変数から読む

`LOG_LEVEL=debug` を付けて実行すると、コードを変えずに `debug` の行が出ます。`LOG_LEVEL` が空だとプロセスが止まります。`??` は空の文字列をそのまま残し、Pino が `default level: must be included in custom levels` を投げるためです。変数が空になり得るなら `||` を使います。

```bash
import pino from "pino";

const logger = pino({ level: process.env.LOG_LEVEL ?? "info" });

logger.debug("keg pressure read");
logger.info("tap opened");
```

出力

```text
{"level":20,"time":1795160014268,"pid":27166,"hostname":"taproom","msg":"keg pressure read"}
{"level":30,"time":1795160014268,"pid":27166,"hostname":"taproom","msg":"tap opened"}
```

### エラーを先に、メッセージを後に渡す

Pino は、最初の引数か `err` フィールドにある `Error` を、`type`、`message`、`stack` を持つ `err` に変えます。メッセージの後に渡したエラーは警告なしに消え、3 行目には `err` がありません。各スタックは 1 行目の後を省略しています。

```bash
import pino from "pino";

const logger = pino();
const err = new Error("keg empty");

logger.error(err, "pour failed");
logger.error({ err, orderId: "ord_42" }, "pour failed");
logger.error("pour failed", err);
```

出力

```text
{"level":50,"time":1795160014336,"pid":27169,"hostname":"taproom","err":{"type":"Error","message":"keg empty","stack":"Error: keg empty\n    at …"},"msg":"pour failed"}
{"level":50,"time":1795160014337,"pid":27169,"hostname":"taproom","err":{"type":"Error","message":"keg empty","stack":"Error: keg empty\n    at …"},"orderId":"ord_42","msg":"pour failed"}
{"level":50,"time":1795160014337,"pid":27169,"hostname":"taproom","msg":"pour failed"}
```

## Winston のロガーを設定する

### Console トランスポートでロガーを作る

オプションなしの `winston.createLogger()` は `info` 以上を記録し、JSON を出力します。`debug` の呼び出しは何も出力せず、`winston.format.timestamp()` を追加するまで行に時刻は入りません。

```bash
import winston from "winston";

const logger = winston.createLogger({
  transports: [new winston.transports.Console()]
});

logger.debug("keg pressure read");
logger.info("tap opened");
logger.warn("keg below 10%");
logger.error("keg empty");
```

出力

```text
{"level":"info","message":"tap opened"}
{"level":"warn","message":"keg below 10%"}
{"level":"error","message":"keg empty"}
```

### format.json() の前に format.errors() を置く

フォーマットがないと、`logger.error(err)` は `{"level":"error"}` しか出力しません。JSON フォーマットは `Error` のメッセージとスタックを飛ばすためです。先頭に `winston.format.errors({ stack: true })` を置くと、同じ呼び出しで両方が出力されます。

```bash
import winston from "winston";

const err = new Error("keg empty");
const plain = winston.createLogger({
  transports: [new winston.transports.Console()]
});
plain.error(err);

const logger = winston.createLogger({
  format: winston.format.combine(
    winston.format.errors({ stack: true }),
    winston.format.json()
  ),
  transports: [new winston.transports.Console()]
});
logger.error(err);
```

出力

```text
{"level":"error"}
{"level":"error","message":"keg empty","stack":"Error: keg empty\n    at …"}
```

### メッセージを先に、エラーを後に渡す

`logger.error(err, "pour failed")` では、渡したメッセージが消えます。`logger.error("pour failed", { err })` は `"err":{}` を出力します。`logger.error("pour failed", err)` は両方を残し、エラーのメッセージを後ろにつなげて `pour failed keg empty` にします。

```bash
import winston from "winston";

const logger = winston.createLogger({
  format: winston.format.combine(
    winston.format.errors({ stack: true }),
    winston.format.json()
  ),
  transports: [new winston.transports.Console()]
});
const err = new Error("keg empty");

logger.error(err, "pour failed");
logger.error("pour failed", { err });
logger.error("pour failed", err);
```

出力

```text
{"level":"error","message":"keg empty","stack":"Error: keg empty\n    at …"}
{"err":{},"level":"error","message":"pour failed"}
{"level":"error","message":"pour failed keg empty","stack":"Error: keg empty\n    at …"}
```

## Pino と Winston のログを LogBrew に送る

### パッケージを入れてキーを設定する

`@logbrew/node` は Pino のログを取り込み、`@logbrew/sdk` には Winston のトランスポートがあり、`@logbrew/express` はリクエストのトレースを追加します。`createLogBrewNodeClient()` はキーを `LOGBREW_SERVER_API_KEY` から読みます。

```bash
npm install pino winston express @logbrew/node @logbrew/sdk @logbrew/express
```

### installLogBrewPinoInstrumentation() を 1 回呼び出す

最初のログの前に呼び出します。Pino はこれまでどおり自分の行を出力し、LogBrew は各レコードを `pinoLevel`、`pinoLevelNumber`、あなたのフィールドとともに受け取ります。LogBrew が残すのはフラットなフィールドだけなので、`card` オブジェクトは送られませんでした。`RecordingTransport` は SDK が送った内容を手元に残して表示するためのものです。実際のアプリでは `transport` を外してください。

```bash
import pino from "pino";
import { RecordingTransport } from "@logbrew/sdk";
import { createLogBrewNodeClient, installLogBrewPinoInstrumentation } from "@logbrew/node";

const transport = RecordingTransport.alwaysAccept();
const client = createLogBrewNodeClient({ transport });
installLogBrewPinoInstrumentation({ client });

const logger = pino({ redact: ["card.number"] }).child({ service: "taproom" });
logger.info({ orderId: "ord_42", card: { number: "4242424242424242" } }, "order paid");
logger.error(new Error("keg empty"), "pour failed");

await client.shutdown();
for (const { attributes: { level, message, metadata } } of JSON.parse(transport.lastBody()).events) {
  console.log(JSON.stringify({ level, message, metadata }));
}
```

出力

```text
{"level":30,"time":1795160014692,"pid":27178,"hostname":"taproom","service":"taproom","orderId":"ord_42","card":{"number":"[Redacted]"},"msg":"order paid"}
{"level":"info","message":"order paid","metadata":{"pinoLevel":"info","context.service":"taproom","context.orderId":"ord_42","pinoLevelNumber":30}}
{"level":"error","message":"pour failed","metadata":{"pinoLevel":"error","context.service":"taproom","pinoLevelNumber":50,"errorName":"Error","errorMessage":"keg empty"}}
{"level":50,"time":1795160014700,"pid":27178,"hostname":"taproom","service":"taproom","err":{"type":"Error","message":"keg empty","stack":"Error: keg empty\n    at …"},"msg":"pour failed"}
```

### Winston に createLogBrewWinstonTransport() を追加する

Console の横にトランスポートを追加します。各レコードには `winstonLevel`、`defaultMeta` とあなたのフィールド、エラーがあればその `errorName` と `errorMessage` が付きます。

```bash
import winston from "winston";
import { RecordingTransport, createLogBrewWinstonTransport } from "@logbrew/sdk";
import { createLogBrewNodeClient } from "@logbrew/node";

const transport = RecordingTransport.alwaysAccept();
const client = createLogBrewNodeClient({ transport });

const logger = winston.createLogger({
  format: winston.format.combine(
    winston.format.errors({ stack: true }),
    winston.format.json()
  ),
  defaultMeta: { service: "taproom" },
  transports: [new winston.transports.Console(), createLogBrewWinstonTransport({ client })]
});
logger.info("order paid", { orderId: "ord_42" });
logger.error(new Error("keg empty"));

await client.shutdown();
for (const { attributes: { level, message, metadata } } of JSON.parse(transport.lastBody()).events) {
  console.log(JSON.stringify({ level, message, metadata }));
}
```

出力

```text
{"level":"info","message":"order paid","orderId":"ord_42","service":"taproom"}
{"level":"error","message":"keg empty","service":"taproom","stack":"Error: keg empty\n    at …"}
{"level":"info","message":"order paid","metadata":{"winstonLevel":"info","context.service":"taproom","context.orderId":"ord_42"}}
{"level":"error","message":"keg empty","metadata":{"winstonLevel":"error","context.service":"taproom","errorName":"Error","errorMessage":"keg empty"}}
```

### 各ログを Express のリクエストにひも付ける

`logbrewMiddleware()` はリクエストごとにスパンを 1 つ開き、`logbrewErrorHandler()` は投げられたエラーを、スタックフレームを持つ問題に変えます。リクエスト内の Pino のログには同じトレース ID が付きます。最後の列はその ID の先頭部分です。

```bash
import express from "express";
import pino from "pino";
import { RecordingTransport } from "@logbrew/sdk";
import { logbrewErrorHandler, logbrewMiddleware } from "@logbrew/express";
import { createLogBrewNodeClient, installLogBrewPinoInstrumentation } from "@logbrew/node";

const transport = RecordingTransport.alwaysAccept();
const client = createLogBrewNodeClient({ transport });
installLogBrewPinoInstrumentation({ client });
const logger = pino();

const app = express();
app.use(logbrewMiddleware({ client }));
app.get("/taps/:tap", (req, res) => {
  logger.info({ tap: req.params.tap }, "tap opened");
  res.json({ ok: true });
});
app.get("/kegs/:keg", () => {
  throw new Error("keg empty");
});
app.use(logbrewErrorHandler({ client }));
app.use((err, req, res, next) => {
  logger.error(err, "request failed");
  res.status(500).json({ error: "internal" });
});

const server = app.listen(3001, async () => {
  await fetch("http://127.0.0.1:3001/taps/ipa");
  await fetch("http://127.0.0.1:3001/kegs/stout");
  server.close();
  await client.shutdown();
  for (const body of transport.sentBodies) {
    for (const { type, attributes: a } of JSON.parse(body).events) {
      console.log(type, a.title ?? a.name ?? a.message, a.status ?? a.level, (a.traceId ?? a.context.trace.traceId).slice(0, 8));
    }
  }
});
```

出力

```text
{"level":30,"time":1795160015082,"pid":27185,"hostname":"taproom","tap":"ipa","msg":"tap opened"}
{"level":50,"time":1795160015140,"pid":27185,"hostname":"taproom","err":{"type":"Error","message":"keg empty","stack":"Error: keg empty\n    at …"},"msg":"request failed"}
log tap opened info 3dc57c32
span GET /taps/:tap ok 3dc57c32
issue GET /kegs/:keg failed error 49e1920b
log request failed error 49e1920b
span GET /kegs/:keg error 49e1920b
```

## 実際に試して確認したこと

このページのスクリプトはすべて Node.js 22.18.0、Pino 10.4.0、Winston 3.19.0、Express 5.3.0 で実行しました。出力には LogBrew SDK が組み立てた内容をそのまま載せています。2 回目の実行では同じログを LogBrew サーバーに送り、読み戻しました。

LogBrew SDK は、出力された行ではなくログのレコードからエラーを読みます。そのため、エラーを何も出力しない呼び出しでも、エラーは送られます。ロガーがレコードを作る前にエラーを捨てたり、エラーをメッセージにしたりすると、どのトランスポートでも取り戻せません。

|  | Pino | Winston |
| --- | --- | --- |
| `level: ""` | 起動時にエラーで止まる | `debug` を含むすべてのレベルを記録 |
| 新しい `logger.level` がすぐ反映される | はい | はい |

## Pino と Winston のどちらを使うか

アプリですでに使っているロガーをそのまま使ってください。LogBrew はどちらのレコードも受け取ります。

Winston にはマスク機能が組み込まれていないので、自分でフォーマットを書きます。

|  | Pino | Winston |
| --- | --- | --- |
| 引数の順序 | `error(err, msg)` | `error(msg, err)` |
| 各行の時刻 | はい | `format.timestamp()` を追加した場合 |
| `error(err)` のスタック | はい | `format.errors()` を追加した場合 |
| 組み込みのマスク機能 | `redact` | いいえ |

## Pino と Winston の Node.js ログレベル

Pino のレベルは `trace` の 10 から `fatal` の 60 までで、数が大きいほど重大です。Winston のレベルは `error` の 0 から `silly` の 6 までで、数が小さいほど重大です。

どちらも既定では `info` 以上を記録します。実行中にレベルを変えるには `logger.level = "debug"` を設定します。

元のレベルは `pinoLevel` か `winstonLevel` に残ります。

```bash
import pino from "pino";
import winston from "winston";

console.log(pino().levels.values);
console.log(winston.createLogger().levels);
```

出力

```text
{ trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60 }
{ error: 0, warn: 1, info: 2, http: 3, verbose: 4, debug: 5, silly: 6 }
```

| LogBrew | Pino | Winston |
| --- | --- | --- |
| `info` | `trace` `debug` `info` | `silly` `debug` `verbose` `http` `info` |
| `warning` | `warn` | `warn` |
| `error` | `error` | `error` |
| `critical` | `fatal` | いいえ |

## LogBrew が記録する内容

Pino や Winston の各レコードは、レベル、メッセージ、元のレベル、あなたのフィールドを持つ 1 件のログになります。子ロガーや `defaultMeta` のフィールドも、上の `context.service` のように届きます。

レコードにエラーがあると、`errorName` と `errorMessage` が付きます。どちらの連携でも `includeErrorStack: true` を設定すると、スタックも `errorStack` として送られます。

Pino 連携は、`token`、`password`、`cookie` などのフィールドを送信前に取り除きます。Winston のトランスポートはそのまま送るので、先に Winston の format で取り除いてください。

Express のミドルウェアを使うと、各ログにリクエストのトレース ID が付きます。失敗した 1 件のリクエストの問題、スパン、ログは同じ ID を持ちます。

- `installLogBrewPinoInstrumentation()`
  - `pinoLevel`: `error`
  - `pinoLevelNumber`: `50`
  - `context.service`: `taproom`
  - `errorName`: `Error`
  - `errorMessage`: `keg empty`
- `createLogBrewWinstonTransport()`
  - `winstonLevel`: `error`
  - `context.service`: `taproom`
  - `errorName`: `Error`
  - `errorMessage`: `keg empty`
- `logbrewErrorHandler()`
  - 問題: `GET /kegs/:keg failed`
  - `exception.type`: `Error`
  - `mechanism`: `express.middleware`
  - `handled`: `false`
  - スタックフレーム: 10

## よくある質問

### Pino の既定のログレベルは何ですか？

`info` です。`pino()` は `info`、`warn`、`error`、`fatal` を出力し、`debug` と `trace` を捨てます。変えるには `pino()` に `level` を渡すか、`logger.level` を設定します。

### Winston がエラーのメッセージを空で記録するのはなぜですか？

`Error` の `message` と `stack` は列挙できないプロパティなので、JSON フォーマットが飛ばします。`winston.format.json()` の前に `winston.format.errors({ stack: true })` を追加してください。

### Pino でエラーを記録するにはどうしますか？

`logger.error(err, "pour failed")` のようにエラーを先に渡すか、`logger.error({ err }, "pour failed")` のようにフィールドに入れます。メッセージの後に渡したエラーは、Pino が捨てます。

### Pino と Winston のどちらを使えばよいですか？

アプリで使っている方をそのまま使ってください。Pino は設定なしで JSON を出力し、マスク機能も組み込まれています。Winston は選んだフォーマットで行を組み立てます。LogBrew はどちらのログも受け取ります。

### Pino が default level must be included in custom levels を投げるのはなぜですか？

渡したレベルが Pino のレベルではないためです。多くの場合、`LOG_LEVEL` が空になっています。`process.env.LOG_LEVEL || "info"` と書けば、空の値は `info` に戻ります。

## Node.js のエラーをリクエストとあわせて確認する

LogBrew の Node SDK は、Pino や Winston の各ログをレベルとフィールドつきで送り、リクエストのトレースと問題にひも付けます。十分な無料プランで始められ、カードは不要です。

[無料で始める](https://logbrew.co/ja)

## 出典

- [Pino docs, Logging method parameters](https://github.com/pinojs/pino/blob/main/docs/api.md#logging-method-parameters)
- [Pino docs, Redaction](https://github.com/pinojs/pino/blob/main/docs/redaction.md)
- [Winston docs, Logging levels](https://github.com/winstonjs/winston/blob/master/README.md#logging-levels)
- [Winston docs, Formats](https://github.com/winstonjs/winston/blob/master/README.md#formats)
- [Express docs, Error handling](https://expressjs.com/en/guide/error-handling/)
- [winstonjs/winston#1338](https://github.com/winstonjs/winston/issues/1338)

## エージェント、Python、Node.js、React のその他のガイド

- [Claude Code と Codex に MCP サーバーを追加する](https://logbrew.co/ja/guides/mcp-server-claude-code-codex)
- [Claude Code と Codex で AGENTS.md を使う](https://logbrew.co/ja/guides/agents-md)
- [Claude の overloaded エラー 529 とレート制限エラー 429 を解決する](https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error)
- [Python logging を正しいログレベルと例外の記録つきで設定する](https://logbrew.co/ja/guides/python-logging)
- [構造化ログ（structured logging）でフィールドから検索できるログの書式とログレベルを整える](https://logbrew.co/ja/guides/structured-logging)
- [Django のログを設定してすべての 500 エラーのトレースバックを残す](https://logbrew.co/ja/guides/django-logging)
- [FastAPI のログを設定してトレースバックを失わずにエラーを処理する](https://logbrew.co/ja/guides/fastapi-logging)
- [React にエラーバウンダリを追加してそれが見逃すエラーも記録する](https://logbrew.co/ja/guides/react-error-boundary)
- [トレース ID とスパン ID の違いを実際の traceparent ヘッダーで解読](https://logbrew.co/ja/guides/trace-id)
- [エラー、ログ、トレース、メトリクス、リリースのガイド](https://logbrew.co/ja/guides)
