Fork me on GitHub

Spring Integration

The metrics-spring module enables the use of Metrics annotations with Spring AOP, complete with simple XML configuration:

<beans xmlns=""

    <metrics:metrics-registry id="metrics"/>
    <metrics:health-check-registry id="health"/>

    <metrics:annotation-driven metrics-registry="metrics" health-check-registry="health"/>

    <metrics:jmx-reporter id="metricsJmxReporter" metrics-registry="metrics"/>

    <!-- other beans -->


The most important part of the configuration is the element <metrics:annotation-driven />. This registers custom Spring bean processors, which serve three main purposes:

  • Proxying beans which have methods annotated with @Timed, @Metered, and @ExceptionMetered.
  • Registering a Gauge for beans which have members annotated with @Gauge.
  • Registering beans which extend the class HealthCheck.


Due to a limitation in Spring AOP, only public methods can be proxied, so @Timed, @Metered, and @ExceptionMetered have no effect on non-public methods. As @Gauge doesn’t involve a proxy, it is possible to use this annotation on private fields and methods.

The <metrics:annotation-driven /> element accepts 5 optional arguments:

  • metrics-registry: the name of the MetricsRegsitry bean with which the generated metrics should be registered. If omitted, this defaults to registry provided by Metrics.defaultRegistry().
  • health-check-registry: the name of the HealthCheckRegsitry bean with which to register any beans which extend the class HealthCheck. If omitted, this defaults to registry provided by HealthChecks.defaultRegistry().
  • scope: sets the scope for each of the metrics.
  • proxy-target-class: if set to true, always creates CGLIB proxies instead of defaulting to JDK proxies. This is necessary if you use class-based autowiring.
  • expose-proxy: if set to true, the target can access the proxy which wraps it by calling AopContext.currentProxy().

The elements <metrics:metrics-registry /> and <metrics:health-check-registry /> are present as a convenience for creating new registry beans.

The element <metrics:jmx-reporter /> creates a JMX Reporter for the specified metrics registry. A JMX Reporter is automatically created for the default metrics registry.