1. 概述

官方文档
GitHub 地址
美式发音：/maɪˈkrɑːmɪtər/

1.1 框架简介

Micrometer是一款面向 JVM 应用、无厂商绑定的可观测性门面框架，可以类比为可观测领域的SLF4J。它为市面上主流的监控、可观测性组件埋点客户端提供了一套统一、简洁的抽象门面，让开发者只需编写一套通用的埋点代码，即可适配各类监控系统，彻底解决监控厂商锁定问题。

通过Micrometer采集的各类可观测数据，可用于实时观测系统运行状态、配置异常告警、快速响应和处理线上突发问题，是Java微服务、分布式系统可观测性建设的核心基础组件。

Micrometer是JVM生态的统一指标埋点标准，是Spring Boot默认监控框架。它屏蔽了Prometheus、Datadog、InfluxDB、Graphite等各类监控系统的差异，提供一套无厂商绑定、高性能、可移植的指标埋点API。

本文系统性讲解Micrometer核心概念、注册表、计量器类型、过滤器、速率聚合、生产最佳实践，是Java服务可观测性落地完整指南。

1.2 三大核心项目

Micrometer官方可观测体系分为三大独立维护支撑体系，分别负责指标监控、分布式追踪、上下文传播，三者各司其职、层层协作，共同构成完整的JVM应用可观测能力，且均拥有独立的官方版本生命周期与支持策略。

三者分层协作，构成Spring生态标准的「指标+链路+日志」一体化可观测体系。

1.2.1 Micrometer

仓库地址

这是Micrometer最基础、最核心的官方支撑体系，核心指标框架。主要负责JVM应用指标采集、统一指标门面、多监控平台适配，支撑所有计数器、仪表盘、计时器等维度化指标能力。

Micrometer开源仓库采用多模块Gradle工程结构，职责划分清晰、分层明确，完美适配多监控适配、多版本JDK兼容、可观测一体化等能力。以下为仓库完整目录结构与详细释义：

• micrometer-core：核心核心模块，包含指标SPI、五大指标模型（Counter/Gauge/Timer等）、内存注册器、基础埋点能力，是所有功能的基石。

• benchmarks：性能压测模块，基于 JMH 框架对指标采集、链路追踪核心逻辑做性能基准测试，保障框架高性能低损耗。

• concurrency-tests：并发测试模块，专门用于高并发场景下的线程安全、指标累加、资源竞争稳定性测试。

• config：工程公共配置目录，统一管控代码规范、格式化、静态检查等全局配置。

• docs：官方文档源码目录，包含官网文档、使用指南、核心概念文档。

• gradle：Gradle构建脚本目录，包含版本插件、依赖统一管理、构建扩展配置。

• implementations：第三方监控后端适配实现合集，所有监控平台的注册器、上报逻辑统一存放于此。

• micrometer-bom：BOM 版本管控模块，用于统一全局依赖版本，解决版本冲突，是项目推荐引入的版本管理组件。

• micrometer-commons：公共工具基础模块，存放通用工具类、常量、基础封装，供所有子模块复用。

• micrometer-jakarta9：适配Jakarta 9生态的兼容模块，适配新版JavaEE规范。

• micrometer-java11：基于Java 11的专属适配与兼容模块，适配JDK11新特性与语法。

• micrometer-java21：基于Java 21的专属适配模块，适配新版LTS特性、虚拟线程等新能力。

• micrometer-jetty11：适配Jetty 11服务器的监控埋点模块。

• micrometer-jetty12：适配Jetty 12服务器的监控埋点模块。

• micrometer-observation：统一可观测核心模块，提供Observation API，实现指标、链路、日志一体化埋点能力。

• micrometer-observation-test：Observation可观测能力的专用测试模块。

• micrometer-test：通用测试基础库，提供测试基类、模拟注册器、断言工具，统一所有模块测试能力。

• micrometer-test-aspectj-ctw：AspectJ 编译期织入（CTW）测试模块，用于 AOP 埋点编译期增强测试。

• micrometer-test-aspectj-ltw：AspectJ 加载时织入（LTW）测试模块，用于运行时动态 AOP 增强测试。

• micrometer-osgi-test：OSGI容器环境适配测试模块，适配模块化容器部署场景。

• micrometer-osgi-test-slf4j2：结合SLF4J2的OSGI环境适配测试模块。

• src：工程公共源码目录，存放顶层公共代码。

• samples：官方示例工程，提供各类监控接入、埋点使用、多平台适配的 Demo 案例，供开发者参考学习。

• scripts：脚本目录，包含打包、发布、版本迭代、文档生成自动化脚本。

1.2.2 Micrometer Tracing

仓库地址

Micrometer Tracing专属官方支撑体系，是Spring Cloud Sleuth的替代技术方案，专注于分布式链路追踪能力维护。基于Brave、OpenTelemetry实现链路Span的创建、上报、生命周期管理，支持OTLP、Zipkin、Wavefront等多后端推送。

