OTLP 트레이스 부분 성공 검수, HTTP 200에서 거절을 찾는 법
OTLP 트레이스 전송의 HTTP 200에서 전량 수락과 경고, 일부 스팬 거절을 구분합니다. 응답 JSON 예제와 검수표로 같은 요청을 재시도할지 판단합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
2026년 11월, OTLP/HTTP 200에서 스팬이 거절되면 부분 수락, 거절 0에 경고가 있으면 전량 수락입니다. 두 경우 모두 요청을 재시도하지 않습니다.
자동화 워커가 트레이스 내보내기를 마쳤다고 표시해도 수집기가 일부 스팬만 받았을 수 있습니다. 전송 로그에서 HTTP 상태와 응답 본문을 같이 보면 어느 지점부터 조사할지 좁힐 수 있습니다.
HTTP 200의 본문에서 무엇을 확인하나요?#
OpenTelemetry의 OTLP/HTTP 응답 규격에서 전량 수락과 일부 수락은 모두 HTTP 200을 사용합니다. 응답의 Content-Type에 따라 JSON 또는 바이너리 Protobuf의 ExportTraceServiceResponse로 먼저 해석합니다. 트레이스 응답에서는 partialSuccess 안의 rejectedSpans와 errorMessage를 함께 확인합니다.
- 일부 스팬이 거절되면 거절 건수가 양수입니다. 설명이 생략돼도 판정은 같습니다.
- 거절 건수가 0이고 설명이 있으면 수집기가 전량을 수락하면서 경고나 제안을 보낸 경우입니다.
- 필드가 없거나 빈 객체로 해석되면 전량 수락으로 처리합니다. 트레이스 응답 정의는 빈 부분 성공 메시지의 기본값을 거절 0과 빈 설명으로 정의합니다.
응답 표본으로 무엇을 시험하나요?#
같은 OTLP/HTTP 트레이스 전송 구간에 아래 가상 응답을 넣고 수락 상태와 재시도 여부를 확인합니다. 200 사례는 공식 Protobuf 메시지의 JSON 디코딩과 바이너리 직렬화 후 역변환을 시험했습니다. 오류 상태는 판정 규칙만 시험했습니다.
| 응답 조건 | 운영 판정 |
|---|---|
| 200 · 부분 성공 필드 없음 | 전량 수락 |
| 200 · 빈 부분 성공 객체 | 전량 수락 |
| 200 · 거절 0, 경고 있음 | 전량 수락·경고 기록·재시도 금지 |
| 200 · 거절 2, 설명 있음 | 부분 수락·재시도 금지 |
| 200 · 거절 2, 설명 없음 | 부분 수락·재시도 금지 |
| 429 · 처리량 제한 | 재시도 권고 |
| 503 · 일시적 수신 불가 | 재시도 권고 |
| 400 · 영구적인 입력 오류 | 재시도 금지 |
다음은 일부 스팬을 거절한 HTTP 200 응답의 JSON 예입니다. rejectedSpans는 Protobuf의 64비트 정수라 표준 JSON 인코딩에서 문자열로 표시합니다.
{
"partialSuccess": {
"rejectedSpans": "2",
"errorMessage": "Rejected spans contained invalid fields."
}
}
일부를 거절하면 같은 요청을 다시 보내나요?#
부분 수락 응답을 받으면 같은 요청을 재시도하지 않습니다. 거절 수는 들어 있지만 거절된 개별 스팬 ID 목록은 없습니다. 이미 받은 스팬까지 다시 보내면 중복이 생길 수 있어, 운영 표에는 거절 수와 수집기 진단을 남기고 원인을 확인합니다.
429나 503은 OTLP가 재시도를 권고하는 HTTP 오류입니다. Retry-After가 있으면 따르고, 없으면 지수 백오프가 권고됩니다. 영구적인 입력 오류인 400에는 같은 요청을 재전송하지 않습니다. 표는 예시 세 코드로 한정하며, 전체 목록은 OTLP 재시도 상태 코드를 확인합니다.
수집기가 수락한 결과는 바로 응답한 서버까지의 확인입니다. 이후 저장이나 화면 표시가 빠졌는지는 다음 전달 구간과 저장소를 따로 대조합니다. HTTP 200 본문을 해석하지 못하면 운영 화면에는 수락 미확인으로 남기는 편이 좋습니다.
어떤 출처로 확인했나요?#
OTLP 1.11.1 고정판은 2026년 9월 29일 공식 릴리스로 공개됐습니다. 트레이스 Export 메시지 정의와 함께 2026년 11월 16일 확인했습니다. 표의 수치와 응답은 검수용 가상 예시입니다.
알파카랩스의 업무 자동화·API 연동 개발 범위는 예외 확인, 재처리와 운영 인수 조건을 협의 항목으로 안내합니다. 수신 전 스팬의 맥락이 끊기는 문제는 배치 메시지의 스팬 링크 검수, 수신된 값을 집계하는 문제는 누적 카운터 검수에서 확인할 수 있습니다.
자주 묻는 질문#
HTTP 200이면 모든 스팬이 수집됐나요?
OTLP/HTTP에서 HTTP 200은 전량 수락과 부분 수락에 모두 쓰입니다. 트레이스 응답의 partialSuccess와 rejectedSpans를 확인해야 바로 응답한 서버가 몇 건을 거절했는지 알 수 있습니다.
거절이 0건인데 설명이 있는 이유는 뭔가요?
서버가 전량을 수락하면서 경고나 제안을 보낼 수 있습니다. 수락은 성공으로 집계하고 경고 문구는 별도로 남깁니다.
partialSuccess가 빈 객체면 어떻게 처리하나요?
거절 건수가 0이고 설명도 비어 있는 메시지는 부분 성공 필드가 없는 경우와 같은 의미입니다. 응답 본문을 정상적으로 해석한 뒤 전량 수락으로 분류합니다.
거절된 스팬만 다시 보낼 수 있나요?
표준 응답에는 거절 건수가 들어갑니다. 응답만으로 개별 거절 스팬을 고를 수 없으며, 부분 수락 뒤에 같은 요청을 재시도하면 안 됩니다.
수신 서버가 수락하면 저장과 화면 표시도 끝났나요?
수락은 이 전송에 응답한 서버까지의 결과입니다. 다음 구간 전달이나 저장소 적재, 화면 조회가 필요하면 각각 확인합니다.
인수를 위해 어떤 표를 남기나요?#
트레이스 수집의 인수 기준을 정리합니다
첫 범위 협의에서 비식별 전송 응답과 수집 구간을 대조해 전량 수락·부분 수락·재시도 판정표 초안을 정리합니다. 소요 시간은 표본과 수신 구간을 확인한 뒤 협의합니다.
트레이스 수집 검수표 초안 협의