As microservice architecture has become a standard for all the latest distributed systems, the tracing of the calls from one microservice to others has been a challenging thing for a while. To solve this Sprig Cloud introduced Spring Sleuth which borrows heavily from dapper. Spring sleuth adds traceID and spanID to the logs so it makes easy to trace a microservice/ web service call. In this tutorial, we will implement Spring Sleuth and integrate with Zipkin which is a distributed tracing system that provides a UI that lets us search the transactions using traceID and also view the dependency diagram which shows how many traced transactions went through each microservice. Let's create three spring boot microservice namely **ServiceOne** **ServiceTwo** **ServiceThree**. In each of the services add the dependencies for **Spring Sleuth**, **Zipkin**, and **spring boot stater web**, the resultant **pom.xml** file should like below. If you are a video person here is the video tutorial Please show some love and subscribe to my channel [Subscribe](https://www.youtube.com/channel/UCBRX8VfhAp7FJ_13uzpI_pQ?sub_confirmation=1). {% youtube Oxfk3gns5qo %} ``` 4.0.0 org.springframework.boot spring-boot-starter-parent 2.2.5.RELEASE com.example MainService 0.0.1-SNAPSHOT Service One Spring Boot With Spring Sleuth 1.8

Hoxton.SR3

org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-web-services org.springframework.cloud spring-cloud-starter-sleuth org.springframework.cloud spring-cloud-starter-zipkin org.springframework.boot spring-boot-starter-test test org.junit.vintage junit-vintage-engine org.springframework.cloud spring-cloud-dependencies ${spring-cloud.version} pom import org.springframework.boot spring-boot-maven-plugin ``` Add a RestController for three services each having GET endpoints /serviceOne /serviceTwo /serviceThree as shown below. ``` package com.springsleuth.demo.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Bean; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.client.RestTemplate; @RestController public class ServiceOneController { private static final Logger LOGGER = LoggerFactory.getLogger(ServiceOneController.class); @Autowired private RestTemplate restTemplate; @Bean public RestTemplate getRestTemplate() { return new RestTemplate(); } @GetMapping("/serviceOne") @ResponseStatus(HttpStatus.OK) public ResponseEntity getSleuthTest(){ LOGGER.info("I'm here in service calling service two"); String response = restTemplate.getForObject("http://localhost:8081/serviceTwo", String.class); return new ResponseEntity(response, HttpStatus.OK); } } ``` Spring Sleuth has the capability to integrate the same traceId to the microservice chain if the services are called using RestTemplate and have been Autowired, create the restTemplate object like the one in the above example and auto-wire so that spring handles the dependency injection. We have the endpoint for serviceOne is ready, and create the endpoints for serviceTwo and serviceThree similar to the above serviceOne example below is the code for serviceTwo and serviceThree controllers. ``` package com.springsleuth.demo.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Bean; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.client.RestTemplate; @RestController public class ServiceTwoController { private static final Logger LOGGER = LoggerFactory.getLogger(ServiceTwoController.class); @Autowired private RestTemplate restTemplate; @Bean public RestTemplate getRestTemplate() { return new RestTemplate(); } @GetMapping("/serviceTwo") @ResponseStatus(HttpStatus.OK) public ResponseEntity getServiceTwo() throws Exception { LOGGER.info("Here inside service two "); String response = restTemplate.getForObject("http://localhost:8080/serviceThree", String.class); return new ResponseEntity(response, HttpStatus.OK); } } ``` ``` package com.springsleuth.demo.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Bean; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.client.RestTemplate; @RestController public class ServiceThreeController { private static final Logger LOGGER = LoggerFactory.getLogger(ServiceThreeController.class); @Autowired private RestTemplate restTemplate; @Bean public RestTemplate getRestTemplate() { return new RestTemplate(); } @GetMapping("/serviceThree") @ResponseStatus(HttpStatus.OK) public ResponseEntity getServiceThree() throws Exception { LOGGER.info("Here inside service Three "); return new ResponseEntity("Success calling Spring Sleuth", HttpStatus.OK); } } ``` ##Application Properties## Since we will be running all the three microservices on the same machine we will have them run on different ports, set the ports in the application.properties file of the respective projects. The appliction.properties file will have two attributes service.name and server.port like below. ``` spring.application.name=serviceOne server.port=8080 ``` ##Zipkin Setup ## Zipkin is an open-source project that you can download using the below command, more about Zipkin can be found at Zipkin.io. ``` curl -sSL https://zipkin.io/quickstart.sh | bash -s ``` Once downloaded run Zipkin jar using the following command. ``` java -jar zipkin.jar ``` Zipkin UI can be seen at localhost:9094/zipkin, which looks like below. ![Zipkin UI](https://dev-to-uploads.s3.amazonaws.com/i/za2hf5xsy08lcbanirgw.png) Now let's start all the three microservices on different ports, and hit the serviceOne endpoint. Use the log below with [serviceName, traceId, spanId, True/False] these are added by spring sleuth and we have nothing to do. ``` 2020-03-14 23:31:05.084 INFO [serviceOne,2ed9f774e90e9450,2ed9f774e90e9450,true] 17903 --- [nio-8082-exec-2] c.s.d.controller.MainServiceController : I'm here in main service calling service one 2020-03-14 23:31:05.181 INFO [serviceTwo,2ed9f774e90e9450,4bc477a78961a834,true] 17902 --- [nio-8081-exec-1] c.s.d.controller.ServiceTwoController : Here inside service Two 2020-03-14 23:31:05.304 INFO [serviceThree,2ed9f774e90e9450,dbc9d06429c2394a,true] 17901 --- [nio-8080-exec-1] c.s.d.controller.ServiceOneController : Here inside service Three ``` If you observe the above logs all the logs for three microservices has the same traceID for the call, now go back to zipkin UI and search with the traceID and you we the calls going from one service to other like below, it also shows the time taken for each call. ![Zipkin UI Showing Tracing](https://dev-to-uploads.s3.amazonaws.com/i/4rudn05m7hm7wfhje88j.png) If you are a video person here is the video tutorial {% youtube Oxfk3gns5qo %}

springcloudsleuth

Spring Cloud Sleuth Tutorial With Zipkin

Join Our Newsletter. No Spam, Only the good stuff.