Micrometer项目中HTTP客户端指标采集的404状态码处理优化

背景介绍

Micrometer作为一款流行的应用指标采集库，提供了对多种HTTP客户端的指标采集支持。在早期的版本中，HTTP客户端指标采集对404状态码等特殊HTTP状态进行了特殊处理，这种设计源于服务器端指标采集的考量，但在客户端场景下却显得不太合理。

问题分析

在服务器端监控场景中，对404状态码进行特殊处理是有意义的，因为：

1. 服务器无法预知客户端请求的路径是否存在
2. 频繁变更的API路径可能导致指标基数爆炸
3. 404错误通常由客户端错误引起而非服务端问题

然而，在HTTP客户端监控场景下，这种特殊处理就显得不太适用了：

1. 客户端完全掌控自己发出的请求
2. 客户端应该对请求的URL有效性负责
3. 特殊处理反而可能掩盖真实的客户端行为

解决方案

Micrometer团队决定移除HTTP客户端指标采集中对404状态码的特殊处理，这一变更涉及多个流行的HTTP客户端实现：

1. OkHttp客户端指标采集
2. Jetty客户端指标采集
3. Apache HTTP客户端(同步和异步)
4. JDK内置HTTP客户端

技术实现细节

在具体实现上，移除了对404等状态码的过滤逻辑，使得这些状态码的请求也能被正常记录到指标中。同时保留了URL映射器的安全默认实现，确保即使不做特殊处理也不会导致指标基数爆炸问题。

对于使用自定义URL映射器的用户，如果之前依赖了框架对404的特殊处理逻辑，需要自行在映射器实现中添加相应的过滤逻辑。

兼容性考虑

这一变更属于行为变更，但考虑到：

1. 默认URL映射器仍保持安全行为
2. 客户端场景下用户对请求有完全控制权
3. 特殊处理在客户端场景本就不合理

因此被评估为合理的改进方向。对于确实需要保留旧行为的用户，可以通过自定义URL映射器来实现。

总结

这次改进使得Micrometer对HTTP客户端的指标采集行为更加合理和一致，移除了源于服务器端考量的特殊处理逻辑，让指标更能真实反映客户端的实际行为。这也是监控领域"所见即所得"原则的体现，有助于用户更准确地理解和分析系统行为。