Java Spring Web

OpenTracing Spring Web instrumentation
Alternatives To Java Spring Web
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Spring Cloud Sleuth1,6771,242285 days ago65June 29, 202231apache-2.0Java
Distributed tracing for spring cloud
Java Spring Cloud3562810a year ago52October 30, 202052apache-2.0Java
Distributed tracing for Spring Boot, Cloud and other Spring projects
Java Specialagent153142 years ago34July 15, 202042apache-2.0Java
Automatic instrumentation for 3rd-party libraries in Java applications with OpenTracing.
Java Kafka Client102752 years ago35October 28, 20206apache-2.0Java
OpenTracing Instrumentation for Apache Kafka Client
Java Spring Web945112 years ago15October 13, 202018apache-2.0Java
OpenTracing Spring Web instrumentation
Invesdwin Instrument86
a month agolgpl-3.0Java
An instrumentation java agent that is able to inject itself into the running process
Java Redis Client23272 years ago32July 23, 20204apache-2.0Java
OpenTracing Instrumentation for Redis Client
Java Spring Rabbitmq16
a year ago7apache-2.0Java
OpenTracing RabbitMQ instrumentation
Java Reactor1113 years ago5August 11, 2020apache-2.0Java
OpenTracing instrumentation for Reactor
Spring Cloud Sleuth Amqp8114 years ago7April 25, 20186apache-2.0Java
Implementation of spring-rabbit instrumentation for spring-cloud-sleuth
Alternatives To Java Spring Web
Select To Compare

Alternative Project Comparisons

Build Status Released Version

OpenTracing Spring Web Instrumentation

This library provides instrumentation for Spring Web applications (Boot, MVC and WebFlux). It creates tracing data for server requests and also client requests (RestTemplate, AsyncRestTemplate and WebClient).

Comparison with opentracing-spring-cloud

As it was mentioned above, this library traces only inbound/outbound HTTP requests. If you would like to get automatically traced different set of technologies e.g. spring-cloud-netflix, JMS or even more then use project opentracing-spring-cloud instead.

For reactive applications, it is especially recommended to use reactor tracing from opentracing-spring-cloud, as that will ensure that the Span is activated in reactor handler functions. (Without that, one would have to extract the Span from the subscriber context.)

How does the server tracing work?


Server span is started in Web Servlet Filter, then tracing interceptor adds spring related tags and logs. There are use case when spring boot invokes a handler after a request processing in filter finished, in this case interceptor starts a new span as followsFrom which references the initial span created in the servlet filter.


Server span is started in TracingWebFilter (upon subscription), then onNext(), onError(), etc. handlers add Spring WebFlux related tags and logs.

Library versions

Versions 1.x.y, 2.x.y, ... of the library are meant to target Spring Framework 5.x and Spring Boot 2.x while versions 0.x.y are meant to be used with Spring Framework 4.3 and Spring Boot 1.5


Spring Boot Auto-configuration

If you are using Spring Boot the easiest way how to configure OpenTracing instrumentation is to use auto-configuration:


Just provide an OpenTracing tracer bean and all required configuration is automatically done for you. It also instruments all RestTemplate, AsyncRestTemplate, WebClient and WebClient.Builder beans.

Manual configuration

Servlet and MVC Server

Configuration needs to add TracingFilter and TracingHandlerInterceptor. Both of these classes are required!

Tracing interceptor can be instantiated manually or injected via CDI, but it needs bean of type Tracer configured.

Java based configuration:

public class MVCConfiguration extends WebMvcConfigurerAdapter {

    private Tracer tracer;

    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new TracingHandlerInterceptor(tracer));

    public FilterRegistrationBean tracingFilter() {
        TracingFilter tracingFilter = new TracingFilter(tracer);

        FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean(tracingFilter);

        return filterRegistrationBean;

XML based configuration can be used too. Filter can be also directly defined in web.xml.

Reactive Server

Configuration needs to add the TracingWebFilter bean.

class TracingConfiguration {
    public TracingWebFilter tracingWebFilter(Tracer tracer) {
        return new TracingWebFilter(
                Integer.MIN_VALUE,               // Order
                Pattern.compile(""),             // Skip pattern
                Collections.emptyList(),         // URL patterns, empty list means all
                Arrays.asList(new WebFluxSpanDecorator.StandardTags(), new WebFluxSpanDecorator.WebFluxTags())


RestTemplate restTemplate = new RestTemplate();
restTemplate.setInterceptors(Collections.singletonList(new TracingRestTemplateInterceptor(tracer)));

// the same applies for AsyncRestTemplate 

Reactive Client

WebClient webClient = WebClient.builder()
        .filter(new TracingExchangeFilterFunction(tracer, Collections.singletonList(new WebClientSpanDecorator.StandardTags())))

Access server span

public String hello(HttpServletRequest request) {
    Span serverSpan = tracer.activeSpan();

    Span span = tracer.buildSpan("localSpan")
    try {
        // Traced work happens between start() and deactivate();
        return "Hello world!";
    } finally {


./mvnw clean install


Follow instructions in RELEASE

Popular Instrumentation Projects
Popular Spring Projects
Popular Operations Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Spring Boot
Spring Mvc
Spring Cloud