Micrometer 系列【12】MeterProvider 指标模板生成器

文章目录1. 动态标签 vs 静态标签1.1 静态标签1.2 动态标签2. 核心痛点2.1 重复样板代码配置难以统一管理2.2 高频调用持续创建临时对象增大 GC 压力3. 指标模板能力3.1 MeterProvider 接口3.2 标准模板写法3.2.1 初始化模板3.2.2 运行时仅传入动态标签3.2.3 上报指标结构1. 动态标签 vs 静态标签1.1 静态标签静态标签运行周期内取值固定业务执行前就确定不会随每次调用变化。代码示例Timer timer Timer.builder(job.execution) .tag(job.name, my-job) // 【静态标签】永久固定 .register(registry);上报样例job_execution_seconds_bucket{job_namemy-job}1.2 动态标签动态标签必须执行业务逻辑结束后才能获取值每次调用取值可变。业务中经常需要动态追加标签如接口执行状态、任务结果代码示例TimertimerTimer.builder(job.execution).tag(job.name,my-job)// 【静态标签】永久固定.tag(status,result.status())// 【动态标签】执行完成才能拿到结果.register(registry);上报样例job_execution_seconds_bucket{job_namemy-job,statussuccess,le0.5} job_execution_seconds_bucket{job_namemy-job,statusfail,le0.5}2. 核心痛点常规直接构建Timer/Counter的写法存在两大缺陷每次构建都会新建Builder对象频繁创建大量临时对象加重GC压力重复编写大量固定指标配置指标名、静态标签、描述、直方图等样板代码冗余。2.1 重复样板代码配置难以统一管理job.execution、job.name“my-job” 属于固定信息每次埋点重复编写如果后续需要开启直方图、百分位、指标描述必须在每一处埋点新增代码极易漏改、配置不一致。增加直方图配置后的原始写法冗余更加明显TimertimerTimer.builder(job.execution).tag(job.name,my-job).tag(status,result.status()).description(任务执行耗时).publishPercentileHistogram().publishPercentiles(0.5,0.95,0.99).register(registry);2.2 高频调用持续创建临时对象增大 GC 压力每次执行都会新建Timer.Builder对象、内部临时Tag对象。误区澄清MeterRegistry会缓存最终生成的Timer实例相同标签组合不会重复创建Timer但是Builder、临时Tag对象每次调用都会新建属于短命对象高并发场景频繁触发Young GC。3. 指标模板能力MeterProvider提供指标模板能力预先定义指标固定配置作为模板运行时仅传入动态变化的标签复用模板生成指标减少对象创建、精简代码。核心优势模板全局仅初始化一次运行时不再创建Builder大幅减少GC临时对象固定配置统一管理修改一处全局生效消除重复样板代码输出指标与传统写法完全一致无业务逻辑变更。仅以下4类计量器支持MeterProviderCounter、Timer、LongTaskTimer、DistributionSummary。3.1 MeterProvider 接口MeterProvider是Meter接口的内部接口基于一套通用模板templateBuilder通过传入标签生成Meter实例。接口定义interfaceMeterProviderTextendsMeter{TwithTags(Iterable?extendsTagtags);defaultTwithTags(String...tags){returnwithTags(Tags.of(tags));}defaultTwithTag(Stringkey,Stringvalue){returnwithTags(Tags.of(key,value));}}3.2 标准模板写法之前的写法TimertimerTimer.builder(http.server.requests).description(HTTP接口请求耗时统计).publishPercentiles(0.5,0.9,0.99).tags(method,GET,uri,/api/query,status,200).register(registry);改造分析静态标签methodGET、uri/api/query接口固定不变动态标签status请求结束后才能确定200/400/500固定配置指标名称、描述、百分位配置放入模板一次性定义3.2.1 初始化模板只执行一次构建指标模板// 全局模板建议声明为Bean/成员变量项目启动初始化privatefinalMeterProviderTimerhttpQueryTimerProviderMeterProvider.builder(http.server.requests,Timer::builder)// 静态标签固定不变固化在模板.withTag(method,GET).withTag(uri,/api/query)// 统一指标配置.withConfigurator(builder-builder.description(HTTP接口请求耗时统计).publishPercentiles(0.5,0.9,0.99)).register(registry);3.2.2 运行时仅传入动态标签业务运行阶段仅传入动态标签Timer.SamplesampleTimer.start(registry);// 执行业务逻辑inthttpStatushandleRequest();// 只传递动态标签status不再重复构建BuilderTimertimerhttpQueryTimerProvider.withTag(status,String.valueOf(httpStatus));sample.stop(timer);如果存在多个动态标签// 多个动态标签使用 withTagsTimertimerhttpQueryTimerProvider.withTags(Tag.of(status,String.valueOf(httpStatus)),Tag.of(result,isSuccess?success:fail));3.2.3 上报指标结构模板静态标签 运行传入动态标签合并http_server_requests_seconds_bucket{methodGET,uri/api/query,status200,le0.1} http_server_requests_seconds_bucket{methodGET,uri/api/query,status500,le0.1}