Rust OTLP JSON exemplar: 지표 값과 연결된 예제 값의 보존
지표 본체가 읽힌다는 사실과 exemplar의 wire 계약이 보존된다는 사실을 따로 시험해야 한다.
Rust OTLP JSON exemplar: 지표 값과 연결된 예제 값의 보존
지표 본체가 수집됐다는 사실만으로 그 지표에 연결된 exemplar 값도 남았다고 판단하기 어렵다. JSON 구조가 소비자의 계약과 다르면 주 지표는 보이는데 진단에 필요한 예제만 빠질 수 있다. 본체와 exemplar를 서로 다른 보존 항목으로 확인해야 교환 상태를 정확히 알 수 있다. [1, 2, 3]
공개 원문이 보여 준 범위
Rust opentelemetry-proto의 with-serde 경로가 Exemplar value를 잘못 중첩해 다른 OTLP JSON 생산자·Collector와 교환할 때 값이 사라진다는 보고다. 현재 Rust SDK의 exemplar 기록 지원 범위와 proto 직접 사용을 구분했다. [1]
입력과 출력에서 확인할 관계
canonical exemplar와 Rust 직렬화 exemplar를 같은 소비자에 전달하여 지표 본체와 exemplar 값을 각각 대사한다. producer, metric_id, exemplar_value_present, decoded_exemplar_value를 연결하면 본체가 남아 있다는 이유로 연결된 예제의 손실을 놓치지 않는다. 호환 해독 경로와 스키마 확인은 대사 전에 수행한다. [1, 3]
승인 기준과 실패 사례
설명용 exemplar에는 정수값 7이 있다. 다시 읽은 뒤 값 존재 상태가 present이면 보존 조건을 충족하지만 absent이면 지표 본체가 남았더라도 교환을 승인하지 않는다. 이 사례는 exemplar 값의 유지를 다루며 영향을 받지 않은 지표까지 오염됐다고 추론하지 않는다. 별도 상태를 기록해야 어느 부분이 사라졌는지 소비자에게 정확히 전달할 수 있다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ColumnPairValidator는 exemplar 식별자로 연결한 원천·해독 후 값 존재 상태를 비교할 수 있다. 원시 OTLP JSON을 해독하는 호환 adapter와 공식 스키마 검사는 앞단에 둔다. metric 본체와 exemplar를 한 성공 플래그로 합치지 않아야 한다. [1, 2, 3]
다른 선택이 필요한 조건
이 보고는 proto 타입 직접 생성·해독 경로의 범위이며 모든 Rust SDK metric 전송이 exemplar를 잃는다는 뜻이 아니다. ProtoJSON 호환 encoder·decoder와 실제 Collector round-trip을 별도 확인한다. exemplar를 사용하지 않는 workload에서는 이 형태 차이가 현재 metric 본체 손실의 근거가 되지 않는다. [1, 3]
적용 조건
producer, metric_id, exemplar_value_present, decoded_exemplar_value 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
ProtoJSON 호환 encoder·decoder와 실제 Collector round-trip을 별도 확인한다.
한계
이 보고는 proto 타입 직접 생성·해독 경로의 범위이며 모든 Rust SDK metric 전송이 exemplar를 잃는다는 뜻이 아니다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
