+
diff --git a/1.1.x/images/zipkin-error-trace-screenshot.png b/1.1.x/images/zipkin-error-trace-screenshot.png new file mode 100644 index 000000000..02a7270eb Binary files /dev/null and b/1.1.x/images/zipkin-error-trace-screenshot.png differ diff --git a/1.1.x/images/zipkin-error-traces.png b/1.1.x/images/zipkin-error-traces.png new file mode 100644 index 000000000..233b0cbf3 Binary files /dev/null and b/1.1.x/images/zipkin-error-traces.png differ diff --git a/1.1.x/images/zipkin-trace-screenshot.png b/1.1.x/images/zipkin-trace-screenshot.png index f0452f0f4..b230a19a3 100644 Binary files a/1.1.x/images/zipkin-trace-screenshot.png and b/1.1.x/images/zipkin-trace-screenshot.png differ diff --git a/1.1.x/images/zipkin-traces.png b/1.1.x/images/zipkin-traces.png index 673ece9aa..421bddec8 100644 Binary files a/1.1.x/images/zipkin-traces.png and b/1.1.x/images/zipkin-traces.png differ diff --git a/1.1.x/images/zipkin-ui.png b/1.1.x/images/zipkin-ui.png index 34b0215b7..6bfe38e67 100644 Binary files a/1.1.x/images/zipkin-ui.png and b/1.1.x/images/zipkin-ui.png differ diff --git a/1.1.x/index.html b/1.1.x/index.html index 929ba036e..aa6599367 100644 --- a/1.1.x/index.html +++ b/1.1.x/index.html @@ -431,6 +431,8 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
+
+
Altogether there are 10 spans . If you go to traces in Zipkin you will see this number:
+Altogether there are 7 spans . If you go to traces in Zipkin you will see this number in the second trace:
+
However if you pick a particular trace then you will see 7 spans:
+However if you pick a particular trace then you will see 4 spans:
+
In the image depicting the visualization of what Span and Trace is you can see 20 -colorful labels. How does it happen that in Zipkin 10 spans are received?
+Why is there a difference between the 7 and 4 spans in this case?
2 span A labels signify span started and closed. Upon closing a single span is sent to Zipkin.
+2 spans come from http:/start span. It has the Server Received (SR) and Server Sent (SS) annotations.
4 span B labels are in fact are single span with 4 annotations. However this span is composed of -two separate instances. One sent from service 1 and one from service 2. So in fact two span instances will be sent -to Zipkin and merged there.
+2 spans come from the RPC call from service1 to service2 to the http:/foo endpoint. It has the Client Sent (CS)
+and Client Received (CR) annotations on service1 side. It also has Server Received (SR) and Server Sent (SS) annotations
+on the service2 side. Physically there are 2 spans but they form 1 logical span related to an RPC call.
2 span C labels signify span started and closed. Upon closing a single span is sent to Zipkin.
+2 spans come from the RPC call from service2 to service3 to the http:/bar endpoint. It has the Client Sent (CS)
+and Client Received (CR) annotations on service2 side. It also has Server Received (SR) and Server Sent (SS) annotations
+on the service3 side. Physically there are 2 spans but they form 1 logical span related to an RPC call.
4 span B labels are in fact are single span with 4 annotations. However this span is composed of -two separate instances. One sent from service 2 and one from service 3. So in fact two span instances will be sent -to Zipkin and merged there.
-2 span E labels signify span started and closed. Upon closing a single span is sent to Zipkin.
-4 span B labels are in fact are single span with 4 annotations. However this span is composed of -two separate instances. One sent from service 2 and one from service 4. So in fact two span instances will be sent -to Zipkin and merged there.
-2 span G labels signify span started and closed. Upon closing a single span is sent to Zipkin.
+2 spans come from the RPC call from service2 to service4 to the http:/baz endpoint. It has the Client Sent (CS)
+and Client Received (CR) annotations on service2 side. It also has Server Received (SR) and Server Sent (SS) annotations
+on the service4 side. Physically there are 2 spans but they form 1 logical span related to an RPC call.
So 1 span from A, 2 spans from B, 1 span from C, 2 spans from D, 1 span from E, 2 spans from F and 1 from G. -Altogether 10 spans.
+So if we count the physical spans we have 1 from http:/start, 2 from service1 calling service2, 2 form service2
+calling service3 and 2 from service2 calling service4. Altogether 7 spans.
Logically we see the information of Total Spans: 4 because we have 1 span related to the incoming request
+to service1 and 3 spans related to RPC calls.
Zipkin allows you to visualize errors in your trace. When an exception was thrown and wasn’t caught then we’re +setting proper tags on the span which Zipkin can properly colorize. You could see in the list of traces one + trace that was in red color. That’s because there was an exception thrown.
+If you click that trace then you’ll see a similar picture
Then if you click on one of the spans you’ll see the following
+
+As you can see you can easily see the reason for an error and the whole stacktrace related to it.
+
+
+
groupId:artifactId:versionLogback setup
Below you can find an example of a Logback configuration (file named https://github.com/spring-cloud-samples/sleuth-documentation-apps/blob/master/service1/src/main/resources/logback-spring.xml[logback-spring.xml]) that:
Below you can find an example of a Logback configuration (file named logback-spring.xml) that: