Jaeger
v2.18.0ObservabilityJaeger v2.18.0은 OTEL 메트릭 구조 변경과 min-step API 제거라는 두 가지 브레이킹 체인지와 함께, ES/OpenSearch 헤더 포워딩, UI 상태 관리의 Redux→Zustand 전환 등 굵직한 변화를 담고 있습니다.
breaking업그레이드 전 메트릭 대시보드 전수 점검
OTEL 컬렉터 패키지 업그레이드로 Jaeger 내부 메트릭 이름과 구조가 바뀌었습니다. Grafana 대시보드, Prometheus 알림 규칙, 모니터링 쿼리를 모두 검토해야 합니다. 가능하면 구버전과 신버전을 병행 실행하며 메트릭 차이를 먼저 확인하세요. min_step 제거는 영향 범위가 좁지만, metricstore API를 직접 호출하는 커스텀 도구가 있다면 반드시 코드 수정 후 업그레이드해야 합니다.
enhancement커스텀 헤더 인증을 쓴다면 헤더 포워딩 기능 즉시 활용 가능
ES/OpenSearch 클러스터에 JWT나 IAM 프록시 헤더 같은 커스텀 인증 헤더가 필요한 환경이라면, 이번에 추가된 헤더 포워딩 기능이 기존 workaround를 대체할 수 있습니다. 멀티 테넌트 환경에서 요청 헤더로 스토리지 라우팅을 제어하는 구성에도 그대로 적용됩니다. jaeger-query 또는 gRPC 스토리지 플러그인 설정에서 구성하면 됩니다.
enhancementClickHouse 단일 스토리지로 트레이스와 SPM을 함께 쓸 수 있는 시점 임박
ClickHouse SPM이 이번 릴리스에서 호출률, 오류율, 지연시간을 모두 지원하게 됐고 TTL도 추가됐습니다. 아직 실험적 단계라 프로덕션 투입은 이르지만, ClickHouse를 이미 운영 중이거나 Prometheus 없이 SPM을 쓰고 싶다면 지금 스테이징 환경에서 테스트를 시작하기 좋은 타이밍입니다.
주요 변경 (6)
- 브레이킹: OTEL 컬렉터 패키지 업그레이드로 메트릭 이름과 구조 변경 — 기존 대시보드와 알림 규칙 검토 필수
- 브레이킹: metricstore에서 min_step API 제거 — 해당 엔드포인트를 직접 호출하는 도구는 수정 필요
- 신규: UI가 브라우저 URL에서 베이스 경로를 자동 감지 — 리버스 프록시 환경에서 수동 설정 불필요
- 신규: ES/OpenSearch 및 gRPC 스토리지 백엔드로 커스텀 헤더 포워딩 가능 — 인증 토큰 전달에 유용
- 실험적: ClickHouse SPM이 호출률, 오류율, 지연시간 및 TTL 지원까지 갖추며 빠르게 성숙 중
- UI 브레이킹: 구형 브라우저 지원 중단 — IE 및 매우 오래된 Chromium/Firefox 사용자는 영향 받음