发布日期: 2025-05-02
版本号: v3.4.0-rc.0

该版本包含多项功能更新、增强与错误修复。配置方面，当设置out_of_order_time_window大于零并启用native-histograms特性时，乱序原生直方图功能现在默认启用，--enable-feature=ooo-native-histograms选项已变为无操作。OTLP转换新增特性标志，可选择将OpenTelemetry显式桶直方图转换为具有自定义桶的原生直方图；同时新增选项支持接收不经过名称或属性转换的OTLP指标。PromQL解析器现允许在持续时间中使用算术运算。OTLP接收器增加了对增量指标的原始摄入支持。功能增强包括为桶直方图添加了histogram_fraction，为WAL/WBL重放添加了未知引用追踪指标，以及为抓取配置和全局配置新增了相关选项。性能方面优化了Kubernetes端点切片发现的效率。错误修复涵盖了配置文件的自动重载、禁用摄入时跳过原生直方图系列、重放期间重复系列的元数据处理、有效时间范围外的示例处理、PromQL特性标志的添加、告警名称与模板数据的日志记录，以及为标准差和方差函数使用算术平均数等问题。

更新内容 （中文）

  • [变更] 配置：使设置乱序原生直方图功能（--enable-feature=ooo-native-histograms）变为无实际操作。当 out_of_order_time_window 大于零且设置了 --enable-feature=native-histograms 时，乱序原生直方图现已始终启用。#16207
  • [功能特性] OTLP 转换：新增功能标志，可选择性地将 OpenTelemetry 显式桶直方图转换为具有自定义桶的原生直方图。#15850
  • [功能特性] OTLP 转换：新增选项以接收 OTLP 指标而不转换名称或属性。#16441
  • [功能特性] PromQL：允许在 PromQL 解析器中对持续时间进行算术运算。#16249
  • [功能特性] OTLP 接收器：新增原始支持，以原样接收 OTLP 增量指标。#16360
  • [增强功能] PromQL：为桶直方图添加 histogram_fraction。#16095
  • [增强功能] TSDB：添加 prometheus_tsdb_wal_replay_unknown_refs_total 和 prometheus_tsdb_wbl_replay_unknown_refs_total 指标，用于跟踪 WAL/WBL 重放期间未知的序列引用。#16166
  • [增强功能] 采集：添加配置选项以转义方案请求。#16066
  • [增强功能] 配置：添加全局配置选项以将经典直方图转换为直方图坐标桶。#16226
  • [增强功能] 告警：使批处理大小可配置（--alertmanager.notification-batch-size）。#16254
  • [性能] Kubernetes 服务发现：使 EndpointSlice 发现更高效。#16433
  • [错误修复] 配置：修复规则和采集配置文件变更时的自动重载。#16340
  • [错误修复] 采集：如果禁用摄取，则跳过原生直方图序列。#16218
  • [错误修复] TSDB：在 WAL 重放期间处理重复序列的元数据/墓碑/样例。#16231
  • [错误修复] TSDB：在 WAL 重放期间避免处理有效时间范围之外的样例。#16242
  • [错误修复] Promtool：为 PromQL 功能添加功能标志。#16443
  • [错误修复] 规则：正确记录告警名称和模板数据。#15093
  • [错误修复] PromQL：histogram_stddev() 和 histogram_stdvar() 使用算术平均值。#16444

更新内容 （原始）

  • [CHANGE] Config: Make setting out-of-order native histograms feature (--enable-feature=ooo-native-histograms) a no-op. Out-of-order native histograms are now always enabled when out_of_order_time_window is greater than zero and --enable-feature=native-histograms is set. #16207
  • [FEATURE] OTLP translate: Add feature flag for optionally translating OTel explicit bucket histograms into native histograms with custom buckets. #15850
  • [FEATURE] OTLP translate: Add option to receive OTLP metrics without translating names or attributes. #16441
  • [FEATURE] PromQL: allow arithmetic operations in durations in PromQL parser. #16249
  • [FEATURE] OTLP receiver: Add primitive support for ingesting OTLP delta metrics as-is. #16360
  • [ENHANCEMENT] PromQL: histogram_fraction for bucket histograms. #16095
  • [ENHANCEMENT] TSDB: add prometheus_tsdb_wal_replay_unknown_refs_total and prometheus_tsdb_wbl_replay_unknown_refs_total metrics to track unknown series references during WAL/WBL replay. #16166
  • [ENHANCEMENT] Scraping: Add config option for escaping scheme request. #16066
  • [ENHANCEMENT] Config: Add global config option for convert_classic_histograms_to_nhcb. #16226
  • [ENHANCEMENT] Alerting: make batch size configurable (--alertmanager.notification-batch-size). #16254
  • [PERF] Kubernetes SD: make endpointSlice discovery more efficient. #16433
  • [BUGFIX] Config: Fix auto-reload on changes to rule and scrape config files. #16340
  • [BUGFIX] Scraping: Skip native histogram series if ingestion is disabled. #16218
  • [BUGFIX] TSDB: Handle metadata/tombstones/exemplars for duplicate series during WAL replay. #16231
  • [BUGFIX] TSDB: Avoid processing exemplars outside the valid time range during WAL replay. #16242
  • [BUGFIX] Promtool: Add feature flags for PromQL features. #16443
  • [BUGFIX] Rules: correct logging of alert name & template data. #15093
  • [BUGFIX] PromQL: Use arithmetic mean for histogram_stddev() and histogram_stdvar() . #16444

下载链接