---
title: "Node.js 로깅을 Pino나 Winston으로 오류 하나 놓치지 않게 설정하기"
description: "Pino와 Winston 모두 호출 방식에 따라 오류를 잃어버려요. 로거별 설정, 로그 레벨, 스택이 남는 오류 호출을 Node.js 22에서 직접 실행해 보고 정리했어요."
canonical: "https://logbrew.co/ko/guides/node-logging"
last_updated: "2026-11-20"
---

# Node.js 로깅을 Pino나 Winston으로 오류 하나 놓치지 않게 설정하기

Pino와 Winston 모두 호출 방식에 따라 오류를 잃어버려요. 로거별 설정, 로그 레벨, 스택이 남는 오류 호출을 Node.js 22에서 직접 실행해 보고 정리했어요.

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 환경에서 2026년 11월 20일에 테스트

글 [Furkan Erday](https://github.com/furkanerday). LogBrew 창업자 Furkan Erday. 매일 Claude Code와 Codex로 LogBrew를 만들어요.

Canonical: https://logbrew.co/ko/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`로 바꿔요. 메시지 뒤에 넘긴 오류는 경고 없이 사라져서, 세 번째 줄에는 `err`가 없어요. 각 스택은 첫 줄 뒤를 잘라 두었어요.

```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()을 한 번 호출하기

첫 로그보다 먼저 호출하세요. 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가 만든 내용을 그대로 담았어요. 두 번째 실행에서는 같은 로그를 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/ko)

## 출처

- [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/ko/guides/mcp-server-claude-code-codex)
- [Claude Code와 Codex에서 AGENTS.md 쓰기](https://logbrew.co/ko/guides/agents-md)
- [Claude overloaded 529 오류와 rate limit 429 오류 해결하기](https://logbrew.co/ko/guides/claude-overloaded-rate-limit-error)
- [Python logging을 올바른 로그 레벨과 예외 기록까지 설정하기](https://logbrew.co/ko/guides/python-logging)
- [필드로 검색할 수 있는 로그 포맷과 로그 레벨로 구조화 로깅하기](https://logbrew.co/ko/guides/structured-logging)
- [Django 로깅을 설정하고 모든 500 오류의 트레이스백 남기기](https://logbrew.co/ko/guides/django-logging)
- [FastAPI 로깅을 설정하고 트레이스백을 잃지 않고 오류 처리하기](https://logbrew.co/ko/guides/fastapi-logging)
- [React에 error boundary를 추가하고 놓치는 오류까지 기록하기](https://logbrew.co/ko/guides/react-error-boundary)
- [트레이스 ID와 스팬 ID 차이, 실제 traceparent 헤더로 해석하기](https://logbrew.co/ko/guides/trace-id)
- [오류, 로그, 트레이스, 메트릭, 릴리스 가이드](https://logbrew.co/ko/guides)
