Go 로깅 라이브러리 9개 비교: slog, Zap, Zerolog 외
Go 로깅 라이브러리의 API, 출력 형식, 유지보수 상태를 비교합니다. Logrus, slog, Zerolog, Zap에서 같은 경고를 출력해 교체 시 달라지는 필드를 확인합니다.
결제 서비스에서 이미 JSON 로그를 수집하고 있다면 Go 로거를 바꾸는 순간 뒤쪽의 파서와 알림에도 영향이 간다. 터미널에 찍히는 메시지는 같아도 레벨 값이 warning에서 WARN으로 바뀌면 기존 값으로 필터링하는 대시보드에서 이벤트가 빠진다.
Go 1.21 이상으로 새 서비스를 만든다면 표준 라이브러리의 log/slog부터 쓰기 좋다. 기존 서비스라면 수집기에 실제로 들어간 로그 한 줄과 애플리케이션 프로파일부터 본다. 파서가 어떤 필드에 의존하는지, 로깅이 실제로 얼마나 많은 비용을 쓰는지 파악할 수 있다.
Go 로깅 라이브러리 9개 비교
| 패키지 | 선택하는 이유 | 확인할 점 |
|---|---|---|
| slog | 표준 라이브러리의 구조화 로깅, 텍스트와 JSON Handler 내장 | Handler를 바꾸면 필드 이름과 출력 동작이 달라질 수 있다 |
| Zerolog | 오버헤드가 낮도록 설계된 체인형 이벤트, 기본 JSON 출력 | 타임스탬프는 이벤트에 넣거나 로거에 미리 연결한다 |
| Zap | 타입이 명시된 필드를 쓰는 Logger, 키-값과 포맷 메서드가 편리한 SugaredLogger |
실제로 쓸 API와 인코더를 기준으로 비교한다 |
| Logrus | 기존 WithFields, 포매터, Hook을 활용 |
업스트림은 유지보수 모드다. 이관할 때 기존 Hook의 대체 방법을 확인한다 |
| Apex/log | 간결한 구조화 API와 별도 Handler | JSON Handler는 사용자 필드를 fields 아래에 넣는다. 가장 최근 모듈 태그는 2020년에 나왔다 |
| Log15 | logfmt 출력과 조합 가능한 Handler | v3에서 모듈 경로가 바뀌었다. 2026년 5월 v3.2.1이 나왔고 업스트림은 slog도 검토할 것을 안내한다 |
| Logf | logfmt에 집중한 간결한 API와 기본 필드 | 고정할 버전과 수집기가 해당 logfmt를 읽는지 확인한다 |
| Phuslu/log | 체인형 이벤트와 파일 회전을 지원하는 FileWriter |
파일에 쓸 때는 회전 시 수집기가 어떻게 동작하는지도 검증한다 |
| Logr | 애플리케이션이 출력 구현을 주입하는 로깅 API | 출력 형식과 비용은 주입한 LogSink를 기준으로 본다 |
Logrus의 유지보수 모드는 업스트림의 작업 범위를, Apex/log의 태그 날짜는 릴리스 이력을 말해 준다. 실제 이관 작업량은 빌드에 쓰는 버전, 운영 중인 Hook, 수집기에 전달되는 출력에 달려 있다.
호출 API와 출력 형식을 따로 보기
slog는 터미널용 TextHandler와 수집기용 JSONHandler를 제공한다. 같은 *slog.Logger 호출을 유지하면서 뒤의 slog.Handler를 바꿀 수도 있다. 외부 로거를 연결하려면 호환되는 Handler나 어댑터를 마련한다. 필드 그룹, 레벨 매핑, 호출 위치가 바뀌는지는 별도로 확인한다. Go slog 패키지(영어)
라이브러리나 컨트롤러에서도 역할을 나눌 수 있다. 호스트가 이미 logr.Logger를 넘긴다면 그 객체를 받아 쓰고, 출력 구현은 애플리케이션에 맡긴다. Kubernetes의 컨텍스트 로깅은 go-logr API를 기반으로 한다. 컨트롤러는 리소스 이름이나 조정 작업의 맥락을 추가하고, 인코더는 호스트가 고를 수 있다. Kubernetes 컨텍스트 로깅(영어)
애플리케이션이 구현을 직접 고른다면 Zerolog의 체인형 이벤트와 Zap의 타입 필드를 비교해 볼 수 있다. Zap은 SugaredLogger를 제공하며, AtomicLevel로 실행 중에 레벨을 변경할 수 있다. 코드베이스에 맞는 호출 방식을 고르고 실제 사용할 필드로 측정한다.
인코딩 비용과 쓰기 비용을 나눠 측정하기
필드의 수와 타입, 로거에 미리 붙인 컨텍스트, 호출 위치 기록 여부, 출력 Writer에 따라 인코딩 비용이 달라진다. Zap의 업스트림 벤치마크는 라이브러리 버전을 고정하고 조건별로 결과를 따로 제시한다. 벤치마크 수치를 인용할 때는 설정도 함께 확인한다. Zap 벤치마크(영어)
프로파일에서 로깅 비용이 크다면 대표 이벤트를 두 가지 출력 환경에서 측정해 본다. 먼저 출력을 버리는 Writer로 인코딩과 메모리 할당 비용을 확인한다. 실제 컨테이너 stdout이나 회전하는 파일로 바꾸면 쓰기가 막히거나 버퍼가 찼을 때의 동작을 볼 수 있다. 레벨, 필드, 샘플링, 동시성을 맞추고 CPU, 할당 횟수, 지연 시간을 비교한다.
같은 이벤트로 교체 전후 출력 확인하기
checkout retry라는 실습용 경고에 오류와 숫자 필드 attempt=2를 넣어 Go 1.26.1에서 로컬로 실행했다. Zerolog에는 타임스탬프를 명시적으로 붙였고, Zap에는 운영용 JSON 인코더 설정을 적용했다.
| 테스트 구성 | 시간 필드 | 레벨 값 | 메시지 필드 |
|---|---|---|---|
| Logrus 1.10.2 JSON Formatter | time, RFC3339 |
warning |
msg |
| slog JSON Handler | time, 이 실행에서는 소수 초가 있는 RFC3339 |
WARN |
msg |
Zerolog 1.35.1과 Timestamp() |
time, RFC3339 |
warn |
message |
| Zap 1.28.0 운영용 JSON Encoder | ts, 숫자형 Unix 초 |
warn |
msg |
네 출력 모두 attempt는 숫자로 남았다. 원본 데이터에서 level=warning을 찾으면 Logrus 이벤트만 걸린다. time에 문자열 타임스탬프가 올 것으로 예상하는 파서에는 Zap의 숫자형 ts를 처리할 매핑도 필요하다. 이 로컬 테스트의 범위는 출력 스키마 확인이다.
Guance를 사용한다면 DataKit으로 지원되는 컨테이너의 stdout이나 로그 파일을 수집할 수 있다. Pipeline에 교체 전후 샘플을 넣고 파싱된 이벤트 시간, 레벨, 메시지, 업무 필드 타입을 대조한다. 이 경고처럼 레벨 표기가 달라지면 기존 모니터가 사용하는 값으로 매핑한다. 필드가 빠진 줄과 실제 운영에서 나오는 스택 트레이스도 함께 시험해 보는 편이 좋다. 전환 전에는 테스트 소스에 동일한 쿼리를 실행해 결과를 확인한다. DataKit 로그 수집 · Guance Pipeline(영어)
지금 로거가 서비스 요구를 충족하고 의존성을 관리할 수 있다면 유지해도 된다. 새 서비스는 slog로 시작하고, 측정에서 차이가 확인되면 Zerolog나 Zap을 검토한다. 프레임워크가 이미 Logr를 제공하는 곳은 그 API를 그대로 쓴다.
Go slog로 구조화 로그 구현하기(영어) · Zap으로 Go 로그 남기기(영어) · Zerolog로 Go 로그 남기기(영어)
