# Prometheus v3.16.0

> Observability · 2026-11-05

운영자가 확인할 기본값과 입력 검증이 바뀌었고, PromQL과 히스토그램 처리도 확장되었습니다. 저장소, API, 수집, 원격 쓰기 전반의 성능과 정확성 개선이 포함된 릴리스입니다.

## 조치 필요
- **[breaking]** Remote Write 2.0 메타데이터 메트릭 노출 중단
  - Remote Write 2.0 큐에서 더 이상 사용 중단된 `prometheus_remote_storage_metadata_total`, `prometheus_remote_storage_metadata_failed_total`, `prometheus_remote_storage_metadata_retried_total`, `prometheus_remote_storage_metadata_bytes_total` 메트릭을 노출하지 않습니다.
- **[breaking]** 중복 라벨 이름을 가진 exemplar 거부
  - 라벨 이름이 중복된 exemplar를 저장하지 않고 거부합니다. 이에 따라 `/api/v1/query_exemplars`에서 중복된 JSON 키가 반환되지 않습니다.
- **[breaking]** Smoothed 및 Anchored 벡터 선택자 상시 활성화
  - Smoothed 및 Anchored 벡터 선택자가 안정화되어 항상 활성화됩니다.
- **[breaking]** `timeout` 및 `lookback_delta` 오버플로 값 거부
  - `timeout`과 `lookback_delta`가 `int64` 범위를 넘으면 음수 기간으로 변환하지 않고 거부합니다.
- **[breaking]** 미래 타임스탬프 exemplar 처리 수정
  - 현재 시각보다 10분 넘게 미래인 타임스탬프를 가진 exemplar를 저장하지 않습니다. 해당 exemplar 때문에 같은 시계열의 후속 exemplar가 차단되지도 않습니다.
- **[breaking]** 버킷 인덱스 오버플로 네이티브 히스토그램 거부
  - 버킷 인덱스에서 span 오프셋이 `int32` 범위를 넘는 네이티브 히스토그램을 저장하지 않고 거부합니다.

## 영향 확인
- **[breaking]** 실험적 검색 엔드포인트의 `batch_size` 상한 조정
  - 실험적 검색 엔드포인트를 사용하는 경우 적용됩니다.
  - 실험적 검색 엔드포인트에서 `batch_size`가 1000을 넘지 않도록 제한됩니다.
- **[breaking]** TLS 활성화 시 `--web.external-url` 기본값 변경
  - `--web.config.file`을 사용하는 경우 적용됩니다.
  - `--web.config.file`로 TLS를 활성화하면 `--web.external-url`의 기본값이 `https`로 설정됩니다.
- **[breaking]** NHCB 변환 시 합계 전용 클래식 히스토그램 거부
  - `NHCB` 변환을 사용하는 경우 적용됩니다.
  - NHCB 변환 중 합계만 있는 클래식 히스토그램을 거부합니다.

## 그 밖에 기록된 변경
- 76 (defect_corrected 52, value_changed 14, added 10)

[분석 자세히 보기](https://ratatosk.io/ko/releases/prometheus/v3.16.0)

[원본 릴리스 노트](https://github.com/prometheus/prometheus/releases/tag/v3.16.0)