Node.js 로깅 라이브러리 8종 비교: Pino, Winston, Morgan 외

Node.js 로거 8종을 JSON 출력, 대상별 설정, 수집 방식으로 비교합니다. 운영 애플리케이션, CLI, Express 액세스 로그에 맞는 선택지를 살펴보세요.

모범 사례
로그 수집, 처리 및 조회를 나타낸 그림

Node.js 로거를 고를 때는 장애가 났을 때 어떤 로그를 찾게 될지부터 생각해 보면 좋습니다. 요청 ID로 오류를 좁힐 수 있는지, 스택 트레이스가 한 건의 이벤트로 수집되는지, 콘솔과 파일에 서로 다른 로그 레벨을 적용할 수 있는지가 선택을 가릅니다.

구조화된 JSON이 주된 요구라면 Pino부터, 출력 대상마다 형식과 레벨을 달리해야 한다면 Winston부터 살펴볼 만합니다. Signale은 CLI 화면에, Morgan은 Express 액세스 로그에 적합합니다. 각 프로젝트의 공식 문서와 패키지 배포 기록을 바탕으로 용도와 차이를 짚어봅니다.

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를 설정하면 stdout에 JSON을 씁니다. 브라우저에서는 ROARR.write를 지정해 레코드를 받을 수 있습니다. Node.js의 adopt()는 비동기 콜백 범위에서 생성한 로그에 컨텍스트를 붙일 수 있습니다. 라이브러리는 필요한 필드를 추가하고, 호스트 애플리케이션은 출력 처리 방식을 정할 수 있습니다.

Signale로 터미널 진행 상황 보여주기

Signale은 색상 메시지, 터미널 화면을 갱신하는 대화형 모드, time()과 timeEnd()를 이용한 시간 측정을 제공합니다. secrets는 명시적으로 지정한 값만 가립니다. 민감한 값은 로그에 처음부터 넘기지 않는 편이 좋습니다. 사람이 보는 CLI 진행 표시에는 이 형식이 알맞고, 백그라운드 작업에서 검색할 이벤트가 필요하다면 구조화된 출력 경로를 따로 둘 수 있습니다.

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 파일 수집 설정(영어)에서 지정한 경로를 읽을 수 있는지, 의도한 소스로 들어오는지 봅니다. 컨테이너 stdout이나 stderr는 컨테이너 수집 설정(영어), 런타임 접근 권한, 필터를 확인합니다. 텍스트 스택이 여러 줄이라면 필드를 파싱하기 전에 이벤트 단위로 묶어야 할 수 있습니다.

해당 Guance Pipeline(영어)에서 이벤트 시각, 심각도, 요청 식별자가 기대한 값으로 추출되는지 확인합니다. 예를 들어 Pino에서 Winston으로 바꾸면 레벨과 오류를 표현하는 방식이 달라질 수 있습니다. 기존 쿼리가 정상적으로 실행되더라도 일부 로그를 놓칠 수 있으니, 새 출력으로 쿼리와 오류 모니터를 확인합니다.

선택한 뒤에는 검색까지 확인하기

애플리케이션의 이벤트는 애플리케이션 로거에 남기고, 요청별 기록이 필요하면 액세스 로그를 추가합니다. 출력 형식을 정한 뒤에는 수집기가 안정적으로 읽을 수 있는지, 기존 쿼리가 필요한 필드를 일관되게 해석하는지까지 봅니다.

자주 묻는 질문

Pino와 Winston의 속도 차이는 어느 정도인가요?
Pino가 공개한 벤치마크는 해당 버전, 메시지, 설정에서 나온 결과입니다. 서비스에서의 영향을 보려면 같은 로그 내용, 레벨, 출력 대상을 기준으로 비교합니다. 마스킹, 백프레셔, 요청 지연이 중요한 환경이라면 이 조건도 포함합니다.

기존 Bunyan 애플리케이션을 마이그레이션해야 하나요?
Node.js 업그레이드 계획과 패키지 유지보수 상태, 기존 도구가 로그 필드에 의존하는 범위를 먼저 확인합니다. 옮기기로 했다면 타임스탬프, 레벨, 오류 스택을 새 형식에 맞추고 쿼리와 알림 규칙이 계속 동작하는지 봅니다.

Morgan이 Winston을 대신할 수 있나요?
Morgan은 Express의 HTTP 요청을 기록합니다. 비즈니스 이벤트와 오류는 애플리케이션 로거를 사용합니다. 같은 출력 대상에 모으려면 Morgan의 stream.write에서 요청 로그를 그 로거로 전달할 수 있습니다.

8개 라이브러리의 출력을 모두 Guance로 수집할 수 있나요?
DataKit이 지원하고 읽을 수 있는 소스로 출력되면 수집할 수 있습니다. JSON은 필드를 추출하고, 텍스트는 형식에 맞는 Grok 규칙을 적용합니다. 여러 줄로 된 로그에는 묶음 설정이 필요할 수 있습니다. 대화형 터미널 화면과 브라우저 콜백은 수집 가능한 출력 경로를 따로 마련합니다.

관련 글: Node.js에서 Pino 사용하기(영어) · 로그 프레임워크 고르는 방법(중국어 간체)

Guance 문서(영어): DataKit 로그 수집 개요 · 로그 탐색기 · 모니터링

맞춤형 플랜 상담

문의하기

커뮤니티 가입

WeChat으로 스캔하여
커뮤니티에 가입하세요

Guance 사용해 보기

온라인에서 바로 시작하고 사용한 만큼만 결제하세요.

시작하기

Guance 요금제 선택

코드 저장소