micrometer

micrometer-metricsApache-2.0活跃维护

Java 应用可观测性门面,统一对接主流监控系统,像 SLF4J 之于日志那样屏蔽底层差异,采集指标无需绑定具体后端。

An application observability facade for the most popular observability tools. Think SLF4J, but for observability.

v1.17.2发布于 2026-10-23 03:46 UTC4,909star1,158fork同步于 2026-11-10 17:38 UTC

怎么上手

由 README 提炼,执行前请确认
implementation 'io.micrometer:micrometer-core'
硬件要求按 README 说明

README 未说明,仅要求 Java 8 或更高版本(micrometer-java11、micrometer-jetty11 等模块例外)

支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

面向主流监控后端的应用指标门面,用厂商中立接口埋点,后端可最后再定

Java 应用可观测性门面,统一对接主流监控系统,像 SLF4J 之于日志那样屏蔽底层差异,采集指标无需绑定具体后端。

核心能力

  • 用厂商中立的维度指标接口埋点代码
  • 像 SLF4J 一样做观测门面,解耦埋点与后端
  • 支持 Java 8 及以上,个别模块需更高版本
  • 快照版发布到 repo.spring.io 供尝鲜

容易踩的坑

快照版需额外添加 repo.spring.io/snapshot 仓库;里程碑版本仅供测试,不建议用于生产;部分模块如 micrometer-java11 需要高于 Java 8 的版本

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.17.2
  1. v1.18.0-RC21.18.0-RC2pre-release2026-11-05 · 2026-11-05 20:18 UTC
    查看更新说明

    :warning: Noteworthy

    • Atlas FunctionTimer behavior change: AtlasMeterRegistry now publishes FunctionTimer statistics (count and totalTime) as per-second rates instead of gauges (#8108). With the default 1-minute step, published values will be ~60x lower than before; any dashboard queries or alert rules dividing by 60 should be updated. See the 1.18 Migration Guide for details.

    :star: New Features

    • Support fractional updates for Atlas counters #8109

    :hammer: Dependency Upgrades

    • Bump com.dynatrace.metric.util:dynatrace-metric-utils-java from 2.5.0 to 2.6.0 #8145
    • Bump software.amazon.awssdk:cloudwatch from 2.56.0 to 2.57.8 #8138
    • Bump com.google.cloud:google-cloud-monitoring from 3.100.0 to 3.101.0 #8135
    • Bump com.google.auth:google-auth-library-oauth2-http from 1.54.0 to 1.55.0 #8134
    • Bump com.google.cloud:libraries-bom from 26.90.0 to 26.91.0 #8133
    • Bump com.netflix.spectator:spectator-reg-atlas from 1.10.8 to 1.10.9 #8115
    • Bump io.netty:netty-bom from 4.2.19.Final to 4.2.20.Final #8146

    :memo: Tasks

    • Keep HdrHistogram types out of TimeWindowPercentileHistogram signature #8118

    :heart: Contributors

    Thank you to all the contributors who worked on this release:

    @brharrington

  2. v1.18.0-RC11.18.0-RC1pre-release2026-10-23 · 2026-10-23 04:13 UTC
    查看更新说明

    :hammer: Dependency Upgrades

    • Bump software.amazon.awssdk:cloudwatch from 2.55.16 to 2.56.0 #8078
    • Bump com.netflix.spectator:spectator-reg-atlas from 1.10.7 to 1.10.8 #7984
    • Bump com.google.auth:google-auth-library-oauth2-http from 1.53.0 to 1.54.0 #8024
    • Bump com.google.cloud:google-cloud-monitoring from 3.99.0 to 3.100.0 #8026
    • Bump com.google.cloud:libraries-bom from 26.89.0 to 26.90.0 #8023
    • Bump io.netty:netty-bom from 4.2.18.Final to 4.2.19.Final #8041
    • Bump io.opentelemetry:opentelemetry-bom from 1.66.0 to 1.67.0 #8056
    • Bump io.prometheus:prometheus-metrics-bom from 1.9.0 to 1.10.0 #8091

    :heart: Contributors

    Thank you to all the contributors who worked on this release:

    @anjeongkyun

  3. v1.17.21.17.2最新正式版2026-10-23 · 2026-10-23 03:46 UTC

    :lady_beetle: Bug Fixes

    • Preserve whitespace in HTTP Basic authentication passwords #8015
    • Missing reflection hint for getProcessCpuTime #7911
    • Proxy JMS session results using the method's declared return type #7896
    • Kotlin interoperability for CaffeineCacheMetrics broken/requires unchecked cast to work #7582
    • Registering/Updating a MultiGauge while a Prometheus scrape occurs can lead to DuplicateLabelsException #6851
    • OTLP histogram bucket count does not equal count intermittently #6006
    • Statsd UDP epoll warn logs are verbose when statsd is down #2624

    :notebook_with_decorative_cover: Documentation

    • Fix typos in docs #8000
    • Add docs for @MeterTag when used on a method #7829
    • Document best practice about configuring registries on a composite #7367
    • Documentation on SpelValueExpressionResolver is unclear #6465
    • Document how to customize tags in micrometer-java11 HttpClient instrumentation #4962

    :hammer: Dependency Upgrades

    • Bump io.netty:netty-bom from 4.2.18.Final to 4.2.19.Final #8042

    :heart: Contributors

    Thank you to all the contributors who worked on this release:

    @Gaurav1112, @LindseyZ1205, @bogdandrutu, @pchesneau, @cfcromn, @schiemon, @officialasishkumar, @AzazelSensei, @nick-montana, @ghdtjdwn, @ninadsutrave

  4. v1.16.81.16.82026-10-23 · 2026-10-23 02:25 UTC
    查看更新说明

    :lady_beetle: Bug Fixes

    • Preserve whitespace in HTTP Basic authentication passwords #8015
    • Missing reflection hint for getProcessCpuTime #7911
    • Proxy JMS session results using the method's declared return type #7896
    • Kotlin interoperability for CaffeineCacheMetrics broken/requires unchecked cast to work #7582
    • Registering/Updating a MultiGauge while a Prometheus scrape occurs can lead to DuplicateLabelsException #6851
    • OTLP histogram bucket count does not equal count intermittently #6006
    • Statsd UDP epoll warn logs are verbose when statsd is down #2624

    :notebook_with_decorative_cover: Documentation

    • Fix typos in docs #8000
    • Add docs for @MeterTag when used on a method #7829
    • Document best practice about configuring registries on a composite #7367
    • Documentation on SpelValueExpressionResolver is unclear #6465
    • Document how to customize tags in micrometer-java11 HttpClient instrumentation #4962

    :hammer: Dependency Upgrades

    • Bump io.netty:netty-bom from 4.1.138.Final to 4.1.139.Final #8040

    :heart: Contributors

    Thank you to all the contributors who worked on this release:

    @Gaurav1112, @LindseyZ1205, @bogdandrutu, @pchesneau, @cfcromn, @schiemon, @officialasishkumar, @AzazelSensei, @nick-montana, @ghdtjdwn, @ninadsutrave

  5. v1.18.0-M21.18.0-M2pre-release2026-09-24 · 2026-09-24 18:53 UTC
    查看更新说明

    :warning: Noteworthy

    • Deprecate for removal the registry for EOL AppOptics #7954
    • Remove EOL and deprecated Wavefront module #7625
    • Make inclusion of LongTaskTimer by DefaultMeterObservationHandler opt-in instead of opt-out #7312
    • State objects should not be nullable for function-based meter registration #6416

    :star: New Features

    • Send the Datadog API keys in the headers #7894
    • Update MultiGauge Gauges instead of remove/add #7851
    • Prometheus: reduce allocations for histogram buckets #7838
    • Skip registering Hazelcast meters when statistics are not enabled #7568
    • Include HTTP/2 GlobalRequestProcessor MBean in TomcatMetrics #7535
    • Introduce per-convention meter convention types and builder pattern #7369
    • Add Gauges for memory pool usage after GC #7296
    • Configure a custom JmsProcessObservationConvention or JmsPublishObservationConvention #5492

    :lady_beetle: Bug Fixes

    • Missing reflection hint for getProcessCpuTime #7911
    • Kotlin interoperability for CaffeineCacheMetrics broken/requires unchecked cast to work #7582
    • Registering/Updating a MultiGauge while a Prometheus scrape occurs can lead to DuplicateLabelsException #6851
    • OTLP histogram bucket count does not equal count intermittently #6006

    :notebook_with_decorative_cover: Documentation

    • Document best practice about configuring registries on a composite #7367

    :hammer: Dependency Upgrades

    • Bump com.google.auth:google-auth-library-oauth2-http from 1.50.0 to 1.52.0 #7928
    • Bump com.google.cloud:google-cloud-monitoring from 3.96.0 to 3.98.0 #7932
    • Bump com.google.cloud:libraries-bom from 26.86.0 to 26.88.1 #7948
    • Bump com.netflix.spectator:spectator-reg-atlas from 1.10.5 to 1.10.7 #7938
    • Bump dropwizard-metrics from 4.2.39 to 4.2.40 #7898
    • Bump io.netty:netty-bom from 4.2.17.Final to 4.2.18.Final #7943
    • Bump io.opentelemetry:opentelemetry-bom from 1.65.0 to 1.66.0 #7949
    • Bump io.prometheus:prometheus-metrics-bom from 1.8.0 to 1.9.0 #7966
    • Bump software.amazon.awssdk:cloudwatch from 2.51.3 to 2.55.0 #7968

    :memo: Tasks

    • Fix tests passing null state objects #7875
    • Upgrade minor versions of shaded OTel dependencies #7847
    • Remove EOL and deprecated Wavefront mod

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Micrometer Application Metrics

    Build Status Apache 2.0 Maven Central Javadocs Revved up by Develocity

    An application metrics facade for the most popular monitoring tools. Instrument your code with dimensional metrics with a vendor-neutral interface and decide on the monitoring backend at the last minute.

    More info on micrometer.io.

    Micrometer artifacts work with Java 8 or later with a few exceptions such as the micrometer-java11 module and micrometer-jetty11.

    Supported versions

    See Micrometer's support policy.

    Join the discussion

    Join the Micrometer Slack to share your questions, concerns, and feature requests.

    Snapshot builds

    Snapshots are published to repo.spring.io for every successful build on the main branch and maintenance branches.

    To use:

    repositories {
        maven { url 'https://repo.spring.io/snapshot' }
    }
    
    dependencies {
        implementation 'io.micrometer:micrometer-core:latest.integration'
    }
    

    Milestone releases

    Starting with the 1.15.0-M2 release, milestone releases and release candidates will be published to Maven Central. Note that milestone releases are for testing purposes and are not intended for production use.

    Documentation

    The reference documentation is managed in the docs directory and published to https://micrometer.io/.

    Samples/Examples

    You can find sample/example apps in the micrometer-samples repository.

    Contributing

    See our Contributing Guide for information about contributing to Micrometer.


    Licensed under Apache Software License 2.0

    Sponsored by VMware