RATATOSKRATATOSK
로그인

Prometheus

v3.9.0Observability
2026년 1월 7일

ACTION 1CHECK 1OTHER 34

이번 릴리스는 네이티브 히스토그램 수집 설정과 TSDB 상태 조회 한도를 조정합니다. 익스포터에서 해당 샘플을 수집하거나 TSDB 상태 엔드포인트를 사용하는 환경이 영향을 받습니다.

조치 필요 (1)

  • breakingTSDB status endpoint 통계 집합 수 제한

    TSDB status endpoint가 제공하는 통계 집합 수의 최대 한도가 10,000개로 설정됩니다.

영향 확인 (1)

  • breakingnative-histogram 플래그를 대신하는 scrape_native_histograms 설정

    익스포터에서 네이티브 히스토그램 샘플을 수집하는 경우에 적용됩니다.

    3.9부터 네이티브 히스토그램은 실험 기능이 아니며, native-histogram 플래그는 더 이상 동작에 영향을 주지 않습니다. 익스포터의 네이티브 히스토그램 샘플 수집에는 scrape_native_histograms 설정이 필요합니다.

그 외 기록된 변경 34건 전체fixes 16 · additions 9 · value changes 6 · constraints 3

fixes (16)

  • - [BUGFIX] UI: PromQL autocomplete now shows the correct type and HELP text for OpenMetrics counters whose samples end in _total. #17682
  • - [BUGFIX] UI: Fixed codemirror-promql incorrectly showing label completion suggestions after the closing curly brace of a vector selector. #17602
  • - [BUGFIX] UI: Query editor no longer suggests a duration unit if one is already present after a number. #17605
  • - [BUGFIX] PromQL: Fix some "vector cannot contain metrics with the same labelset" errors when experimental delayed name removal is enabled. #17678
  • - [BUGFIX] PromQL: Fix possible corruption of PromQL text if the query had an empty ignoring() and non-empty grouping. #17643
  • - [BUGFIX] PromQL: Fix resets/changes to return empty results for anchored selectors when all samples are outside the range. #17479
  • - [BUGFIX] PromQL: Check more consistently for many-to-one matching in filter binary operators. #17668
  • - [BUGFIX] PromQL: Fix collision in unary negation with non-overlapping series. #17708
  • - [BUGFIX] PromQL: Fix collision in label_join and label_replace with non-overlapping series. #17703
  • - [BUGFIX] PromQL: Fix bug with inconsistent results for queries with OR expression when experimental delayed name removal is enabled. #17161
  • - [BUGFIX] PromQL: Ensure that rate/increase/delta of histograms results in a gauge histogram. #17608
  • - [BUGFIX] PromQL: Do not panic while iterating over invalid histograms. #17559
  • - [BUGFIX] TSDB: Reject chunk files whose encoded chunk length overflows int. #17533
  • - [BUGFIX] TSDB: Do not panic during resolution reduction of invalid histograms. #17561
  • - [BUGFIX] Remote-write Receive: Avoid duplicate labels when experimental type-and-unit-label feature is enabled. #17546
  • - [BUGFIX] OTLP Receiver: Only write metadata to disk when experimental metadata-wal-records feature is enabled. #17472

additions (9)

  • - [FEATURE] API: Add /api/v1/features for clients to understand which features are supported. #17427
  • - [FEATURE] Promtool: Add start_timestamp field for unit tests. #17636
  • - [FEATURE] Promtool: Add --format seriesjson option to tsdb dump to output just series labels in JSON format. #13409
  • - [FEATURE] Add --storage.tsdb.delay-compact-file.path flag for better interoperability with Thanos. #17435
  • - [FEATURE] UI: Add an option on the query drop-down menu to duplicate that query panel. #17714
  • - [ENHANCEMENT]: TSDB: add flag --storage.tsdb.block-reload-interval to configure TSDB Block Reload Interval. #16728
  • - [ENHANCEMENT] UI: Add graph option to start the chart's Y axis at zero. #17565
  • - [ENHANCEMENT] Notifications: Add a histogram prometheus_notifications_latency_histogram_seconds to complement the existing summary. #16637
  • - [ENHANCEMENT] TSDB: New histogram prometheus_tsdb_sample_ooo_delta, the distribution of out-of-order samples in seconds. Collected for all samples, accepted or not. #17477

value changes (6)

  • In version 3.9, Native Histograms is no longer experimental, and the feature flag native-histogram has no effect. You must now turn on the config setting scrape_native_histograms to collect Native Histogram samples from exporters.
  • - [ENHANCEMENT] SD: add a config label with job name for most prometheus_sd_refresh metrics. #17138
  • - [ENHANCEMENT] Remote-read: Validate histograms received via remote-read. #17561
  • - [PERF] TSDB: Small optimizations to postings index. #17439
  • - [PERF] Scraping: Speed up relabelling of series. #17530
  • - [PERF] PromQL: Small optimisations in binary operators. #17524, #17519.

constraints (3)

  • - [ENHANCEMENT] Scraping: Classic protobuf format no longer requires the unit in the metric name. #16834
  • - [ENHANCEMENT] PromQL, Rules, SD, Scraping: Add native histograms to complement existing summaries. #17374
  • - [ENHANCEMENT] Remote-write: Add custom scope support for AzureAD authentication. #17483
Prometheus 스택에 추가

조치가 필요한 릴리스가 나왔을 때 주간 메일로 알려드립니다. 이번 릴리스의 브레이킹 체인지 같은 것들입니다.

스택에 추가 →
공식 릴리스 노트 ↗Prometheus 릴리스 전체 →