선언형 OpenTelemetry 설정

Declarative OpenTelemetry configuration

계측 구성을 파일로 정의해 여러 언어에서 같은 모델을 사용합니다.

···
html
<div class="demo"><div class="title">CONFIG FILE → SIGNALS</div><div class="scene"><div class="config-file" id="config-file">config-a.yaml<br>traces: on<br>metrics: off</div><div class="config-arrow">→</div><div class="config-signals"><span id="signal-trace">traces</span><span id="signal-metric">metrics</span></div></div></div>
css
.demo{width:min(94vw,690px);height:min(88vh,320px);box-sizing:border-box;padding:clamp(9px,2.5vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);color:var(--fg);font:600 clamp(12px,2.4vmin,16px)/1.25 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);display:flex;flex-direction:column;gap:clamp(7px,2vmin,14px);overflow:hidden}.title{color:var(--accent);font:700 clamp(12px,2.4vmin,16px)/1.2 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);letter-spacing:.04em}.scene{flex:1;min-height:0;position:relative;display:flex;align-items:center;justify-content:center;overflow:hidden}.scene{gap:7px}.config-file{width:45%;box-sizing:border-box;padding:8px;border:1px solid var(--line);border-radius:6px;background:var(--bg);font:600 clamp(12px,2.4vmin,15px)/1.3 ui-monospace,monospace;white-space:nowrap}.config-arrow{color:var(--accent);font-size:22px}.config-signals{flex:1;display:grid;gap:8px}.config-signals span{padding:8px 3px;border:1px solid var(--line);border-radius:6px;text-align:center;color:var(--muted);transition:background .3s,border-color .3s,color .3s}.config-signals span.on{border-color:var(--accent);color:var(--fg);background:color-mix(in srgb,var(--accent) 15%,var(--surface))}
js
let a=true;function draw(){document.getElementById("config-file").innerHTML=(a?"config-a.yaml<br>traces: on<br>metrics: off":"config-b.yaml<br>traces: on<br>metrics: on");document.getElementById("signal-trace").classList.add("on");document.getElementById("signal-metric").classList.toggle("on",!a);a=!a}draw();setInterval(draw,1250)

OpenTelemetry 선언형 설정은 YAML 파일에 SDK 구성 요소를 기술하는 공통 모델입니다. 2026년 핵심 스키마와 파일 표현이 안정화되어 환경 변수만으로 표현하기 어려운 설정을 일관된 형태로 적을 수 있습니다.

데모는 두 설정 파일을 번갈아 선택해 수집 경로가 어떻게 구성되는지 보여줍니다. 설정 규격이 안정화됐더라도 언어별 구현 범위는 다르므로 실제 SDK 지원을 확인해야 합니다. 파일 선택 시연은 실행 중 설정 변경 기능을 뜻하지 않습니다.

언제 쓰나

여러 서비스의 계측 구성을 파일로 관리하고 비교할 때 사용합니다.

페이지로 열기 ↗