可观测性支持

让我们以 Spring MVC “http.server.requests”指标插桩与 ServerHttpObservationFilter 为例。 此观测使用 ServerRequestObservationConvention 和 ServerRequestObservationContext；可以在 Servlet 过滤器上配置自定义约定。 如果您想自定义观测生成的元数据，可以根据您的要求扩展 DefaultServerRequestObservationConvention：

如果您想完全控制，可以为感兴趣的观测实现整个约定契约：

您还可以使用自定义 ObservationFilter 实现类似目标——为观测添加或删除键值。 过滤器不会替换默认约定，而是用作后处理组件。

您可以在 ObservationRegistry 上配置 ObservationFilter 实例。

当 JMS 消息发送到消息代理时，会记录 "jms.message.publish" 观测。 它们测量发送消息所花费的时间，并通过传出的 JMS 消息头传播跟踪信息。

您需要配置 JmsTemplate 上的 ObservationRegistry 以启用观测：

它默认使用 io.micrometer.jakarta9.instrument.jms.DefaultJmsPublishObservationConvention，并由 io.micrometer.jakarta9.instrument.jms.JmsPublishObservationContext 支持。

当响应消息从侦听器方法返回时，@JmsListener 注解方法会记录类似的观测。

当 JMS 消息由应用程序处理时，会记录 "jms.message.process" 观测。 它们测量处理消息所花费的时间，并通过传入的 JMS 消息头传播跟踪上下文。

大多数应用程序将使用 @JmsListener 注解方法机制来处理传入消息。 您需要确保在专用的 JmsListenerContainerFactory 上配置了 ObservationRegistry：

需要一个默认的容器工厂来启用注解支持， 但请注意，@JmsListener 注解可以引用特定的容器工厂 bean 以用于特定目的。 在所有情况下，只有当在容器工厂上配置了观测注册表时，才会记录观测。

当 MessageListener 处理消息时，JmsTemplate 会记录类似的观测。 此类侦听器在会话回调中设置在 MessageConsumer 上（请参阅 JmsTemplate.execute(SessionCallback<T>)）。

此观测默认使用 io.micrometer.jakarta9.instrument.jms.DefaultJmsProcessObservationConvention，并由 io.micrometer.jakarta9.instrument.jms.JmsProcessObservationContext 支持。

应用程序需要在其应用程序中配置 org.springframework.web.filter.ServerHttpObservationFilter Servlet 过滤器。

这只会将观测记录为错误，如果 Exception 未被 Web 框架处理并已冒泡到 Servlet 过滤器。 通常，所有由 Spring MVC 的 @ExceptionHandler 和 ProblemDetail 支持处理的异常都不会被观测记录。 您可以在请求处理的任何时候自行在 ObservationContext 上设置错误字段：

应用程序需要使用 MeterRegistry 配置 WebHttpHandlerBuilder 以启用服务器插桩。 这可以在 WebHttpHandlerBuilder 上完成，如下所示：

它默认使用 org.springframework.http.server.reactive.observation.DefaultServerRequestObservationConvention，并由 ServerRequestObservationContext 支持。

这只会将观测记录为错误，如果 Exception 未被应用程序控制器处理。 通常，所有由 Spring WebFlux 的 @ExceptionHandler 和 ProblemDetail 支持处理的异常都不会被观测记录。 您可以在请求处理的任何时候自行在 ObservationContext 上设置错误字段：

默认情况下，会创建以下 KeyValues：

应用程序必须在 RestTemplate 实例上配置 ObservationRegistry 以启用插桩；否则，观测将是“空操作”。 Spring Boot 将自动配置已设置观测注册表的 RestTemplateBuilder bean。

插桩默认使用 org.springframework.http.client.observation.ClientRequestObservationConvention，并由 ClientRequestObservationContext 支持。

应用程序必须在 RestClient.Builder 上配置 ObservationRegistry 以启用插桩；否则，观测将是“空操作”。

插桩默认使用 org.springframework.http.client.observation.ClientRequestObservationConvention，并由 ClientRequestObservationContext 支持。

应用程序必须在 WebClient.Builder 上配置 ObservationRegistry 以启用插桩；否则，观测将是“空操作”。 Spring Boot 将自动配置已设置观测注册表的 WebClient.Builder bean。

插桩默认使用 org.springframework.web.reactive.function.client.ClientRequestObservationConvention，并由 ClientRequestObservationContext 支持。