Spring Boot 2 JAX-RS AsyncResponse请求Micrometer不计数问题
问题场景
- 基于Spring Boot 2搭建JAX-RS风格的后端服务,接入Micrometer实现应用指标采集
- 默认配置下,内置的
http_server_requests_seconds_count指标可以正常统计常规同步接口的请求量、延迟数据,对GET、PUT等同步请求的统计运行正常 - 部分接口采用JAX-RS
AsyncResponse实现异步处理逻辑,示例代码如下:
@GET @Produces(APPLICATION_JSON) @Path("next/{position}") public void getNext( @PathParam("position") Long position, @Suspended final AsyncResponse response) throws InterruptedException { ... // 实际业务逻辑在其他线程执行,最终通过下述调用完成请求响应 response.resume(entity); ... }
- 当前存在的问题:这类异步处理的接口请求完全没有被纳入内置指标的统计范围,核心疑问包括两点:
- 是否存在框架内置配置项,可以直接开启对这类异步接口的计数统计
- 如果没有内置支持,是否需要在业务代码中手动实现逻辑,接入和原有规则一致的计数器完成指标统计
相关结论与适配方案
内置配置的可能性
目前没有专门的全局配置可以直接适配这类异步接口的统计需求。
内置Micrometer埋点的触发时机,是请求线程在JAX-RS接口方法执行完成后就立即结束统计链路:对同步接口来说,方法返回就代表响应已经处理完成,这个触发时机是准确的;但对采用AsyncResponse的异步接口来说,方法执行完成仅仅是把请求挂起,真正的响应完成节点是其他线程调用response.resume()的时刻,这个节点远晚于内置埋点的触发时机,因此会出现漏统计的问题。
手动适配的实现思路
不需要在每个异步接口的业务代码里逐段添加埋点逻辑。
可以通过统一的JAX-RS拦截器,全局捕获所有AsyncResponse的完成回调,在response.resume()真正触发响应写回容器的节点,调用Micrometer API上报指标。只要保证上报时使用的指标命名、标签维度和内置的http_server_requests_seconds完全对齐,最终的统计规则就和原有同步接口没有任何区别。
适配过程中需要注意两个细节,避免统计口径和原有逻辑不一致:
- 计算请求耗时的时候,起点要取请求最初进入Web容器的时间戳,不要取异步处理线程启动的时间,否则统计的延迟值会比真实值偏小
- 上报的标签要完全匹配内置埋点的维度,包括
uri、method、status、outcome,不要随意新增自定义标签,避免同一指标被拆成多套独立的时序序列,影响监控查询的结果一致性
内容的提问来源于stack exchange,提问作者Christian Schneider
相关产品推荐
相关产品推荐

