로깅 프레임워크 선택법: 출력부터 수집까지 여덟 가지 기준
출력 스키마, 컨텍스트, 예외, 역압, 샘플링 등 여덟 가지 기준으로 로깅 프레임워크를 비교하고 수집기에서 같은 기록을 확인합니다.
로거를 바꾼 뒤 결제 서비스의 알림이 조용해졌다. 오류 로그는 계속 나오지만 기존 쿼리가 문자열 ERROR를 찾는 필드에 새 로거는 숫자를 쓸 수 있다. 예외 스택을 여러 줄로 쓰고 수집기가 각 줄을 다른 이벤트로 저장하는 경우도 있다. 로거가 설계대로 동작해도 애플리케이션에서 알림으로 이어지는 경로는 끊길 수 있다.
로깅 프레임워크를 고를 때는 그 경로를 끝까지 확인한다. 정상 요청, 예외가 발생한 요청, 로그가 몰리는 구간을 준비한다. 같은 기록으로 호출 API부터 운영 부담까지 여덟 가지를 비교할 수 있다.
애플리케이션이 쓰는 내용 확인하기
1. 레벨과 필터링
프레임워크가 심각도를 어떤 값으로 쓰고 어느 단계에서 필터링하는지 본다. 숫자형 로그 레벨과 문자열 ERROR, HTTP 상태 코드는 쓰임이 다르다. 기존 쿼리가 팀에 필요한 기록을 고를 수 있는지 확인한다. 비활성화된 레벨이라도 호출 전에 비싼 인자를 계산하면 애플리케이션은 그 비용을 부담한다. Go slog 문서(영어)
2. 구조화 출력
수집기가 해석할 수 있는 형식을 고른다. 한 줄에 JSON 객체 하나를 쓰면 필드 타입을 유지하면서 줄 단위로 파싱할 수 있다. 개발 환경은 사람이 읽기 쉬운 형식을 써도 된다. 이벤트 시간, 레벨, 진단 필드의 이름과 타입을 정하고 실제 출력을 확인한다. 숫자가 문자열로 바뀌면 범위 검색 결과도 달라질 수 있다.
3. 컨텍스트 전달
프로세스 공통 속성과 개별 요청 또는 이벤트의 필드를 구분한다. 자식 로거나 어댑터로 서비스나 요청 필드를 붙였다면 백그라운드 작업에도 따라가는지, 다른 요청에 남지 않는지 확인한다. 트레이스 컨텍스트가 있을 때 실제 trace ID를 기록한다. Guance 트레이스 상세의 전체 트레이스 관련 로그는 trace_id를 사용하고, 인덱스 매핑에는 service, env, version 등이 쓰일 수 있다. 관련 로그가 수집되어 있고 조회 권한도 있어야 한다. Guance 트레이스 상세
4. 예외 기록
프레임워크가 지원하는 방법으로 실제 예외를 전달하고 오류 타입, 메시지, 스택 등 필요한 내용이 출력되는지 확인한다. 줄바꿈이 이스케이프된 스택은 JSON 한 줄에 들어갈 수 있다. 텍스트 스택이 여러 줄에 걸친다면 수집기에서 멀티라인 규칙을 설정하고 이벤트 경계를 확인한다. DataKit 로그 수집
부하가 걸릴 때의 동작
5. 쓰기 비용과 역압
같은 이벤트를 실제 환경에 가까운 빈도로, 운영에서 쓸 대상에 출력해 본다. 출력을 버리는 sink로는 인코딩 비용을 따로 볼 수 있고, 실제 파일이나 스트림에서는 쓰기 지연을 확인할 수 있다. 비동기 큐로 요청 스레드의 작업을 줄일 수 있다. 큐가 가득 차면 설정에 따라 호출자를 기다리게 하거나, 기록을 버리거나, 동기로 처리할 수 있다. 메모리, 요청 지연, 유실 건수와 종료 시 큐를 비우는 방식까지 확인한다. Log4j 2 비동기 로깅(영어) · Python QueueHandler(영어)
6. 샘플링과 필터링
어떤 기록을 어느 단계에서 줄여도 되는지 정한다. 샘플링은 스트림 일부를 남기고 필터링은 조건에 따라 기록을 고른다. 꼭 필요한 오류나 감사 기록은 선택적 샘플링 대상에서 빼고, 남은 데이터로 기존 알림을 유지할 수 있는지 확인한다. 샘플링한 건수에서 원래 규모를 추정하려면 적용한 방식도 알아야 한다.
7. 애플리케이션과 테스트에 미치는 영향
대상이 느리거나 쓸 수 없을 때, 필드를 인코딩할 수 없을 때 어떻게 동작하는지 시험한다. 일부 로거의 Fatal 메서드는 프로세스를 종료하므로 일반 오류 호출을 바꾸기 전에 API를 확인한다. 테스트에서는 메모리 sink로 실제 출력과 실패 경로를 검증할 수 있다. 로깅을 켰을 때와 껐을 때, 쓰기가 밀렸을 때의 동작도 비교한다.
팀이 운영할 수 있는 선택지
8. 런타임과 생태계
실제로 사용하는 런타임과 의존성 버전, 릴리스 및 보안 업데이트 이력, 프레임워크 연동을 확인한다. Java는 실행 중 선택되는 SLF4J 프로바이더를, PHP는 PSR-3 패키지 버전을 본다. 팀이 잘 아는 로거와 명확한 출력 경로가 운영 부담을 줄여 줄 수 있다.
| 런타임 | 출발점 | 확인할 부분 |
|---|---|---|
| Node.js | Pino의 JSON 출력 | 자식 로거 필드, destination 또는 transport |
| Go | Go 1.21 이상에 내장된 slog, 또는 Zap이나 Zerolog | Handler와 Writer, 필드명, 실제 부하 비용 |
| Java | SLF4J와 호환되는 Logback 또는 Log4j 2 프로바이더 | 실제 활성화된 프로바이더와 appender |
| Python | 포매터와 핸들러를 붙인 표준 logging, 또는 structlog나 Loguru | 포맷 위치, 컨텍스트 전달, 종료 시 큐 처리 |
| PHP | PSR-3 인터페이스 뒤의 Monolog | 실제 핸들러, 포매터, 출력 대상 |
| Ruby | 단일 출력은 Logger, 구조화 페이로드와 여러 appender는 Semantic Logger | 출력 형식, 큐 정책과 flush 동작 |
수집기에서 같은 기록 확인하기
로컬 Python 3.13.1에서 사용자 정의 포매터로 테스트 결제 오류를 JSON 한 줄로 출력했다. level은 문자열 ERROR, http_status_code는 숫자 503을 유지했고 예외의 줄바꿈은 이스케이프됐다. 별도 테스트에서는 소비자 없이 한 건만 담을 수 있는 큐에 QueueHandler를 연결했다. 첫 번째 기록은 큐에 남고 두 번째는 핸들러의 오류 처리로 넘어갔다. 이 테스트의 범위는 출력 형태와 큐 포화 시 동작이다.
실제 서비스에서는 DataKit으로 설정한 컨테이너 스트림이나 파일을 수집한다. 정상 행과 오류 행을 Guance Pipeline에 넣고 이벤트 시간, status로 매핑된 로그 레벨, 숫자형으로 남은 별도의 HTTP 코드를 확인한다. 네트워크로 전송한다면 송신기와 수신기의 프로토콜과 인코딩을 맞추고 재시도와 버퍼 동작을 본다. 출력 방식을 바꾸기 전에 테스트 소스에서 기존 알림 쿼리를 실행한다. Guance Pipeline 빠른 시작(영어)
