OpenTelemetry 로그 시각 검수, 발생과 관측이 다를 때
OpenTelemetry 로그의 발생·관측 시각과 OTLP의 0을 구분합니다. 가상 8조건과 코드로 표시 시각의 대체 규칙을 검수하고, 전송 지연으로 단정하지 않는 인수 기준을 정리합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
2026-11-22 확인 기준, 로그 발생·관측 시각을 구분합니다. 발생값이 없으면 관측값으로 대체하되 두 값의 차이를 전송 지연으로 단정하지 않습니다.
늦게 나타난 에이전트 로그를 보고 작업도 늦게 실행됐다고 판단할 수 있을까요. 원천에서 기록한 때와 수집 코드가 본 때가 다를 수 있어 화면의 시각만으로는 판단하기 어렵습니다. 운영 인수에서는 어느 필드를 보여 주고 무엇으로 정렬하는지부터 확인해야 합니다.
발생 시각과 관측 시각 중 무엇을 표시할까요?#
원본 두 값은 함께 보존하고, 표시 목적에 맞는 선택 규칙을 문서화합니다. 한 시각만 지원하는 형식으로 바꿀 때 OpenTelemetry는 발생 시각 우선, 없으면 관측 시각 사용을 권고합니다. 모든 화면이 같은 순서로 정렬된다는 보장은 아닙니다.
공식 Logs Data Model의 Timestamp는 원천 시계의 발생 시각, ObservedTimestamp는 수집 시스템이 관측한 시각입니다. 관측값을 저장소 적재 완료나 최종 화면 표시 시각으로 바꾸어 읽지 않습니다. 발생 시각은 원천에서 모르면 빠질 수 있습니다.
OTLP의 LogRecord 정의는 이를 time_unix_nano와 observed_time_unix_nano로 표현합니다. 단위는 Unix epoch 이후 나노초이며, 두 필드 모두 0은 미확인 또는 누락입니다. 0을 그대로 날짜로 바꿔 1970년의 실제 사건으로 표시하면 누락을 숨길 수 있습니다.
가상 표본에서는 어떤 값이 남았을까요?#
2026-11-22 로컬에서 Python3.14.2와 OpenTelemetry API·SDK·OTLP 공통 exporter1.45.2를 사용했습니다. 합성8레코드를 메모리 exporter로 받아 OTLP protobuf로 직렬화하고 다시 읽었습니다. 아래는 그 값에 표시용 선택 함수를 적용한 자사 설계예시이며 고객 로그나 성능 통계가 아닙니다.
표의 발생·관측은 API 생성자의 입력입니다. 숫자는 이해를 위해 작게 잡은 합성 Unix 나노초입니다. None은 Python의 미입력 값이며 wire에서의 0과 표현이 다릅니다. 마지막 조건은 API가 사용하는 관측 시계를150으로 고정한 시험입니다.
| 합성 입력 조건 | API 입력값 | 설계한 표시 결과 |
|---|---|---|
| 발생 시각 있음 | 발생100·관측120 | 100: 발생 시각 |
| 발생 시각 미입력 | 발생None·관측120 | 120: 관측으로 대체 |
| 발생 시각 0 | 발생0·관측120 | 120: 0은 미확인 |
| 발생 시각이 더 늦음 | 발생130·관측120 | 130: 음수 차이 보존 |
| 두 시각이 같음 | 발생100·관측100 | 100: 지연 없음 단정 금지 |
| 관측 시각 0 | 발생100·관측0 | 100: 관측 누락 별도 |
| 두 시각 모두 0 | 발생0·관측0 | 미확인: 날짜 변환 보류 |
| 두 시각 모두 미입력 | 발생None·관측None | 150: API 생성 시 관측 |
Python1.45.2 API 원문의 직접 생성자는 발생값이 None이면 그대로 두고, 관측값이 None일 때 생성 시각을 채웁니다. 이번 왕복에서 발생값의 None은 wire0으로 읽혔습니다. 명시한 관측0은 생성 시각으로 바뀌지 않았습니다. 이 결과를 자동 계측이나 모든 로그 핸들러의 기본값으로 확대하지 않습니다.
발생 시각 표본은 time_unix_nano=100과 observed_time_unix_nano=120입니다. 표시값100을 선택해도 원본120은 남겨 둡니다. 아래 코드는 이미 받은 OTLP 레코드에 적용할 최소 선택 예시입니다. 입력값의 구문·범위 검사나 저장소 정렬을 대신하지 않습니다.
def display_time_ns(record):
if record.time_unix_nano != 0:
return record.time_unix_nano
if record.observed_time_unix_nano != 0:
return record.observed_time_unix_nano
return None
from opentelemetry.proto.logs.v1.logs_pb2 import LogRecord
known = LogRecord(time_unix_nano=100, observed_time_unix_nano=120)
missing = LogRecord(time_unix_nano=0, observed_time_unix_nano=120)
unknown = LogRecord(time_unix_nano=0, observed_time_unix_nano=0)
print(display_time_ns(known), display_time_ns(missing), display_time_ns(unknown))
# 100 120 None
로컬에서 첫 결과는100, 다음은120, 마지막은None이었습니다. 선택한 시각에 발생, 관측 대체, 미확인 같은 출처 표시를 붙이는 것은 별도 설계 제안입니다. SDK나 규약이 그 이름의 화면 필드를 제공한다는 뜻은 아닙니다.
두 시각의 차이를 지연으로 써도 될까요?#
시계 동기화와 수집 경로를 검증하기 전에는 순수 전송 지연이라고 단정하기 어렵습니다. 발생값은 원천 시계, 관측값은 수집 코드의 시계이므로 차이에는 시계 오차나 원천 버퍼링이 섞일 수 있습니다. 음수 차이를 무조건0으로 바꾸면 조사할 단서를 잃습니다. 이는 필드 정의에서 도출한 운영상의 판단이며 별도 지연 측정 규약은 아닙니다.
반대로 관측 순서가 필요한 화면도 있습니다. 수집 장애 조사처럼 목적이 명확하면 관측 시각으로 정렬할 수 있습니다. 다만 그 순서를 업무 실행의 인과관계로 확정하지 않고, 원천의 사건 식별자·순번이나 연결된 추적 정보를 추가로 확인합니다. 같은 시각의 두 사건 순서도 시각 하나로 확정하지 않습니다.
인수표에는 원본 두 필드, 각 시계의 주체, 표시용 선택값, 대체 여부, 실제 정렬 기준을 같이 적습니다. 원본 누락·명시적0·역전·동일값을 각각 넣어 화면과 조회 결과를 대조합니다. 두 시각이 모두 없을 때는 날짜 변환을 보류하는 제안을 별도 합의합니다. 이 로컬 시험은 Collector·네트워크·저장소·화면의 실제 동작까지 확인하지 않았습니다.
로그의 보존·승인·실행 추적은 AI 감사 로그 요구사항, 스팬의 성공·오류 상태는 OpenTelemetry 스팬 상태 검수에서 따로 다룹니다. 이번 판단 도구는 로그 레코드의 두 시각과 표시 규칙에 한정합니다.
어떤 판본을 확인했고 언제 다시 봐야 할까요?#
2026-11-22에 specification1.62.0의 Stable 로그 데이터 모델과 proto1.11.1을 확인했습니다. 각각의 release 발표일은2026-10-22와2026-09-29 UTC입니다. Python1.45.2 발표일은2026-10-29 UTC이며 규약 버전과 SDK 버전은 다릅니다.
specification1.62.0 발표 원문에는 로그 부록의 journald 매핑 추가와 syslog 매핑 정비가 있습니다. 이번 글은 최신판을 대조한 인수 기준이며 두 시각 구분이 이번에 새로 생겼다는 주장은 아닙니다. 라이브 문서의 판본과 릴리스 원문을 함께 확인했습니다.
알파카랩스의 AX 구축·운영 공개 안내는 운영 지표와 검수·감사 리포트를 설명합니다. 이 글은 그 협의에 사용할 로그 인수 관점을 정리한 자사 정보형 글입니다. 공개 안내는 자기표기이며 특정 수집기 납품 실적·성능·기간 보장의 근거로 사용하지 않습니다. 해당 페이지는 게시일 미표기, 확인일2026-11-22입니다.
다음 검토일은2026-12-22입니다. 그 전이라도 규약·SDK·수집 경로·저장소의 시각 매핑이나 화면 정렬이 바뀌면 합성 표본과 실제 수신값을 다시 대조합니다.
자주 묻는 질문#
ObservedTimestamp가 저장 완료 시각인가요?
수집 시스템의 OpenTelemetry 코드가 사건을 관측한 시각입니다. 최종 저장소의 적재 완료나 화면 표시 시각으로 단정하지 않습니다. 그런 시각이 필요하면 별도 필드와 수집 지점을 합의합니다.
발생 시각이 없으면 항상 현재 시각을 넣나요?
이번 Python API의 직접 생성자는 timestamp=None을 그대로 둡니다. observed_timestamp=None일 때 API 생성 시각을 채웠고, OTLP 왕복에서 발생값은0으로 읽혔습니다. 모든 핸들러가 같다고 가정하지 않습니다.
OTLP의 0을 실제 1970년 사건으로 봐도 되나요?
두 시간 필드의0은 미확인 또는 누락을 뜻합니다. 날짜로 변환하기 전에 그 의미를 처리합니다. 발생·관측이 모두0이면 이 설계예시는 표시 시각을 미확인으로 둡니다.
발생값이 관측값보다 크면 로그를 버려야 하나요?
이 시험은 그 이유만으로 버리지 않았습니다. 시계 오차와 매핑·수집 경로를 조사할 수 있도록 원본과 차이를 보존하는 설계입니다. 실제 허용 범위와 보류 정책은 운영 환경에서 합의합니다.
이 표만 통과하면 업무 순서와 지연도 검증되나요?
표는 합성 입력의 SDK·OTLP 값과 표시용 선택 함수를 확인합니다. 업무 순번·인과관계·운영 시계 동기화·수집기·네트워크·저장소는 시험하지 않았습니다. 실제 인수에서 별도 대조가 필요합니다.
로그 시각 인수표에 무엇을 준비할까요?#
로그 시각 인수표 초안을 정리합니다
첫 범위 협의에서 비식별 로그의 원본 시간 필드·시계 주체·표시와 정렬 규칙을 대조한 로그 시각 인수표 초안을 정리합니다. 소요 시간은 수집 경로와 검수 범위를 확인한 뒤 안내합니다.
로그 시각 인수표 초안 협의