可观测性支持

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

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

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

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

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

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

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

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

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

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

需要默认容器工厂来启用注解支持， 但请注意，@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 过滤器。 它默认使用 org.springframework.http.server.observation.DefaultServerRequestObservationConvention，由 ServerRequestObservationContext 提供支持。

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

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

应用程序需要使用 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 提供支持。