🪺 구조화 로그 포맷 설계 | 어떤 필드를 넣을까?

표준 필드명 세트를 정답으로 제시하지 않습니다. ECS·OpenTelemetry 처럼 널리 쓰이는 규약이 있지만 이름은 서로 다릅니다. 넣을 필드를 고르면 로그 한 건과 1건당 바이트를 계산합니다.

타임스탬프

레벨

메시지

상관관계 ID (요청 추적용)

서비스 이름

실행 환경

필드 이름 표기

타임스탬프 형식

추가 필드 — 한 줄에 "이름:타입:예시값". 타입은 string, int, float, bool

하루 로그 건수

건

로그 1건 크기 (줄바꿈 1바이트 포함)-

필드 수-

고르지 않은 기본 필드-

하루 용량-

30일 용량-

필드 이름이 차지하는 비중 (소수 1자리)-

한 줄 JSON (수집기에 넣는 형태)

읽기 쉬운 형태

필드를 고르면 로그 한 건이 얼마나 커지는가

구조화 로그는 사람이 읽는 문장 대신 키와 값으로 남겨서 검색과 집계가 되게 하는 방식입니다. 넣을 기본 필드를 고르고 추가 필드를 적으면 수집기에 넣는 한 줄 JSON 과 읽기 쉬운 형태를 만들고, 한 건의 UTF-8 바이트와 하루·30일 용량을 계산합니다. 필드 이름이 전체 바이트에서 차지하는 비중도 함께 보여 줍니다.

필드명 표준은 하나가 아닙니다. Elastic Common Schema 와 OpenTelemetry 의 의미 규약이 널리 쓰이지만 이름이 서로 달라서, 이 도구는 어느 쪽을 정답으로 제시하지 않고 snake_case, camelCase, 점 표기로 바꿔 주기만 합니다. 타임스탬프는 RFC 3339 문자열과 epoch 밀리초 중에 고르게 했습니다(2026년 10월 기준).

용량은 예시값 길이로 계산한 추정입니다. 실제 값의 길이, 수집 파이프라인이 덧붙이는 메타데이터, 압축, 인덱스 크기는 반영하지 않습니다. 개인정보와 비밀값은 필드로 넣지 않습니다. 중첩 객체와 배열은 지원하지 않고, 같은 이름이 겹치면 오류로 알립니다.

자주 묻는 질문

필드 이름은 어떤 표준을 따라야 하나요?

하나로 정해진 표준은 없습니다. Elastic Common Schema 와 OpenTelemetry 의 의미 규약이 널리 쓰이지만 이름이 서로 달라서, 팀 안에서 한 가지를 정해 일관되게 쓰는 편이 검색에 유리합니다.

상관관계 ID 는 왜 필요한가요?

한 요청이 여러 서비스를 거치면 로그가 흩어집니다. 요청마다 같은 ID 를 모든 로그에 넣어 두면 그 ID 로 묶어서 흐름을 되짚을 수 있어, 장애 조사 시간이 크게 줄어듭니다.

계산된 용량이 실제 저장량과 같나요?

같지 않습니다. 예시값 길이로 센 추정이며 수집 파이프라인이 붙이는 메타데이터, 압축, 검색 인덱스 크기는 빠져 있습니다. 필드를 늘릴 때 커지는 정도를 비교하는 용도로 보세요.

🪺구조화 로그(JSON) 포맷 설계 가이드

관련된 도구

로그 레벨 선택 가이드

로그 보관 기간·저장 용량 계산기

필드를 고르면 로그 한 건이 얼마나 커지는가

자주 묻는 질문

관련된 도구

로그 레벨 선택 가이드

로그 보관 기간·저장 용량 계산기

필드를 고르면 로그 한 건이 얼마나 커지는가

자주 묻는 질문

같은 카테고리 도구