# Jaeger v2.21.0

> Observability · 2026-09-14

호환성을 깨뜨리는 API 및 설정 변경과 실험적 검색 및 스토리지 기능 확장을 담은 릴리스입니다. 정확성 수정과 의존성 업데이트도 포함됩니다.

## 조치 필요
- **[breaking]** `searchdepth` 값 범위 제한
  - `searchdepth`를 최대 10000으로 제한하고 음수 값을 거부합니다.

## 영향 확인
- **[breaking]** `v1 http endpoints` 제거
  - `v1 http endpoints`를 사용하는 경우에 적용됩니다.
  - UI가 더 이상 호출하지 않는 `v1 http endpoints`를 제거했습니다.
- **[breaking]** `ai.enable_mcp`를 선택적 `ai.mcp` 설정 블록으로 변경
  - `ai.enable_mcp`를 설정하는 경우에 적용됩니다.
  - `ai.enable_mcp`를 선택적 `ai.mcp` 설정 블록으로 교체했습니다.
- **[breaking]** 지원하지 않는 Elasticsearch 설정 키 거부
  - 적용 대상이 릴리스 노트에 명시되지 않았습니다.
  - 지원하지 않는 `elasticsearch config keys` 5개를 시작 시 거부합니다.
- **[breaking]** 스토리지 백엔드가 처리할 수 없는 검색 거부
  - 적용 대상이 릴리스 노트에 명시되지 않았습니다.
  - 스토리지 백엔드가 처리할 수 없는 검색 요청을 거부합니다.

## 그 밖에 기록된 변경
- 64 (defect_corrected 29, added 18, value_changed 10, constraint_changed 3, renamed 2, removed 1, default_changed 1)

[분석 자세히 보기](https://ratatosk.io/ko/releases/jaeger/v2.21.0)

[원본 릴리스 노트](https://github.com/jaegertracing/jaeger/releases/tag/v2.21.0)