知识卡片
公共库优先依赖稳定API
公共库一旦把遥测调用编进自身,许多应用会间接依赖该 API。稳定功能适合原生嵌入,让应用装入 SDK 后即可取得埋点;实验功能宜作为可选插件,使其破坏性变更不拖累普通用户升级。这是公共库依赖面的治理原则,是否某功能已稳定仍要按目标语言及版本核对。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《OpenTelemetry 可观测性的未来》第6章《稳定和长期支持》(源文件:_epub-src/index_split_059.html)
- 结论依据:原文建议 OSS 库原生仪表只使用稳定 API,实验性集成作为用户另装的可选插件,功能稳定后再考虑原生集成。
- 原始内容:携带原生 OpenTelemetry 仪表的 OSS 库应该只使用稳定的 API,因为实验性功能的改变可能会造成依赖性冲突。……我们建议将与实验性 OpenTelemetry 功能的集成作为可选的插件提供,终端用户必须单独安装才能启用。