Spring AI 1.0-RC1版本中观测性配置的调整与解决方案

在Spring AI 1.0-RC1版本中，开发团队对观测性（Observability）相关配置进行了重要调整。这些变更主要涉及Chat和VectorStore模块的观测属性命名规范，但同时也带来了一些需要开发者注意的兼容性问题。

配置属性变更说明

新版本中将原有的观测属性名称进行了优化：

• 原spring.ai.chat.observations.include-prompt变更为spring.ai.chat.observations.log-prompt
• 原spring.ai.chat.observations.include-completion变更为spring.ai.chat.observations.log-completion
• VectorStore模块也进行了类似的调整

这一变更旨在使属性命名更加清晰直观，明确表达其日志记录功能。然而，在实现过程中，ChatObservationProperties类中遗漏了对应的logCompletion字段及其setter方法，导致配置时可能出现未知属性警告。

观测机制的架构调整

更值得开发者注意的是，RC1版本对观测机制进行了架构层面的重构：

1. 从追踪(Tracing)转向日志(Logging)：早期版本会将提示词(prompt)等内容附加到追踪span中，而新版本改为通过标准日志输出。这种设计变更主要是考虑到：

   • 大文本内容更适合通过日志系统处理
   • 日志系统本身可以包含traceId和spanId，仍能与追踪系统关联
   • 避免了追踪系统中传输大文本的性能问题

2. 日志与追踪的协同：虽然内容不再直接附加到span，但日志中会包含追踪ID，开发者仍可通过日志后端查询特定追踪相关的详细内容。

解决方案与替代方案

对于需要恢复旧版行为的开发者，可以考虑以下方案：

1. 自定义观测过滤器：通过实现类似ChatClientPromptContentObservationFilter的自定义组件，可以将内容重新附加到追踪span中。这种方式需要开发者自行权衡性能影响。

2. 使用日志收集方案：结合如zipkin-otel等工具，可以将日志内容作为span的注解重新注入追踪系统，实现两全其美的效果。

3. 社区扩展项目：已有社区成员将移除的处理器和过滤器重构为独立项目，未来可能纳入Spring AI社区扩展中。

最佳实践建议

1. 对于新项目，建议适应新的日志观测模式，充分利用现代日志系统的强大功能。

2. 对于需要与旧系统兼容的场景，可考虑上述替代方案，但需注意性能影响。

3. 密切关注Spring AI官方更新，预计后续版本会进一步完善观测性相关的文档和示例代码。

Spring AI团队表示，虽然存在这些实现细节上的调整，但核心观测功能在RC1版本中仍能正常工作。开发者可以继续按照文档使用新的属性名称，同时等待官方对实现细节的进一步完善。