1.2.3 Micrometer Context Propagation

仓库地址

Micrometer Context Propagation是可观测体系的底层上下文通信支撑组件，为指标、链路追踪提供跨线程、跨异步、跨服务的上下文传递能力。专门解决ThreadLocal、Reactor异步上下文、线程池切换导致的traceId、spanId丢失问题。

该组件独立迭代、独立维护，作为Tracing与Observation的底层依赖，官方持续维护上下文适配规则、异步场景兼容、跨协议（HTTP/MQ）透传能力，是分布式链路串联、日志链路关联、全链路可观测的基础保障。

1.3 设计目标

Micrometer是面向JVM应用的指标埋点工具库，核心目标：

• 解耦监控厂商：一套埋点代码，适配所有主流监控系统，无厂商锁定；

• 极低性能损耗：指标采集几乎无开销，不影响主业务流程；

• 高可移植性：指标命名、标签、统计逻辑统一，跨监控平台无缝迁移；

• 完整可观测能力：覆盖指标、链路观测，可对接分布式追踪与日志体系。

从Micrometer 1.10开始，官方提供Observation API与插件机制，原生支持链路追踪能力，彻底统一指标、追踪、日志的观测入口。

2. 核心特性

2.1 主流框架原生集成

Micrometer已深度适配主流Java云原生框架，无需复杂改造，可直接沿用框架原生的编码规范和配置体系快速接入。支持框架包括：Spring、Quarkus、Micronaut、Helidon等。

2.2 开箱即用的通用埋点能力

核心包micrometer-core及官方配套组件库内置了大量通用组件的埋点逻辑，覆盖接口请求、线程、缓存、数据库等常见场景，绝大多数业务组件无需开发者手动编写埋点代码，大幅降低可观测性接入成本。

2.3 全环境兼容，灵活切换监控后端

Micrometer支持对接市面上绝大多数可观测数据存储与监控平台，开发者可以沿用现有监控体系，也可以随时无痛切换监控后端，无需修改业务埋点代码，灵活性极强。

支持的主流监控后端：Prometheus、Datadog、Dynatrace、Azure Monitor、AWS CloudWatch、Elastic、Influx/Telegraf、StatsD、JMX、OTLP、New Relic等二十余款平台。

2.4 标准维度化指标模型

框架提供厂商无关的标准化指标抽象，内置计数器（Counter）、仪表盘（Gauge）、计时器（Timer）、分布摘要（Distribution Summary）、长任务计时器（Long Task Timer）等核心指标类型。

基于维度化数据模型，对接支持维度指标的监控平台后，可实现指标精准检索、多维度数据下钻、精细化业务观测，满足复杂场景的监控分析需求。

2.5 专业分布式追踪能力

Micrometer Tracing是Spring Cloud Sleuth的官方继任方案，对Brave、OpenTelemetry主流追踪器进行统一门面封装。支持从单条用户请求视角，完整梳理分布式系统调用链路，精准定位微服务调用中的异常节点、耗时瓶颈，快速排查线上故障根因。

2.6 统一可观测一体化能力

Micrometer Observation API是一套大一统的可观测抽象接口，实现一次埋点，多效产出。仅需编写一次观测代码，即可同时生成指标数据、分布式追踪链路、日志等多类可观测数据，且全程保证元数据统一一致，解决多组件观测数据割裂的问题。

通过Micrometer Observation与Micrometer Tracing，可基于OpenZipkin Brave、OpenTelemetry追踪器，将链路Span数据推送至Zipkin、Wavefront等各类分布式追踪后端，全方位覆盖指标、链路、日志一体化可观测场景。

2.7 多监控平台并行上报

通过Micrometer提供的CompositeMeterRegistry（复合指标注册器），支持同时配置多个监控注册实现，实现一份指标数据并行上报至多个不同监控后端，满足多平台备份、差异化观测的业务需求。

3. 版本说明

3.1 正式稳定版本（GA）

Micrometer的GA（General Availability）正式稳定版本是经过完整测试、社区验证、可安全用于生产环境的官方正式版本，是企业项目、线上业务的首选版本。

GA版本版本号为纯数字格式（如1.17.0），无任何后缀，统一发布至Maven Central中央仓库，版本稳定、BUG少、长期维护，官方会持续推送安全补丁与bug修复更新，保障生产环境稳定运行。

3.2 快照版本（Snapshot）

Micrometer主分支、维护分支（如1.7.x）每次构建成功后，都会发布最新快照版本，用于体验未正式发布的新功能。使用快照版本需额外引入Spring快照仓库：repo.spring.io/snapshot，版本号示例：1.8.0-SNAPSHOT。

3.3 里程碑版本（Milestone）

