From 5b2cfaac0ee70682c8d37ccba2339c6a7e11066d Mon Sep 17 00:00:00 2001 From: buildmaster Date: Wed, 22 Aug 2018 09:37:54 +0000 Subject: [PATCH] Sync docs from master to gh-pages --- multi/multi__integrations.html | 7 +++++-- single/spring-cloud-sleuth.html | 7 +++++-- spring-cloud-sleuth.xml | 6 ++++++ 3 files changed, 16 insertions(+), 4 deletions(-) diff --git a/multi/multi__integrations.html b/multi/multi__integrations.html index 75ec9aa71..f09d5ed90 100644 --- a/multi/multi__integrations.html +++ b/multi/multi__integrations.html @@ -56,7 +56,9 @@ That Span’s name is http: + the path to which For example, if the request was sent to /this/that then the name will be http:/this/that. You can configure which URIs you would like to skip by setting the spring.sleuth.web.skipPattern property. If you have ManagementServerProperties on classpath, its value of contextPath gets appended to the provided skip pattern. -If you want to reuse the Sleuth’s default skip patterns and just append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

15.5.2 HandlerInterceptor

Since we want the span names to be precise, we use a TraceHandlerInterceptor that either wraps an existing HandlerInterceptor or is added directly to the list of existing HandlerInterceptors. +If you want to reuse the Sleuth’s default skip patterns and just append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

To change the order of tracing filter registration, please set the +spring.sleuth.web.filter-order property.

To disable the filter that logs uncaught exceptions you can disable the +spring.sleuth.web.exception-throwing-filter-enabled property.

15.5.2 HandlerInterceptor

Since we want the span names to be precise, we use a TraceHandlerInterceptor that either wraps an existing HandlerInterceptor or is added directly to the list of existing HandlerInterceptors. The TraceHandlerInterceptor adds a special request attribute to the given HttpServletRequest. If the the TracingFilter does not see this attribute, it creates a "fallback" span, which is an additional span created on the server side so that the trace is presented properly in the UI. If that happens, there is probably missing instrumentation. @@ -65,7 +67,8 @@ That Span’s name is http: + the path to which For example, if the request was sent to /this/that, the name is http:/this/that. You can configure which URIs you would like to skip by using the spring.sleuth.web.skipPattern property. If you have ManagementServerProperties on the classpath, its value of contextPath gets appended to the provided skip pattern. -If you want to reuse Sleuth’s default skip patterns and append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

15.5.5 Dubbo RPC support

Via the integration with Brave, Spring Cloud Sleuth supports Dubbo. +If you want to reuse Sleuth’s default skip patterns and append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

To change the order of tracing filter registration, please set the +spring.sleuth.web.filter-order property.

15.5.5 Dubbo RPC support

Via the integration with Brave, Spring Cloud Sleuth supports Dubbo. It’s enough to add the brave-instrumentation-dubbo-rpc dependency:

<dependency>
     <groupId>io.zipkin.brave</groupId>
     <artifactId>brave-instrumentation-dubbo-rpc</artifactId>
diff --git a/single/spring-cloud-sleuth.html b/single/spring-cloud-sleuth.html
index 2d9361049..b09bab54f 100644
--- a/single/spring-cloud-sleuth.html
+++ b/single/spring-cloud-sleuth.html
@@ -787,7 +787,9 @@ That Span’s name is http: + the path to which
 For example, if the request was sent to /this/that then the name will be http:/this/that.
 You can configure which URIs you would like to skip by setting the spring.sleuth.web.skipPattern property.
 If you have ManagementServerProperties on classpath, its value of contextPath gets appended to the provided skip pattern.
-If you want to reuse the Sleuth’s default skip patterns and just append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

15.5.2 HandlerInterceptor

Since we want the span names to be precise, we use a TraceHandlerInterceptor that either wraps an existing HandlerInterceptor or is added directly to the list of existing HandlerInterceptors. +If you want to reuse the Sleuth’s default skip patterns and just append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

To change the order of tracing filter registration, please set the +spring.sleuth.web.filter-order property.

To disable the filter that logs uncaught exceptions you can disable the +spring.sleuth.web.exception-throwing-filter-enabled property.

15.5.2 HandlerInterceptor

Since we want the span names to be precise, we use a TraceHandlerInterceptor that either wraps an existing HandlerInterceptor or is added directly to the list of existing HandlerInterceptors. The TraceHandlerInterceptor adds a special request attribute to the given HttpServletRequest. If the the TracingFilter does not see this attribute, it creates a "fallback" span, which is an additional span created on the server side so that the trace is presented properly in the UI. If that happens, there is probably missing instrumentation. @@ -796,7 +798,8 @@ That Span’s name is http: + the path to which For example, if the request was sent to /this/that, the name is http:/this/that. You can configure which URIs you would like to skip by using the spring.sleuth.web.skipPattern property. If you have ManagementServerProperties on the classpath, its value of contextPath gets appended to the provided skip pattern. -If you want to reuse Sleuth’s default skip patterns and append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

15.5.5 Dubbo RPC support

Via the integration with Brave, Spring Cloud Sleuth supports Dubbo. +If you want to reuse Sleuth’s default skip patterns and append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.

To change the order of tracing filter registration, please set the +spring.sleuth.web.filter-order property.

15.5.5 Dubbo RPC support

Via the integration with Brave, Spring Cloud Sleuth supports Dubbo. It’s enough to add the brave-instrumentation-dubbo-rpc dependency:

<dependency>
     <groupId>io.zipkin.brave</groupId>
     <artifactId>brave-instrumentation-dubbo-rpc</artifactId>
diff --git a/spring-cloud-sleuth.xml b/spring-cloud-sleuth.xml
index fe508867f..18a6d0d13 100644
--- a/spring-cloud-sleuth.xml
+++ b/spring-cloud-sleuth.xml
@@ -1689,6 +1689,10 @@ For example, if the request was sent to /this/that then the n
 You can configure which URIs you would like to skip by setting the spring.sleuth.web.skipPattern property.
 If you have ManagementServerProperties on classpath, its value of contextPath gets appended to the provided skip pattern.
 If you want to reuse the Sleuth’s default skip patterns and just append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.
+To change the order of tracing filter registration, please set the
+spring.sleuth.web.filter-order property.
+To disable the filter that logs uncaught exceptions you can disable the
+spring.sleuth.web.exception-throwing-filter-enabled property.
 
 

 HandlerInterceptor
@@ -1710,6 +1714,8 @@ For example, if the request was sent to /this/that, the name
 You can configure which URIs you would like to skip by using the spring.sleuth.web.skipPattern property.
 If you have ManagementServerProperties on the classpath, its value of contextPath gets appended to the provided skip pattern.
 If you want to reuse Sleuth’s default skip patterns and append your own, pass those patterns by using the spring.sleuth.web.additionalSkipPattern.
+To change the order of tracing filter registration, please set the
+spring.sleuth.web.filter-order property.
 

 

 Dubbo RPC support