文档 Grafana Alloy 介绍 向后兼容性

Grafana Alloy向后兼容性

Grafana Alloy遵循语义版本控制。可能会出现需要在不发布新主版本的情况下进行破坏性更改的异常。Alloy是稳定的，我们努力在次要和补丁版本之间保持向后兼容性。

作为一般可用发布的文档化功能受向后兼容性的保护，包括

• 用户配置，包括Alloy配置语法、配置文件语义以及命令行界面。

• API，适用于任何作为v1.0.0或更高版本发布的网络或代码API。

• 官方仪表板中使用的可观测性数据，官方仪表板集合位于alloy-mixin/目录。

异常

我们力求保持向后兼容性，但可能会出现需要在不发布新主版本的情况下进行破坏性变更的情况，这与semver规范的第八项相悖。

• 安全性：可能出现需要破坏兼容性的安全问题。

• 法律要求：如果暴露的行为违反了许可或法律要求，可能需要进行破坏性变更。

• 规范错误：如果发现某个特性的规范不完整或不一致，修复规范可能需要破坏性变更。

• 错误：如果发现一个与该功能文档规范不符的错误，修复错误可能需要破坏兼容性，以使用户不依赖于错误的行为。

• 上游变更：Alloy的大部分功能都建立在其他软件之上，如OpenTelemetry Collector和Prometheus。如果上游软件破坏了兼容性，我们可能需要在Alloy中反映这一点。

• 社区组件：社区组件是由社区实现和维护的组件。它们不受向后兼容策略的覆盖。

我们尽力在不破坏兼容性的情况下解决这些问题。