知识卡片

普通读书笔记卡 · 3201.b.2.a

稳定埋点接口降低升级成本

理解等级:高级

监测 API 会散布在大量库与应用调用点中,破坏兼容性会让不同组件的埋点版本互相冲突,并迫使应用批量修改。稳定的核心接口应长期向后兼容,实验能力则与稳定部分隔离。稳定性是库作者愿意原生埋点的前提;它约束的是公开契约,不代表内部 SDK 和管道实现都不能演进。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《OpenTelemetry 可观测性的未来》第4章《支持开源和原生监测》(源文件:_epub-src/index_split_035.html) - 结论依据:原文指出仪表 API 可有数千个调用点,破坏兼容会造成大量更新及库之间的冲突,并要求实验功能不要干扰稳定埋点。 - 原始内容:一个精心设计的应用程序最终可能会有成千上万的仪表调用站点。由于 API 的改变而不得不更新数以千计的调用站点是一个相当大的工作量。……新的、实验性的 API 功能的开发方式必须保证它们的存在不会在包含稳定仪表的库之间产生冲突。