文档 Grafana Alloy 发行说明

Grafana Alloy 发行说明

本发行说明提供有关 Grafana Alloy 中已弃用功能和重大更改的信息。

有关 Grafana Alloy 的完整更改列表，以及可用的拉取请求和相关问题链接，请参阅更新日志。

v1.6

重大变更：组件 loki.source.kafka 中的 topics 参数默认不再使用正则表达式

loki.source.kafka 中的一个错误导致该组件将所有主题视为正则表达式。例如，将主题值设置为“telemetry”会匹配包含子字符串“telemetry”的任何主题。此版本中引入的修复使主题值现在默认被视为精确匹配。通过在主题前加上“^”，仍支持正则表达式匹配，从而允许其匹配多个主题。

重大变更：在使用 and_sub_policy 和 invert_match 时，更改 otelcol.processor.tail_sampling 中的决策优先级

Alloy v1.5 已升级至OpenTelemetry Collector v0.104.0，其中包含针对尾部采样处理器的一项修复。

之前，如果策略评估的决策是 NotSampled 或 InvertNotSampled，无论如何都会返回 NotSampled 决策，从而有效地降低了结果。这违反了文档中说明的反转决策应优先于所有其他决策的行为。

上面引用的“文档行为”可在处理器文档中找到

每个策略都会产生一个决策，处理器将对它们进行评估以做出最终决策

• 当存在“反转未采样”决策时，跟踪不会被采样；
• 当存在“采样”决策时，跟踪会被采样；
• 当存在“反转采样”决策且没有“未采样”决策时，跟踪会被采样；
• 在所有其他情况下，跟踪不会被采样

“反转”决策是基于“invert_match”属性做出的决策，例如来自字符串、数字或布尔标签策略的决策。

然而，在OpenTelemetry Collector v0.116.0中，此修复被回滚

回滚#33671，允许组合策略结合其他策略指定反转子句。此更改恢复了先前的状态，对依赖作为#33671一部分引入的功能的用户造成了影响。

v1.5

重大变更：更改 otelcol.processor.deltatocumulative 中 max_streams 的默认值

默认值从 0 更改为 9223372036854775807（最大整数）。

重大变更：更改 otelcol.connector.spanmetrics 中 namespace 的默认值

默认值从 "" 更改为 "traces.span.metrics"。

重大变更：组件 otelcol.exporter.logging 已被移除，推荐使用 otelcol.exporter.debug

这两个组件非常相似。更多信息可在公告问题中找到。

重大变更：更改 import.git 中 revision 的默认值

默认值从 "HEAD" 更改为 "main"。不再允许将 revision 设置为 "HEAD"、"FETCH_HEAD"、"ORIG_HEAD"、"MERGE_HEAD" 或 "CHERRY_PICK_HEAD"。

v1.4

重大变更：一些 otelcol 组件的调试指标已更改

例如，otelcol.exporter.otlp 的 exporter_sent_spans_ratio_total 指标现在是 otelcol_exporter_sent_spans_total。您可能需要更改您的仪表盘和警报设置以引用新指标。有关更多信息，请参阅每个组件的文档页面。

重大变更：otelcol.processor.transform 中的 convert_sum_to_gauge 和 convert_gauge_to_sum 函数更改了上下文

convert_sum_to_gauge 和 convert_gauge_to_sum 函数现在必须在 metric 上下文中使用，而不是在 datapoint 上下文中使用。这是由于上游更改。

重大变更：beyla.ebpf 中的指标已重命名

process.cpu.state 重命名为 cpu.mode，beyla_build_info 重命名为 beyla_internal_build_info。

v1.3

重大变更：remotecfg 块的参数名称从 metadata 更新为 attributes

remotecfg 块的参数名称已从 metadata 更新为 attributes。

v1.2

重大变更：remotecfg 块因 Agent 重命名而更新

remotecfg 块已更新，使用alloy-remote-config而非agent-remote-config。此更改使 remotecfg API 术语与 Alloy 一致，并包含更新的端点。