opentelemetry-java-instrume.../instrumentation/spring/spring-web-3.1/library
Trask Stalnaker 65f54e450b
Use Context more in HttpClientTracer (#1811)
* Use Context more in HttpClientTracer

* Better http-url-connection response object

* Follow database semantic conv for elasticsearch-rest

* Remove unnecessary CallDepth tracking
2020-12-03 11:47:08 -08:00
..
src/main/java/io/opentelemetry/instrumentation/spring/httpclients Use Context more in HttpClientTracer (#1811) 2020-12-03 11:47:08 -08:00
README.md Update to latest snapshot. (#1524) 2020-10-29 18:54:09 -07:00
spring-web-3.1-library.gradle Rename spring instrumentation modules (#1125) 2020-09-10 08:41:25 +09:00

README.md

Manual Instrumentation for Spring-Web

Provides OpenTelemetry instrumentation for Spring's RestTemplate.

Quickstart

Add these dependencies to your project.

Replace SPRING_VERSION with the version of spring you're using. Minimum version: 3.1

Replace OPENTELEMETRY_VERSION with the latest stable release. Minimum version: 0.8.0

For Maven add to your pom.xml:

<dependencies>
  <!-- opentelemetry -->
  <dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-spring-web-3.1</artifactId>
    <version>OPENTELEMETRY_VERSION</version>
  </dependency>

   <!-- provides opentelemetry-sdk -->
   <dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporters-logging</artifactId>
    <version>OPENTELEMETRY_VERSION</version>
  </dependency>

  <!-- required to instrument spring-web -->
  <!-- this artifact should already be present in your application -->
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>SPRING_VERSION</version>
  </dependency>

</dependencies>

For Gradle add to your dependencies:

implementation 'io.opentelemetry.instrumentation:opentelemetry-spring-web-3.1:OPENTELEMETRY_VERSION'
implementation 'io.opentelemetry:opentelemetry-exporters-logging:OPENTELEMETRY_VERSION'

//this artifact should already be present in your application
implementation 'org.springframework:spring-web:SPRING_VERSION'

Features

RestTemplateInterceptor

RestTemplateInterceptor adds OpenTelemetry client spans to requests sent using RestTemplate by implementing the ClientHttpRequestInterceptor interface. An example is shown below:

Usage

import io.opentelemetry.instrumentation.spring.httpclients.RestTemplateInterceptor
import io.opentelemetry.api.trace.Tracer;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.ClientHttpRequestInterceptor;
import org.springframework.web.client.RestTemplate;

@Configuration
public class RestTemplateConfig {

   @Bean
   public RestTemplate restTemplate(Tracer tracer) {

      RestTemplate restTemplate = new RestTemplate();
      RestTemplateInterceptor restTemplateInterceptor = new RestTemplateInterceptor(tracer);
      restTemplate.getInterceptors().add(restTemplateInterceptor);

      return restTemplate;
   }
}

Starter Guide

Check out the opentelemetry quick start to learn more about OpenTelemetry instrumentation.