菜单
文档面包屑箭头 Grafana Alloy面包屑箭头 简介面包屑箭头 后向兼容性
开源

Grafana Alloy 后向兼容性

Grafana Alloy 遵循语义化版本控制可能出现无需新的主要版本但需要进行重大更改的例外情况。Alloy 是稳定的,我们努力保持次要版本和补丁版本之间的后向兼容性。

作为通用版本发布的文档化功能受后向兼容性覆盖,包括

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

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

  • 官方仪表盘中使用的可观测性数据,官方仪表盘集可在 alloy-mixin/ 目录中找到。

例外情况

我们努力保持后向兼容性,但可能出现无需新的主要版本但需要进行重大更改的例外情况,这偏离了语义化版本控制规范的第 8 条

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

  • 法律要求:如果公开的行为违反了许可或法律要求,可能需要进行重大更改。

  • 规范错误:如果发现某个功能的规范不完整或不一致,修复该规范可能需要进行重大更改。

  • Bug:如果发现与该功能的文档化规范相悖的 Bug,修复 Bug 可能需要破坏依赖于不正确行为的用户的兼容性。

  • 上游更改:Alloy 的许多功能构建在其他软件之上,例如 OpenTelemetry Collector 和 Prometheus。如果上游软件破坏了兼容性,我们可能需要在 Alloy 中反映这一点。

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

我们尽量在可能的情况下解决这些问题,而不破坏兼容性。