新的配置模式候选版本发布

OpenTelemetry 配置模式的 最新版本于本周发布。这标志着配置工作组在三年的努力后，离完成又近了一步，也使该模式离标记为稳定又近了一步。我们可能很乐观，但我们认为这可能是稳定版本发布前的最后一个候选版本。

自上次发布以来，存储库中的许多更改都涉及工具的改进，以使模式更加一致，并减少将来引入新不一致的可能性。其他更改影响了最终用户、配置模式的贡献者以及模式的实现者。

最终用户更改

发布说明中包含有关所有重大更改的信息。一个值得注意的更改是将 `tls` 配置分组到各种 OTLP 导出器下，并将其包含的选项重命名，以更紧密地与 OpenTelemetry Collector 的 configtls 包保持一致。

# Before
tracer_provider: # or meter_provider, logger_provider
  processors:
    - batch:
        exporter:
          otlp_http:
            certificate_file: /app/cert.pem
            client_key_file: /app/key.pem
            client_certificate_file: /app/client_cert.pem
---
# After
tracer_provider:
  processors:
    - batch:
        exporter:
          otlp_http:
            tls:
              ca_file: /app/cert.pem
              key_file: /app/key.pem
              cert_file: /app/client_cert.pem

log_level 以前是字符串值，以匹配 `OTEL_LOG_LEVEL` 的现有规范。在此版本中，它已更改为支持日志记录规范中已 定义的 相同的严重性级别。本月早些时候，我们宣布了 Zipkin 导出器的弃用。因此，此新版本的模式也删除了该导出器。各种属性的验证也得到了改进。

最后，该模式现在会为所有属性填充 `description` 字段，从而为用户在编辑配置文件时提供急需的上下文。

描述字段使最终用户更容易理解他们正在编辑的配置的详细信息，并且还可以帮助语言实现。许多实现使用代码生成工具自动生成配置模式的代码表示。在支持它的工具中，描述字段会自动生成模型属性的文档。

贡献者

早期版本的 JSON 模式被拆分到 `schema` 目录下的多个文件中。在此候选版本中，这一情况已得到改变。现在，该目录包含用于生成存储在存储库根目录中的单个文件的 YAML 源文件。新格式的源文件与存储库中的工具相结合，可以更一致地生成文档、示例和 生成的 JSON 模式。对于希望做出贡献的任何人，请阅读 贡献文档中有关工具和流程的更多详细信息。

实验性功能

当您查看该模式或一些示例文件时，您可能会问为什么会有带有 `development` 后缀的配置选项。与 OpenTelemetry 的许多领域一样，随着规范的稳定，配置模式将继续发展。用于标识模式中实验性功能的机制是后缀 `*/(development|alpha|beta)`。这已记录在 版本文档中。实验性功能的用户应注意，实验性部分中提供的选项可能会发生变化。

不确定从哪里开始？请访问该模式的 文档页面，了解有关所有可用配置选项的更多信息。我们很想听听您对最新版本模式的反馈！

• ←上一篇
• 下一篇→