消息系统语义约定

正在使用 此文档 v1.24.0（或之前版本） 的现有消息传递仪器

• 在消息传递语义约定被标记为稳定之前，不应更改它们默认发出的消息传递约定版本。约定包括但不限于属性、指标和跨度名称、跨度种类和度量单位。
• 在现有主版本中，应引入一个名为 OTEL_SEMCONV_STABILITY_OPT_IN 的环境变量，该变量是一个逗号分隔的类别特定值列表（例如，http、databases、messaging）。值列表包括：
  • messaging - 发出新的、稳定的消息传递约定，并停止发出仪器先前发出的旧实验性消息传递约定。
  • messaging/dup - 同时发出旧的稳定消息传递约定和新的稳定消息传递约定，实现无缝过渡。
  • 默认行为（在没有这些值的情况下）是继续发出仪器先前发出的旧实验性消息传递约定的任何版本。
  • 注意：如果同时存在 messaging 和 messaging/dup，则 messaging/dup 的优先级高于 messaging。
• 在开始发出两组约定后，应至少维护现有主版本（至少进行安全修补）六个月。
• 应在下一个主版本中删除该环境变量。
• 当 messaging/dup 出现在列表中时，应为跨度名称、跨度种类和类似的“单一”值概念发出新的、稳定的值。