里程碑版本仅用于早期功能测试、技术预览，禁止用于生产环境。此类版本发布至Maven Central，在GitHub标记为预发布版本，版本号携带后缀区分：-M1（首个里程碑版本）、-RC1（首个候选发布版本）。

3.4 最新版本

正式发布时间：2026 年 06 月

截至目前Micrometer最新正式稳定版本为1.17.0，，是官方主推的生产首选版本，适配 主流云原生技术栈，相比旧版本在性能、内存占用、安全性、功能完备性上均有大幅优化。

使用建议：所有新业务、线上生产环境优先使用1.17.0最新稳定版，旧版本项目建议逐步升级迭代，获得更好的性能与安全保障。

3.5 版本支持

Micrometer和Spring一样，官方将版本维护分为两个支持阶段，所有版本均有明确的生命周期，开源版本的维护基本都是只支持一年：

5. 发展历史

Micrometer是Spring生态推出的JVM 应用可观测门面框架，专为解决早期Java监控体系厂商绑定、指标模型单一、链路与指标割裂等问题而生，是现代Spring云原生可观测体系的核心基石，整体发展历程清晰且贴合云原生技术演进趋势。

4.1 2016 年：项目诞生，定位行业标准门面

Spring团队正式创建Micrometer项目，核心定位为可观测领域的SLF4J，旨在提供一套无厂商绑定、统一通用的指标埋点抽象，解决传统监控框架适配单一、切换成本高的痛点，初步奠定Java统一指标采集的技术标准。

4.2 2018 年：Spring Boot 2.0 默认集成，全面普及

Micrometer正式成为Spring Boot 2.0内置默认指标采集组件，全面替代旧版Dropwizard Metrics监控体系。依托Spring生态的庞大用户基数，快速成为Java微服务监控的事实标准，大幅降低企业微服务可观测性的接入门槛。

4.3 2022 年：可观测一体化升级，Tracing 正式独立

推出全新Observation API，实现一次埋点，多效产出，打通指标、链路、日志一体化可观测能力。同年11月，Micrometer Tracing 1.0.0 GA正式发布，全面接替退役的Spring Cloud Sleuth项目，成为Spring生态官方唯一分布式追踪解决方案。

4.4 2023–2024 年：云原生标准化适配

深度完善OpenTelemetry、OTLP协议适配能力，全面对齐云原生可观测规范，强化多平台并行上报、维度化指标分析能力，完美适配Spring Boot 3.x全新技术栈，适配大规模云原生集群运维场景。

5.5 2026 年：持续迭代，稳定成熟

发布当前最新稳定版1.17.0，持续优化采集性能、修复安全漏洞、提升兼容性，目前框架生态成熟、社区活跃，已成为Java/JVM应用可观测性建设的行业首选基础框架。

6. 官方维护团队

6.1 项目归属与主体

Micrometer目前隶属于Broadcom（博通）旗下。项目原为VMware Spring官方开源项目，隶属于Spring可观测性团队（Spring Observability Team）；2023年11月22日 Broadcom 正式完成对 VMware 全资收购，因此现阶段所有Spring生态开源项目（包含Micrometer）均归属Broadcom体系，由原Spring官方团队持续全职维护迭代。

6.2 核心核心维护者与负责人

项目由Spring生态知名技术专家、Java Champion获得者Marcin Grzejszczak主导维护，同时也是Spring Cloud、可观测体系核心负责人，深度主导了Micrometer Tracing接替Spring Cloud Sleuth的整体技术演进。

Jonatan Ivanov（GitHub：jonatan-ivanov），VMware资深软件工程师、Java Champion，隶属于Spring可观测性团队，是micrometer-metrics与spring-projects官方核心维护者。深耕分布式系统、云原生可观测领域，长期负责框架指标模型优化、多协议适配、版本迭代维护，同时是技术演讲者、西雅图JUG联合组织者，活跃于全球Java开源社区。

Tommy Ludwig（GitHub：shakuzen），micrometer-metrics与spring-projects官方核心维护者，专注Micrometer各类监控适配模块迭代、兼容性修复、社区PR审核与版本质量管理，保障多监控后端生态的稳定兼容与持续迭代。

团队由Spring开源工程高级经理Jason Konicki统筹管理，同时包含多名Spring官方核心Committer（Tadaya Tsuyukubo、Johnny Lim等），专职负责代码迭代、协议适配、漏洞修复、版本发布与官方文档维护，收购后团队架构与维护节奏保持稳定不变。

6.3 社区协作模式

Micrometer采用官方团队主导 + 全球社区共建模式：核心架构、版本规划、兼容性规范由官方团队全权把控；全球开发者可通过GitHub提交Issue、PR、功能需求，参与框架优化迭代。

官方开放公开Slack工作区，作为官方答疑、需求讨论、技术交流的统一渠道，社区活跃度高、迭代稳定、问题响应及时。