diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/README.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/README.html new file mode 100644 index 00000000..2b7fd1d9 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/README.html @@ -0,0 +1,1438 @@ + + + + + + + +Spring Cloud Sleuth + + + + + + + + + + +
+
+
+
+
+CircleCI +
+
+
+
+codecov +
+
+
+
+Gitter +
+
+
+
+
+

Spring Cloud Sleuth

+
+
+

Spring Cloud Sleuth provides Spring Boot auto-configuration for distributed +tracing. Underneath, Spring Cloud Sleuth is a layer over a tracer library named +Brave.

+
+
+

Sleuth configures everything you need to get started. This includes where trace +data (spans) are reported to, how many traces to keep (sampling), if remote +fields (baggage) are sent, and which libraries are traced.

+
+
+

Quick Start

+
+

Add sleuth to the classpath of a Spring Boot application +(see “Adding Sleuth to your Project” for Maven and Gradle examples), and you will +see trace IDs in logs.

+
+
+

For example, consider the following HTTP handler:

+
+
+
+
@RestController
+public class DemoController {
+  private static Logger log = LoggerFactory.getLogger(DemoController.class);
+
+  @RequestMapping("/")
+  public String home() {
+    log.info("Handling home");
+    ...
+    return "Hello World";
+  }
+}
+
+
+
+

If you add that handler to a controller, you can see the calls to home() +being traced in the logs as well in Zipkin, if configured.

+
+
+ + + + + +
+ + +Instead of logging the request in the handler explicitly, you +could set logging.level.org.springframework.web.servlet.DispatcherServlet=DEBUG. +
+
+
+ + + + + +
+ + +Set spring.application.name=myService (for instance) to see the service +name as well as the trace and span IDs. +
+
+
+
+
+
+

Overview

+
+
+

Spring Cloud Sleuth provides Spring Boot auto-configuration for distributed +tracing. Underneath, Spring Cloud Sleuth is a layer over a Tracer library named +Brave.

+
+
+

Sleuth configures everything you need to get started. This includes where trace +data (spans) are reported to, how many traces to keep (sampling), if remote +fields (baggage) are sent, and which libraries are traced.

+
+
+

We maintain an example app where two Spring Boot services collaborate on an +HTTP request. Sleuth configures these apps, so that timing of these requests are +recorded into Zipkin, a distributed tracing system. Tracing +UIs visualize latency, such as time in one service vs waiting for other +services.

+
+
+

Here’s an example of what it looks like:

+
+
+
+Zipkin Trace +
+
+
+

The source repository of this +example includes demonstrations of many things, including WebFlux and messaging. +Most features require only a property or dependency change to work. These +snippets showcase the value of Spring Cloud Sleuth: Through auto-configuration, +Sleuth make getting started with distributed tracing easy!

+
+
+

To keep things simple, the same example is used throughout documentation using +basic HTTP communication.

+
+
+
+
+

1. Features

+
+
+

Sleuth sets up instrumentation not only to track timing, but also to catch +errors so that they can be analyzed or correlated with logs. This works the +same way regardless of if the error came from a common instrumented library, +such as RestTemplate, or your own code annotated with @NewSpan or similar.

+
+
+

Below, we’ll use the word Zipkin to describe the tracing system, and include +Zipkin screenshots. However, most services accepting Zipkin format +have similar base features. Sleuth can also be configured to send data in other +formats, something detailed later.

+
+
+

1.1. Contextualizing errors

+
+

Without distributed tracing, it can be difficult to understand the impact of a +an exception. For example, it can be hard to know if a specific request caused +the caller to fail or not.

+
+
+

Zipkin reduces time in triage by contextualizing errors and delays.

+
+
+

Requests colored red in the search screen failed:

+
+
+
+Error Traces +
+
+
+

If you then click on one of the traces, you can understand if the failure +happened before the request hit another service or not:

+
+
+
+Error Traces Info propagation +
+
+
+

For example, the above error happened in the "backend" service, and caused the +"frontend" service to fail.

+
+
+
+

1.2. Log correlation

+
+

Sleuth configures the logging context with variables including the service name +(%{spring.zipkin.service.name}) and the trace ID (%{traceId}). These help +you connect logs with distributed traces and allow you choice in what tools you +use to troubleshoot your services.

+
+
+

Once you find any log with an error, you can look for the trace ID in the +message. Paste that into Zipkin to visualize the entire trace, regardless of +how many services the first request ended up hitting.

+
+
+
+
backend.log:  2020-04-09 17:45:40.516 ERROR [backend,5e8eeec48b08e26882aba313eb08f0a4,dcc1df555b5777b3,true] 97203 --- [nio-9000-exec-1] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+frontend.log:2020-04-09 17:45:40.574 ERROR [frontend,5e8eeec48b08e26882aba313eb08f0a4,82aba313eb08f0a4,true] 97192 --- [nio-8081-exec-2] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+
+
+
+

Above, you’ll notice the trace ID is 5e8eeec48b08e26882aba313eb08f0a4, for +example. This log configuration was automatically setup by Sleuth.

+
+
+

If you use a log aggregating tool (such as Kibana, Splunk, and others), you can order the events that took place. +An example from Kibana would resemble the following image:

+
+
+
+Log correlation with Kibana +
+
+
+

If you want to use Logstash, the following listing shows the Grok pattern for Logstash:

+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+ + + + + +
+ + +If you want to use Grok together with the logs from Cloud Foundry, you have to use the following pattern: +
+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "(?m)OUT\s+%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+

1.2.1. JSON Logback with Logstash

+
+

Often, you do not want to store your logs in a text file but in a JSON file that Logstash can immediately pick. +To do so, you have to do the following (for readability, we pass the dependencies in the groupId:artifactId:version notation).

+
+
+

Dependencies Setup

+
+
+
    +
  1. +

    Ensure that Logback is on the classpath (ch.qos.logback:logback-core).

    +
    2. +
  2. +

    Add Logstash Logback encode. For example, to use version 4.6, add net.logstash.logback:logstash-logback-encoder:4.6.

    +
    3. +
+
+
+

Logback Setup

+
+
+

Consider the following example of a Logback configuration file (logback-spring.xml).

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
+    <springProperty scope="context" name="springAppName" source="spring.application.name"/>
+    <!-- Example for logging into the build folder of your project -->
+    <property name="LOG_FILE" value="${BUILD_FOLDER:-build}/${springAppName}"/>
+
+    <!-- You can override this to have a custom pattern -->
+    <property name="CONSOLE_LOG_PATTERN"
+              value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>
+
+    <!-- Appender to log to console -->
+    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
+        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
+            <!-- Minimum logging level to be presented in the console logs-->
+            <level>DEBUG</level>
+        </filter>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+
+    <!-- Appender to log to file -->
+    <appender name="flatfile" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+    <!-- Appender to log to file in a JSON format -->
+    <appender name="logstash" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}.json</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.json.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
+            <providers>
+                <timestamp>
+                    <timeZone>UTC</timeZone>
+                </timestamp>
+                <pattern>
+                    <pattern>
+                        {
+                        "timestamp": "@timestamp",
+                        "severity": "%level",
+                        "service": "${springAppName:-}",
+                        "trace": "%X{traceId:-}",
+                        "span": "%X{spanId:-}",
+                        "pid": "${PID:-}",
+                        "thread": "%thread",
+                        "class": "%logger{40}",
+                        "rest": "%message"
+                        }
+                    </pattern>
+                </pattern>
+            </providers>
+        </encoder>
+    </appender>
+    <root level="INFO">
+        <appender-ref ref="console"/>
+        <!-- uncomment this to have also JSON logs -->
+        <!--<appender-ref ref="logstash"/>-->
+        <!--<appender-ref ref="flatfile"/>-->
+    </root>
+</configuration>
+
+
+
+

That Logback configuration file:

+
+
+
    +
  • +

    Logs information from the application in a JSON format to a build/${spring.application.name}.json file.

    +
    • +
  • +

    Has commented out two additional appenders: console and standard log file.

    +
    • +
  • +

    Has the same logging pattern as the one presented in the previous section.

    +
    • +
+
+
+ + + + + +
+ + +If you use a custom logback-spring.xml, you must pass the spring.application.name in the bootstrap rather than the application property file. +Otherwise, your custom logback file does not properly read the property. +
+
+
+
+
+

1.3. Service Dependency Graph

+
+

When you consider distributed tracing tracks requests, it makes sense that +trace data can paint a picture of your architecture.

+
+
+

Zipkin includes a tool to build service dependency diagrams from traces, +including the count of calls and how many errors exist.

+
+
+

The example application will make a simple diagram like this, but your real +environment diagram may be more complex. +image::https://raw.githubusercontent.com/spring-cloud/spring-cloud-sleuth/master/docs/src/main/asciidoc/images/zipkin-depedendencies.png[Zipkin Dependencies]

+
+
+

Note: Production environments will generate a lot of data. You will likely +need to run a separate service to aggregate the dependency graph. You can learn +more here.

+
+
+
+

1.4. Request scoped properties (Baggage)

+
+

Distributed tracing works by propagating fields inside and across services that +connect the trace together: traceId and spanId notably. The context that holds +these fields can optionally push other fields that need to be consistent +regardless of many services are touched. The simple name for these extra fields +is "Baggage".

+
+
+

Sleuth allows you to define which baggage are permitted to exist in the trace +context, including what header names are used.

+
+
+

The following example shows setting baggage values:

+
+
+
+
Span initialSpan = this.tracer.nextSpan().name("span").start();
+BUSINESS_PROCESS.updateValue(initialSpan.context(), "ALM");
+COUNTRY_CODE.updateValue(initialSpan.context(), "FO");
+
+
+
+ + + + + +
+ + +There is currently no limitation of the count or size of baggage +items. Keep in mind that too many can decrease system throughput or increase +RPC latency. In extreme cases, too much baggage can crash the application, due +to exceeding transport-level message or header capacity. +
+
+
+

1.4.1. Baggage versus Tags

+
+

Like trace IDs, Baggage is attached to messages or requests, usually as +headers. Tags are key value pairs sent in a Span to Zipkin. Baggage values are +not added spans by default, which means you can’t search based on Baggage +unless you opt-in.

+
+
+

To make baggage also tags, use the property spring.sleuth.baggage.tag-fields +like so:

+
+
+
+
spring:
+  sleuth:
+    baggage:
+      remoteFields:
+        - country-code
+        - x-vcap-request-id
+      tagFields:
+        - country-code
+
+
+
+
+
+
+
+

2. Adding Sleuth to your Project

+
+
+

This section addresses how to add Sleuth to your project with either Maven or Gradle.

+
+
+ + + + + +
+ + +To ensure that your application name is properly displayed in Zipkin, set the spring.application.name property in bootstrap.yml. +
+
+
+

2.1. Sleuth with Zipkin via HTTP

+
+

If you want both Sleuth and Zipkin, add the spring-cloud-starter-zipkin dependency.

+
+
+

The following example shows how to do so for Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+

The following example shows how to do so for Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+
+

2.2. Sleuth with Zipkin over RabbitMQ or Kafka

+
+

If you want to use RabbitMQ or Kafka instead of HTTP, add the spring-rabbit or spring-kafka dependency. +The default destination name is zipkin.

+
+
+

If using Kafka, you must set the property spring.zipkin.sender.type property accordingly:

+
+
+
+
spring.zipkin.sender.type: kafka
+
+
+
+ + + + + +
+ + +spring-cloud-sleuth-stream is deprecated and incompatible with these destinations. +
+
+
+

If you want Sleuth over RabbitMQ, add the spring-cloud-starter-zipkin and spring-rabbit +dependencies.

+
+
+

The following example shows how to do so for Gradle:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+<dependency> (3)
+    <groupId>org.springframework.amqp</groupId>
+    <artifactId>spring-rabbit</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies {
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin" (2)
+    compile "org.springframework.amqp:spring-rabbit" (3)
+}
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
+

2.3. Overriding the auto-configuration of Zipkin

+
+

Spring Cloud Sleuth supports sending traces to multiple tracing systems as of version 2.1.0. +In order to get this to work, every tracing system needs to have a Reporter<Span> and Sender. +If you want to override the provided beans you need to give them a specific name. +To do this you can use respectively ZipkinAutoConfiguration.REPORTER_BEAN_NAME and ZipkinAutoConfiguration.SENDER_BEAN_NAME.

+
+
+
+
@Configuration
+protected static class MyConfig {
+
+    @Bean(ZipkinAutoConfiguration.REPORTER_BEAN_NAME)
+    Reporter<zipkin2.Span> myReporter() {
+        return AsyncReporter.create(mySender());
+    }
+
+    @Bean(ZipkinAutoConfiguration.SENDER_BEAN_NAME)
+    MySender mySender() {
+        return new MySender();
+    }
+
+    static class MySender extends Sender {
+
+        private boolean spanSent = false;
+
+        boolean isSpanSent() {
+            return this.spanSent;
+        }
+
+        @Override
+        public Encoding encoding() {
+            return Encoding.JSON;
+        }
+
+        @Override
+        public int messageMaxBytes() {
+            return Integer.MAX_VALUE;
+        }
+
+        @Override
+        public int messageSizeInBytes(List<byte[]> encodedSpans) {
+            return encoding().listSizeInBytes(encodedSpans);
+        }
+
+        @Override
+        public Call<Void> sendSpans(List<byte[]> encodedSpans) {
+            this.spanSent = true;
+            return Call.create(null);
+        }
+
+    }
+
+}
+
+
+
+
+

2.4. Only Sleuth (log correlation)

+
+

If you want to use only Spring Cloud Sleuth without the Zipkin integration, add the spring-cloud-starter-sleuth module to your project.

+
+
+

The following example shows how to add Sleuth with Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-sleuth</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+

The following example shows how to add Sleuth with Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+
+
+
+

3. Building

+
+
+

3.1. Basic Compile and Test

+
+

To build the source you will need to install JDK 1.7.

+
+
+

Spring Cloud uses Maven for most build-related activities, and you +should be able to get off the ground quite quickly by cloning the +project you are interested in and typing

+
+
+
+
$ ./mvnw install
+
+
+
+ + + + + +
+ + +You can also install Maven (>=3.3.3) yourself and run the mvn command +in place of ./mvnw in the examples below. If you do that you also +might need to add -P spring if your local Maven settings do not +contain repository declarations for spring pre-release artifacts. +
+
+
+ + + + + +
+ + +Be aware that you might need to increase the amount of memory +available to Maven by setting a MAVEN_OPTS environment variable with +a value like -Xmx512m -XX:MaxPermSize=128m. We try to cover this in +the .mvn configuration, so if you find you have to do it to make a +build succeed, please raise a ticket to get the settings added to +source control. +
+
+
+

For hints on how to build the project look in .travis.yml if there +is one. There should be a "script" and maybe "install" command. Also +look at the "services" section to see if any services need to be +running locally (e.g. mongo or rabbit). Ignore the git-related bits +that you might find in "before_install" since they’re related to setting git +credentials and you already have those.

+
+
+

The projects that require middleware generally include a +docker-compose.yml, so consider using +Docker Compose to run the middeware servers +in Docker containers. See the README in the +scripts demo +repository for specific instructions about the common cases of mongo, +rabbit and redis.

+
+
+ + + + + +
+ + +If all else fails, build with the command from .travis.yml (usually +./mvnw install). +
+
+
+
+

3.2. Documentation

+
+

The spring-cloud-build module has a "docs" profile, and if you switch +that on it will try to build asciidoc sources from +src/main/asciidoc. As part of that process it will look for a +README.adoc and process it by loading all the includes, but not +parsing or rendering it, just copying it to ${main.basedir} +(defaults to ${basedir}, i.e. the root of the project). If there are +any changes in the README it will then show up after a Maven build as +a modified file in the correct place. Just commit it and push the change.

+
+
+
+

3.3. Working with the code

+
+

If you don’t have an IDE preference we would recommend that you use +Spring Tools Suite or +Eclipse when working with the code. We use the +m2eclipse eclipse plugin for maven support. Other IDEs and tools +should also work without issue as long as they use Maven 3.3.3 or better.

+
+
+

3.3.1. Importing into eclipse with m2eclipse

+
+

We recommend the m2eclipse eclipse plugin when working with +eclipse. If you don’t already have m2eclipse installed it is available from the "eclipse +marketplace".

+
+
+ + + + + +
+ + +Older versions of m2e do not support Maven 3.3, so once the +projects are imported into Eclipse you will also need to tell +m2eclipse to use the right profile for the projects. If you +see many different errors related to the POMs in the projects, check +that you have an up to date installation. If you can’t upgrade m2e, +add the "spring" profile to your settings.xml. Alternatively you can +copy the repository settings from the "spring" profile of the parent +pom into your settings.xml. +
+
+
+
+

3.3.2. Importing into eclipse without m2eclipse

+
+

If you prefer not to use m2eclipse you can generate eclipse project metadata using the +following command:

+
+
+
+
$ ./mvnw eclipse:eclipse
+
+
+
+

The generated eclipse projects can be imported by selecting import existing projects +from the file menu.

+
+
+ + + + + +
+ + +Spring Cloud Sleuth uses two different versions of language level. Java 1.7 is used for main sources, and +Java 1.8 is used for tests. When importing your project to an IDE, you should activate the ide Maven profile to turn on +Java 1.8 for both main and test sources. You MUST NOT use Java 1.8 features in the main sources. If you do +so, your app breaks during the Maven build. +
+
+
+
+
+
+
+

4. Contributing

+
+
+

Spring Cloud is released under the non-restrictive Apache 2.0 license, +and follows a very standard Github development process, using Github +tracker for issues and merging pull requests into master. If you want +to contribute even something trivial please do not hesitate, but +follow the guidelines below.

+
+
+

4.1. Sign the Contributor License Agreement

+
+

Before we accept a non-trivial patch or pull request we will need you to sign the +Contributor License Agreement. +Signing the contributor’s agreement does not grant anyone commit rights to the main +repository, but it does mean that we can accept your contributions, and you will get an +author credit if we do. Active contributors might be asked to join the core team, and +given the ability to merge pull requests.

+
+
+
+

4.2. Code of Conduct

+
+

This project adheres to the Contributor Covenant code of +conduct. By participating, you are expected to uphold this code. Please report +unacceptable behavior to spring-code-of-conduct@pivotal.io.

+
+
+
+

4.3. Code Conventions and Housekeeping

+
+

None of these is essential for a pull request, but they will all help. They can also be +added after the original pull request but before a merge.

+
+
+
    +
  • +

    Use the Spring Framework code format conventions. If you use Eclipse +you can import formatter settings using the +eclipse-code-formatter.xml file from the +Spring +Cloud Build project. If using IntelliJ, you can use the +Eclipse Code Formatter +Plugin to import the same file.

    +
    • +
  • +

    Make sure all new .java files to have a simple Javadoc class comment with at least an +@author tag identifying you, and preferably at least a paragraph on what the class is +for.

    +
    • +
  • +

    Add the ASF license header comment to all new .java files (copy from existing files +in the project)

    +
    • +
  • +

    Add yourself as an @author to the .java files that you modify substantially (more +than cosmetic changes).

    +
    • +
  • +

    Add some Javadocs and, if you change the namespace, some XSD doc elements.

    +
    • +
  • +

    A few unit tests would help a lot as well — someone has to do it.

    +
    • +
  • +

    If no-one else is using your branch, please rebase it against the current master (or +other target branch in the main project).

    +
    • +
  • +

    When writing a commit message please follow these conventions, +if you are fixing an existing issue please add Fixes gh-XXXX at the end of the commit +message (where XXXX is the issue number).

    +
    • +
+
+
+
+

4.4. Checkstyle

+
+

Spring Cloud Build comes with a set of checkstyle rules. You can find them in the spring-cloud-build-tools module. The most notable files under the module are:

+
+
+
spring-cloud-build-tools/
+
+
└── src
+    ├── checkstyle
+    │   └── checkstyle-suppressions.xml (3)
+    └── main
+        └── resources
+            ├── checkstyle-header.txt (2)
+            └── checkstyle.xml (1)
+
+
+
+ + + + + + + + + + + + + +
1Default Checkstyle rules
2File header setup
3Default suppression rules
+
+
+

4.4.1. Checkstyle configuration

+
+

Checkstyle rules are disabled by default. To add checkstyle to your project just define the following properties and plugins.

+
+
+
pom.xml
+
+
<properties>
+<maven-checkstyle-plugin.failsOnError>true</maven-checkstyle-plugin.failsOnError> (1)
+        <maven-checkstyle-plugin.failsOnViolation>true
+        </maven-checkstyle-plugin.failsOnViolation> (2)
+        <maven-checkstyle-plugin.includeTestSourceDirectory>true
+        </maven-checkstyle-plugin.includeTestSourceDirectory> (3)
+</properties>
+
+<build>
+        <plugins>
+            <plugin> (4)
+                <groupId>io.spring.javaformat</groupId>
+                <artifactId>spring-javaformat-maven-plugin</artifactId>
+            </plugin>
+            <plugin> (5)
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+            </plugin>
+        </plugins>
+
+    <reporting>
+        <plugins>
+            <plugin> (5)
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </reporting>
+</build>
+
+
+
+ + + + + + + + + + + + + + + + + + + + + +
1Fails the build upon Checkstyle errors
2Fails the build upon Checkstyle violations
3Checkstyle analyzes also the test sources
4Add the Spring Java Format plugin that will reformat your code to pass most of the Checkstyle formatting rules
5Add checkstyle plugin to your build and reporting phases
+
+
+

If you need to suppress some rules (e.g. line length needs to be longer), then it’s enough for you to define a file under ${project.root}/src/checkstyle/checkstyle-suppressions.xml with your suppressions. Example:

+
+
+
projectRoot/src/checkstyle/checkstyle-suppresions.xml
+
+
<?xml version="1.0"?>
+<!DOCTYPE suppressions PUBLIC
+        "-//Puppy Crawl//DTD Suppressions 1.1//EN"
+        "https://www.puppycrawl.com/dtds/suppressions_1_1.dtd">
+<suppressions>
+    <suppress files=".*ConfigServerApplication\.java" checks="HideUtilityClassConstructor"/>
+    <suppress files=".*ConfigClientWatch\.java" checks="LineLengthCheck"/>
+</suppressions>
+
+
+
+

It’s advisable to copy the ${spring-cloud-build.rootFolder}/.editorconfig and ${spring-cloud-build.rootFolder}/.springformat to your project. That way, some default formatting rules will be applied. You can do so by running this script:

+
+
+
+
$ curl https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/.editorconfig -o .editorconfig
+$ touch .springformat
+
+
+
+
+
+

4.5. IDE setup

+
+

4.5.1. Intellij IDEA

+
+

In order to setup Intellij you should import our coding conventions, inspection profiles and set up the checkstyle plugin. +The following files can be found in the Spring Cloud Build project.

+
+
+
spring-cloud-build-tools/
+
+
└── src
+    ├── checkstyle
+    │   └── checkstyle-suppressions.xml (3)
+    └── main
+        └── resources
+            ├── checkstyle-header.txt (2)
+            ├── checkstyle.xml (1)
+            └── intellij
+                ├── Intellij_Project_Defaults.xml (4)
+                └── Intellij_Spring_Boot_Java_Conventions.xml (5)
+
+
+
+ + + + + + + + + + + + + + + + + + + + + +
1Default Checkstyle rules
2File header setup
3Default suppression rules
4Project defaults for Intellij that apply most of Checkstyle rules
5Project style conventions for Intellij that apply most of Checkstyle rules
+
+
+
+Code style +
+
Figure 1. Code style
+
+
+

Go to File → Settings → Editor → Code style. There click on the icon next to the Scheme section. There, click on the Import Scheme value and pick the Intellij IDEA code style XML option. Import the spring-cloud-build-tools/src/main/resources/intellij/Intellij_Spring_Boot_Java_Conventions.xml file.

+
+
+
+Code style +
+
Figure 2. Inspection profiles
+
+
+

Go to File → Settings → Editor → Inspections. There click on the icon next to the Profile section. There, click on the Import Profile and import the spring-cloud-build-tools/src/main/resources/intellij/Intellij_Project_Defaults.xml file.

+
+
+
Checkstyle
+

To have Intellij work with Checkstyle, you have to install the Checkstyle plugin. It’s advisable to also install the Assertions2Assertj to automatically convert the JUnit assertions

+
+
+
+Checkstyle +
+
+
+

Go to File → Settings → Other settings → Checkstyle. There click on the + icon in the Configuration file section. There, you’ll have to define where the checkstyle rules should be picked from. In the image above, we’ve picked the rules from the cloned Spring Cloud Build repository. However, you can point to the Spring Cloud Build’s GitHub repository (e.g. for the checkstyle.xml : raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/spring-cloud-build-tools/src/main/resources/checkstyle.xml). We need to provide the following variables:

+
+
+ +
+
+ + + + + +
+ + +Remember to set the Scan Scope to All sources since we apply checkstyle rules for production and test sources. +
+
+
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/appendix.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/appendix.html new file mode 100644 index 00000000..ff9e93a7 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/appendix.html @@ -0,0 +1,482 @@ + + + + + + + +Common application properties + + + + + + + + + + +
+
+

Appendix A: Common application properties

+
+
+

Various properties can be specified inside your application.properties file, inside your application.yml file, or as command line switches. +This appendix provides a list of common Spring Cloud Sleuth properties and references to the underlying classes that consume them.

+
+
+ + + + + +
+ + +Property contributions can come from additional jar files on your classpath, so you should not consider this an exhaustive list. +Also, you can define your own properties. +
+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDefaultDescription

spring.sleuth.annotation.enabled

true

spring.sleuth.async.configurer.enabled

true

Enable default AsyncConfigurer.

spring.sleuth.async.enabled

true

Enable instrumenting async related components so that the tracing information is passed between threads.

spring.sleuth.async.ignored-beans

List of {@link java.util.concurrent.Executor} bean names that should be ignored and not wrapped in a trace representation.

spring.sleuth.baggage.correlation-enabled

true

Adds a {@link CorrelationScopeDecorator} to put baggage values into the correlation context.

spring.sleuth.baggage.correlation-fields

A list of {@link BaggageField#name() fields} to add to correlation (MDC) context. @see CorrelationScopeConfig.SingleCorrelationField#create(BaggageField)

spring.sleuth.baggage.local-fields

Same as {@link #remoteFields} except that this field is not propagated to remote services. @see BaggagePropagationConfig.SingleBaggageField#local(BaggageField)

spring.sleuth.baggage.remote-fields

List of fields that are referenced the same in-process as it is on the wire. For example, the field "x-vcap-request-id" would be set as-is including the prefix. @see BaggagePropagationConfig.SingleBaggageField#remote(BaggageField) @see BaggagePropagationConfig.SingleBaggageField.Builder#addKeyName(String)

spring.sleuth.baggage.tag-fields

A list of {@link BaggageField#name() fields} to tag into the span. @see Tags#BAGGAGE_FIELD

spring.sleuth.circuitbreaker.enabled

true

Enable Spring Cloud CircuitBreaker instrumentation.

spring.sleuth.enabled

true

spring.sleuth.feign.enabled

true

Enable span information propagation when using Feign.

spring.sleuth.feign.processor.enabled

true

Enable post processor that wraps Feign Context in its tracing representations.

spring.sleuth.grpc.enabled

true

Enable span information propagation when using GRPC.

spring.sleuth.http.enabled

true

spring.sleuth.http.legacy.enabled

false

spring.sleuth.integration.enabled

true

Enable Spring Integration sleuth instrumentation.

spring.sleuth.integration.patterns

[!hystrixStreamOutput*, , !channel]

An array of patterns against which channel names will be matched. @see org.springframework.integration.config.GlobalChannelInterceptor#patterns() Defaults to any channel name not matching the Hystrix Stream and functional Stream channel names.

spring.sleuth.integration.websockets.enabled

true

Enable tracing for WebSockets.

spring.sleuth.messaging.enabled

false

Should messaging be turned on.

spring.sleuth.messaging.jms.enabled

true

Enable tracing of JMS.

spring.sleuth.messaging.jms.remote-service-name

jms

spring.sleuth.messaging.kafka.enabled

true

Enable tracing of Kafka.

spring.sleuth.messaging.kafka.mapper.enabled

true

Enable DefaultKafkaHeaderMapper tracing for Kafka.

spring.sleuth.messaging.kafka.remote-service-name

kafka

spring.sleuth.messaging.rabbit.enabled

true

Enable tracing of RabbitMQ.

spring.sleuth.messaging.rabbit.remote-service-name

rabbitmq

spring.sleuth.opentracing.enabled

true

spring.sleuth.reactor.decorate-on-each

true

When true decorates on each operator, will be less performing, but logging will always contain the tracing entries in each operator. When false decorates on last operator, will be more performing, but logging might not always contain the tracing entries.

spring.sleuth.reactor.enabled

true

When true enables instrumentation for reactor.

spring.sleuth.redis.enabled

true

Enable span information propagation when using Redis.

spring.sleuth.redis.remote-service-name

redis

Service name for the remote Redis endpoint.

spring.sleuth.rxjava.schedulers.hook.enabled

true

Enable support for RxJava via RxJavaSchedulersHook.

spring.sleuth.rxjava.schedulers.ignoredthreads

[HystrixMetricPoller, ^RxComputation.*$]

Thread names for which spans will not be sampled.

spring.sleuth.sampler.probability

Probability of requests that should be sampled. E.g. 1.0 - 100% requests should be sampled. The precision is whole-numbers only (i.e. there’s no support for 0.1% of the traces).

spring.sleuth.sampler.rate

10

A rate per second can be a nice choice for low-traffic endpoints as it allows you surge protection. For example, you may never expect the endpoint to get more than 50 requests per second. If there was a sudden surge of traffic, to 5000 requests per second, you would still end up with 50 traces per second. Conversely, if you had a percentage, like 10%, the same surge would end up with 500 traces per second, possibly overloading your storage. Amazon X-Ray includes a rate-limited sampler (named Reservoir) for this purpose. Brave has taken the same approach via the {@link brave.sampler.RateLimitingSampler}.

spring.sleuth.scheduled.enabled

true

Enable tracing for {@link org.springframework.scheduling.annotation.Scheduled}.

spring.sleuth.scheduled.skip-pattern

Pattern for the fully qualified name of a class that should be skipped.

spring.sleuth.supports-join

true

True means the tracing system supports sharing a span ID between a client and server.

spring.sleuth.trace-id128

false

When true, generate 128-bit trace IDs instead of 64-bit ones.

spring.sleuth.web.additional-skip-pattern

Additional pattern for URLs that should be skipped in tracing. This will be appended to the {@link SleuthWebProperties#skipPattern}.

spring.sleuth.web.client.enabled

true

Enable interceptor injecting into {@link org.springframework.web.client.RestTemplate}.

spring.sleuth.web.client.skip-pattern

Pattern for URLs that should be skipped in client side tracing.

spring.sleuth.web.enabled

true

When true enables instrumentation for web applications.

spring.sleuth.web.exception-logging-filter-enabled

true

Flag to toggle the presence of a filter that logs thrown exceptions.

spring.sleuth.web.exception-throwing-filter-enabled

true

Flag to toggle the presence of a filter that logs thrown exceptions. @deprecated use {@link #exceptionLoggingFilterEnabled}

spring.sleuth.web.filter-order

Order in which the tracing filters should be registered. Defaults to {@link TraceHttpAutoConfiguration#TRACING_FILTER_ORDER}.

spring.sleuth.web.ignore-auto-configured-skip-patterns

false

If set to true, auto-configured skip patterns will be ignored. @see TraceWebAutoConfiguration

spring.sleuth.web.skip-pattern

/api-docs.|/swagger.|.\.png|.\.css|.\.js|.\.html|/favicon.ico|/hystrix.stream

Pattern for URLs that should be skipped in tracing.

spring.zipkin.activemq.message-max-bytes

100000

Maximum number of bytes for a given message with spans sent to Zipkin over ActiveMQ.

spring.zipkin.activemq.queue

zipkin

Name of the ActiveMQ queue where spans should be sent to Zipkin.

spring.zipkin.base-url

localhost:9411/

URL of the zipkin query server instance. You can also provide the service id of the Zipkin server if Zipkin’s registered in service discovery (e.g. zipkinserver/).

spring.zipkin.compression.enabled

false

spring.zipkin.discovery-client-enabled

If set to {@code false}, will treat the {@link ZipkinProperties#baseUrl} as a URL always.

spring.zipkin.enabled

true

Enables sending spans to Zipkin.

spring.zipkin.encoder

Encoding type of spans sent to Zipkin. Set to {@link SpanBytesEncoder#JSON_V1} if your server is not recent.

spring.zipkin.kafka.topic

zipkin

Name of the Kafka topic where spans should be sent to Zipkin.

spring.zipkin.locator.discovery.enabled

false

Enabling of locating the host name via service discovery.

spring.zipkin.message-timeout

1

Timeout in seconds before pending spans will be sent in batches to Zipkin.

spring.zipkin.rabbitmq.addresses

Addresses of the RabbitMQ brokers used to send spans to Zipkin

spring.zipkin.rabbitmq.queue

zipkin

Name of the RabbitMQ queue where spans should be sent to Zipkin.

spring.zipkin.sender.type

Means of sending spans to Zipkin.

spring.zipkin.service.name

The name of the service, from which the Span was sent via HTTP, that should appear in Zipkin.

+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/css/spring.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/css/spring.css new file mode 100644 index 00000000..ca64edd5 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/css/spring.css @@ -0,0 +1 @@ +@import url("https://fonts.googleapis.com/css?family=Open+Sans:400,700&display=swap");/*! normalize.css v2.1.2 | MIT License | git.io/normalize */article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html,body{font-size:100%}html{font-family:'Open Sans', sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}*,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body{background:white;color:#000;padding:0;margin:0;font-size:16px;font-family:'Open Sans', sans-serif;font-weight:normal;font-style:normal;line-height:1.6em;position:relative;cursor:auto}a:hover{cursor:pointer}img,object,embed{max-width:100%;height:auto}object,embed{height:100%}img{-ms-interpolation-mode:bicubic}#map_canvas img,#map_canvas embed,#map_canvas object,.map_canvas img,.map_canvas embed,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}.antialiased{-webkit-font-smoothing:antialiased}img{display:inline-block;vertical-align:middle}textarea{height:auto;min-height:50px}select{width:100%}object,svg{display:inline-block;vertical-align:middle}.center{margin-left:auto;margin-right:auto}.spread,.stretch{width:100%}p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{line-height:1.6}.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#0b0a0a;font-weight:bold;margin-top:0;margin-bottom:0.8em}div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}a{color:#086dc3;line-height:inherit;text-decoration:none}a:hover,a:focus{color:#086dc3;text-decoration:underline}a img{border:none}p{font-family:inherit;font-weight:normal;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}p aside{font-size:0.875em;line-height:1.35;font-style:italic}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:Montserrat, sans-serif;font-weight:400;font-style:normal;color:#000;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:0.5em;line-height:1.0125em}h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#867c74;line-height:0}h1{font-size:2.125em}h2{font-size:1.6875em}h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}h4{font-size:1.125em}h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #dce6e6;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic;line-height:inherit}strong,b{font-weight:bold;line-height:inherit}small{font-size:60%;line-height:inherit}code{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-weight:normal;color:#3d3d3c;word-break:break-word}a:not(pre)>code{border:1px solid #086dc3;color:#086dc3}ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}ul,ol{margin-left:1.5em}ul.no-bullet,ol.no-bullet{margin-left:1.5em}ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}ul.no-bullet{list-style:none}ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}dl dt{margin-bottom:0.3125em;font-weight:bold}dl dd{margin-bottom:1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#000;border-bottom:1px dotted #dddddd;cursor:help}abbr{text-transform:none}blockquote{margin:0 0 1.25em;padding:0.5625em 1.25em 0 1.1875em;border-left:1px solid #dddddd}blockquote cite{display:block;font-size:0.9375em;color:rgba(0,0,0,0.6)}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,0.6)}blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,0.85)}.vcard{display:inline-block;margin:0 0 1.25em 0;border:1px solid #dddddd;padding:0.625em 0.75em}.vcard li{margin:0;display:block}.vcard .fn{font-weight:bold;font-size:0.9375em}.vevent .summary{font-weight:bold}.vevent abbr{cursor:auto;text-decoration:none;font-weight:bold;border:none;padding:0 0.0625em}#tocbot{padding:0 0 0.5rem 0;line-height:1.5rem;padding-left:10px}.mobile-toc{padding:0 0 1rem 0;line-height:1.5rem}.mobile-toc li a{display:block;padding:.3rem 0}#tocbot ol li{list-style:none;padding:0;margin:0}#tocbot ol{margin:0;padding:0}#tocbot ol ol{padding-left:0.6rem}#tocbot .toc-link{display:block;padding-top:.6rem;padding-bottom:.6rem;outline:none;border-radius:4px;font-size:15px;transition:all .15s}#tocbot .toc-link:hover{background:#ebf2f2;color:#06c;text-decoration:none}table{background:white;margin-bottom:1.25em;border:solid 1px #d4dfdf;border-spacing:0}table thead,table tfoot{background:#ebf2f2;font-weight:bold}table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:0.5em 0.625em 0.625em;font-size:inherit;color:#000;text-align:left}table tr th,table tr td{padding:0.5625em 0.625em;font-size:inherit;color:#000}table tr.even,table tr.alt,table tr:nth-child(even){background:#f5f9f9}table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}body{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;tab-size:4}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-0.05em}.clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}.clearfix:after,.float-group:after{clear:both}*:not(pre)>code{white-space:nowrap;background-color:#fff;border:1px solid #e1e1e8;color:#009;padding:2px 6px;font-size:.875rem;font-family:Monaco, Menlo, Consolas, "Courier New", monospace}pre,pre>code{line-height:1.85;color:rgba(0,0,0,0.9);font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-weight:normal;text-rendering:optimizeSpeed;word-break:normal}pre{overflow:auto}em em{font-style:normal}strong strong{font-weight:normal}.keyseq{color:#6b625c}kbd{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;display:inline-block;color:#000;font-size:0.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 0.1em white inset;box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 0.1em white inset;margin:0 0.15em;padding:0.2em 0.5em;vertical-align:middle;position:relative;top:-0.1em;white-space:nowrap}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menuseq,.menu{color:#191715}b.button:before,b.button:after{position:relative;top:-1px;font-weight:normal}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}p a>code:hover{color:rgba(0,0,0,0.9)}#toc{border-bottom:1px solid #dce6e6;padding-bottom:0.5em}#toc>ul{margin-left:0.125em}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0.5em 0}#toc ul{list-style-type:none}#toc li{line-height:1.3334}#toc a{text-decoration:none}#toc a:active{text-decoration:underline}#toctitle{color:#0b0a0a;font-size:1.2em;display:none}body.toc2{padding-top:80px;text-rendering:optimizeLegibility}#content #toc{border-style:solid;border-width:1px;border-color:#dce6e6;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;-webkit-border-radius:4px;border-radius:4px}#content #toc>:first-child{margin-top:0}#content #toc>:last-child{margin-bottom:0}#footer{padding-bottom:2rem}#footer #footer-text{padding:2rem 0;border-top:1px solid #efefed}#footer-text{color:rgba(0,0,0,0.6);line-height:1.44}.sect1{padding-bottom:0.625em}.sect1+.sect1{border-top:1px solid #efefed}#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;margin-top:0.1rem;display:block;visibility:hidden;text-align:center;font-weight:normal;color:rgba(0,0,0,0.2)}#content h1>a.anchor:hover,h2>a.anchor:hover,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4>a.anchor:hover,h5>a.anchor:hover,h6>a.anchor:hover{color:#097dff;text-decoration:none}#content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\0023";font-size:0.85em;display:block;padding-top:0.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#000;text-decoration:none}#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#262321}.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:'Open Sans', sans-serif;font-size:1rem}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0;padding:0.6rem 0}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}.admonitionblock>table td.icon{text-align:center;vertical-align:top;padding-top:0.8em;width:80px}.admonitionblock>table td.icon img{max-width:initial}.admonitionblock>table td.icon .title{font-weight:bold;font-family:Montserrat, sans-serif;text-transform:uppercase}.admonitionblock>table td.content{padding-left:0em;padding-right:1.25em;border-left:1px solid #dce6e6}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:0;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;border-radius:4px}.exampleblock>.content>:first-child{margin-top:0}.exampleblock>.content>:last-child{margin-bottom:0}.sidebarblock{border-style:solid;border-width:0;border-color:#dce6e6;margin-bottom:1.25em;padding:1.25em;background:#ebf2f2;border-radius:4px;overflow:scroll}.sidebarblock>:first-child{margin-top:0}.sidebarblock>:last-child{margin-bottom:0}.sidebarblock>.content>.title{color:#0b0a0a;margin-top:0;text-align:center}.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}.literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#fff;border:1px solid #d9d9d9;border-radius:4px}.sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#fff;border:1px solid #d9d9d9;color:#222}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class],.listingblock pre:not(.highlight){padding:1em 1.5rem;font-size:0.8125em}.literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto}.literalblock.output pre{color:whitesmoke;background-color:rgba(0,0,0,0.9)}.listingblock{white-space:nowrap}.listingblock pre.highlightjs>code{padding:1em 1.5rem;border-radius:4px}.listingblock>.content{position:relative}.listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:0.8em;font-weight:bold;top:0.425rem;right:0.5rem;line-height:1;text-transform:uppercase;color:#999}.listingblock code[data-lang]:before{display:block}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:0.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #dce6e6}pre.pygments .lineno{display:block;margin-right:.25em}table.pyhltable .linenodiv{background:none !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:block;text-align:left;padding-left:20px}.quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,0.85);line-height:1.75;letter-spacing:0}.quoteblock blockquote{margin:0;padding:0;border:0;position:relative}.quoteblock blockquote:before{content:"\201c";font-size:2.75em;font-weight:bold;line-height:0.6em;margin-left:0em;margin-right:1rem;margin-top:0.8rem;color:rgba(0,0,0,0.1);position:absolute;top:0;left:-30px}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-right:0.5ex}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:0.5em 0;border-left:3px solid rgba(0,0,0,0.6)}.quoteblock .quoteblock blockquote{padding:0 0 0 0.75em}.quoteblock .quoteblock blockquote:before{display:none}.verseblock{margin:0 1em 1.25em 0;background-color:#f1f1f1;padding:1rem 1.4rem;border-radius:4px}.verseblock pre{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-size:0.9rem;color:rgba(0,0,0,0.85);font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:0.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:0.9375em;line-height:1.45;font-style:italic}.quoteblock .attribution br,.verseblock .attribution br{display:none}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-0.025em;color:rgba(0,0,0,0.6)}.quoteblock.abstract{margin:0 0 1.25em 0;display:block}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}table.tableblock{max-width:100%;border-collapse:separate;overflow-x:scroll}table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}table.tableblock,th.tableblock,td.tableblock{border:0 solid #d4dfdf}table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}th.halign-left,td.halign-left{text-align:left}th.halign-right,td.halign-right{text-align:right}th.halign-center,td.halign-center{text-align:center}th.valign-top,td.valign-top{vertical-align:top}th.valign-bottom,td.valign-bottom{vertical-align:bottom}th.valign-middle,td.valign-middle{vertical-align:middle}table thead th,table tfoot th{font-weight:bold}tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#34302d;font-weight:bold}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:0.625em}ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}ul.unstyled,ol.unnumbered,ul.checklist{margin-left:0.625em}ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1em;font-size:0.85em}ul.checklist li>p:first-child>input[type="checkbox"]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 auto 0.625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}ul.inline>li>*{display:block}.unstyled dl dt{font-weight:normal;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.hdlist>table,.colist>table{border:0;background:none}.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 0.625em}td.hdlist1{font-weight:bold;padding-bottom:1.25em}.literalblock+.colist,.listingblock+.colist{margin-top:-0.5em}.colist>table tr>td:first-of-type{padding:0 0.75em;line-height:1}.colist>table tr>td:first-of-type img{max-width:initial}.colist>table tr>td:last-of-type{padding:0.25em 0}.colist>table tr>td{white-space:pre-wrap}.thumb,.th{line-height:0;display:inline-block;border:solid 4px white;-webkit-box-shadow:0 0 0 1px #dddddd;box-shadow:0 0 0 1px #dddddd}.imageblock.left,.imageblock[style*="float: left"]{margin:0.25em 0.625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:0.25em 0 1.25em 0.625em}.imageblock>.title{margin-bottom:0}.imageblock.thumb,.imageblock.th{border-width:6px}.imageblock.thumb>.title,.imageblock.th>.title{padding:0 0.125em}.image.left,.image.right{margin-top:0.25em;margin-bottom:0.25em;display:inline-block;line-height:0}.image.left{margin-right:0.625em}.image.right{margin-left:0.625em}a.image{text-decoration:none;display:inline-block}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:0.875em;position:static;vertical-align:super}sup.footnote a,sup.footnoteref a{text-decoration:none}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:0.75em;padding-bottom:0.75em;margin-bottom:0.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-0.25em 0 0.75em 0;border-width:1px 0 0 0}#footnotes .footnote{padding:0 0.375em 0 0.225em;line-height:1.3334;font-size:0.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:0.2em}#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-0.625em;margin-bottom:0;padding:0.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:black}.black-background{background-color:black}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#f5f9f9}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;cursor:default}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#3f6a22}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";color:#0077b9}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#d88400}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value]{display:inline-block;color:#000 !important;background-color:#ffe157;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:0.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:bold}.conum[data-value] *{color:#fff !important}.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:0;color:#000 !important;background-color:#ffe157;font-size:12px}b.conum *{color:inherit !important}.conum:not([data-value]):empty{display:none}.admonitionblock{background-color:#ecf1e8;padding:0.8em 0;margin:30px 0;width:auto;border-radius:4px;overflow-x:auto}.admonitionblock.important{border-left:0px solid #e20000;background-color:#f9ebeb}.admonitionblock.warning{border-left:0px solid #d88400;background-color:#fff9e4}.admonitionblock.tip{border-left:0px solid #0077b9;background-color:#e9f1f6}.admonitionblock.caution{border-left:0px solid #e20000;background-color:#f9ebeb}.admonitionblock .exampleblock>.content{border:0 none;background-color:#fff}#toc a:hover{text-decoration:underline}.admonitionblock>table{margin-bottom:0}.admonitionblock>table td.content{border-left:none}@media print{#tocbot a.toc-link.node-name--H4{display:none}}.is-collapsible{max-height:1000px;overflow:hidden;transition:all 200ms ease-in-out}.is-collapsed{max-height:0}#index-link{display:none}ul li>p>a>code{color:#086dc3}ul li>p>a:hover>code{color:#086dc3}#content .listingblock .switch{border-style:none;display:inline-block;position:relative;bottom:0;margin-bottom:4px}#content .listingblock .switch--item:not(:first-child){border:2px solid #000}#content .listingblock .switch--item{padding:6px 12px;background-color:#fff;color:#000;display:inline-block;cursor:pointer;border:2px solid #000;margin-right:2px;border-radius:0}#content .listingblock .switch--item:hover{color:#086dc3}#content .listingblock .switch--item.selected{background-color:#000;color:#fff;border-color:#000}#content .listingblock .switch--item.selected:hover{color:#fff}#content .listingblock pre.highlightjs{padding:0}div.back-action,#toc.toc2 div.back-action{padding:0.8rem 0 0 5px}div.back-action a,#toc.toc2 div.back-action a{position:relative;display:inline-block;padding:0.6rem 1.2rem;padding-left:35px}div.back-action a span,#toc.toc2 div.back-action a span{position:absolute;left:5px;top:5px;display:block;color:#333;height:26px;width:26px;border-radius:13px}div.back-action a i,#toc.toc2 div.back-action a i{position:absolute;top:10px;left:5px}div.back-action a:hover span,#toc.toc2 div.back-action a:hover span{color:#000}#tocbot.desktop-toc{padding:.5rem}#header-spring{position:absolute;text-rendering:optimizeLegibility;top:0;left:0;right:0;height:80px;margin:0 1rem;padding:0 1rem;border-bottom:1px solid #dce6e6}#header-spring h1{margin:0;padding:0;font-size:22px;text-align:left;line-height:76px;padding-left:0.6rem}#header-spring h1 svg{width:240px}#header-spring h1 svg .st0{fill:#6bb536}#header-spring h1 svg .st2{fill:#444}body.book #header-spring{position:relative;top:auto;left:auto;right:auto;margin:0}body.book #header>h1:only-child{border:0 none;padding-bottom:1.2rem;font-size:1.8rem}body.book #header,body.book #content,body.book #footnotes,body.book #footer{margin:0 auto}body.toc2 #header-spring{position:absolute;left:0;right:0;top:0}body.toc2 #header>h1:only-child{font-size:2.2rem}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{margin:0 auto}body.toc2 #content{padding-top:2rem}#header,#content,#footnotes,#footer{width:100%;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:0.9375em;padding-right:0.9375em}#header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}#header:after,#content:after,#footnotes:after,#footer:after{clear:both}#content{margin-top:1.25em}#content:before{content:none}#header{position:relative}#header>h1:first-child{margin-top:2.55rem;margin-bottom:0.5em;margin-bottom:0.7em;font-size:2rem}#header>h1:first-child+#toc{margin-top:8px;border-top:0 none}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ebf2f2;padding-bottom:8px}#header .details{line-height:1.45;color:#222;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap;background-color:#ebf2f2;padding:2rem 2.5rem}#header .details span:first-child{margin-left:-0.125em}#header .details span.email a{color:rgba(0,0,0,0.85)}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,0.85)}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:rgba(0,0,0,0.85);border-bottom:1px solid #ebf2f2;padding-bottom:8px;margin-top:0;padding-top:1.5rem;margin-bottom:1.25rem}h1{font-size:2.2rem}h1,h2,h3,h4,h5,h6{font-weight:bold;font-family:Montserrat, Arial, Helvetica, sans-serif}h1:focus,h2:focus,h3:focus,h4:focus,h5:focus,h6:focus{box-shadow:none;outline:none}h2,h3,h4,h5,h6{padding:.8rem 0 .4rem}h1{font-size:1.75em}h2{font-size:1.6rem}h3{font-size:1.5rem}h4{font-size:1.4rem}h5{font-size:1.3rem}h6{font-size:1.2rem}pre.highlight{padding:20px;border:1px solid #d9d9d9;overflow-x:scroll;color:#222}pre.highlight code{color:#222}pre.highlight a,#toc.toc2 a{color:#000}pre.highlight ul.sectlevel1,#toc.toc2 ul.sectlevel1{padding-left:0.2rem}pre.highlight ul.sectlevel1 li,#toc.toc2 ul.sectlevel1 li{line-height:1.4rem}::selection{background-color:#d1ff79}.literalblock pre::selection,.listingblock pre[class="highlight"]::selection,.highlight::selection,pre::selection,.highlight code::selection,.highlight code span::selection{background:rgba(0,0,0,0.2) !important}body.book #header{margin-bottom:2rem}body.toc2 #header{margin-bottom:0}.desktop-toc{display:none}.admonitionblock td.icon{display:none}.admonitionblock>table td.content{padding-left:1.25em}@media only screen and (min-width: 768px){#toctitle{font-size:1.375em}.sect1{padding-bottom:1.25em}.mobile-toc{display:none}.desktop-toc{display:block}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:0.90625em}.admonitionblock td.icon{display:table-cell}.admonitionblock>table td.content{padding-left:0}#header{position:relative;min-height:98px;padding-right:210px}#header::after{position:absolute;right:0;top:0;display:block;content:'';height:98px;width:203px;z-index:-1;background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAmIAAAEmCAIAAABOFWtWAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ODRBOEI2NUE1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6ODRBOEI2NUI1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo4NEE4QjY1ODUwQjUxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo4NEE4QjY1OTUwQjUxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PooJeGcAAB/mSURBVHja7N15eFX3fefxe/a7SlcLkpBACMQmoQUBBrxgjI2xMdgY2xgbuxCnqdMlTZpp43SZTJvMNGmWmenM/5mnfZ72adqnSZrHTSeeNG2TyTSJFxw7BtuxcbCx2dF697PNkeQABiTule5ylvfrcRybOAa+53fu535/5/f7HeGH6e9+L/10CD6VHU6N//xNURAoBXC5TR277l7+69QBsxMEQWxXOimEXxmmmT1xkowErnBDx04yEkUSO+QuIcTHqD/lToyYuSx1AC63oX3HPct/kzqg2JhUBbVNWkQh/Mcyrdy5M9QBuNy6hdt2rfht6oASYtL5z2JtKYXwn/E33rMtgzoAF61t27p75SepA0pg27Lz5w6Zx5N+ky8UjIlR6gBc1kfece/K36EOKC0lQ6HJmGyR2qmFn1i2nXn9tG1ZlAKYtqH97l0rfos6oFTC9KRrs9QqCjLl8E9M5nQjM0IdgGkb23eSkZhrTgqTMSkJ8hK5m2r4Zo4g89Y5ygD8so/cuXMF61oxd+L0f63QeqiFP5hpPZ86Tx0Ax/qFd+0iI1GWmOyQu6iFP1pJ/R2mW4FJQ23bd6/8GHVAeWKyWWqhFn4woU9MnKIMQH/rrfet+gR1wLx7D/v9mIyIsU6Fx5Oel32Hp5JAaKBly97Vv0cdUAbTS3imrY/cTEG8/aVnOJ9KE5MIuqHWbXt7nuIMTpTLpX0gncoyyuFpmZOs3EHQrWu7895VH6cOKFv7MX0Kz7SYGJ/aSWlTF09ODAybmTQxiUBbv/Au1uygzB+tF5fwTPWVSl94HUXxqNSp0xQBge4jF+4gI1GBnLzs2aRjY2QLNfEicTyUYa8kAmyobfu9K3nvByrzAXv537RIHdIHfwSecP6dNykCAmuwdSt7P1ClmFQERRZUiuIthbxuZjLUAcG0ZsGN97P3A1WLSSEk3B67l6J4S/6tsyGbhVcIop7mzQ/2/gF1QPVi0jEUuVETNOriFZYTkyneK4kgGmi59eE1f8T+SFTWxVN4LpJDUoPURGW8Inds2LYM6oCgWdt6+96eT1EH1KCbdKwL30JdvPEtx7TT59+lDgiaobbte1Z/kjqgGq7YEDJtMLxJFcMUx/1Sp4Y5DgLBy8g7WdeKGneTiiC3S4sojcuZhjl+4hfUAYGytm3bfZxFh5rHpKMvvIHSuFw+lVFFhTogOPpatuxZ9R+oA1wRk0PhzZrAvKu7Y/K9MYqA4OhdsOnBnqeoA9wSk0JI6FJWUh3XMnIFPXWBOiAgVi3Y+FDPH1IH1MDVG0IuGoxspD6ulRoeZrMYAqKv5ZZHej9zzfWGQMXNMvK6ldUJMUmJXMiybetsmjogCPpbtz7Y82nqgBqaMSYVQenX1lMgF9JTBSM3QR3gewNt2x7gvFbU1iyTro4ebZASuVDq3FlBYM4VPjfYette1rWi5maf7u9QlrRK7VTJVUzLskaYcYXP9bVsuX/171IHuMF1nopviHBwnbsURrIhI08d4GM97P2Ah2JyudZDjVwlc/YURYCPrWrasK/3j6gDPBOT9WLjcoWkdAvdMMyJLHWAjzNy/5rP8G4seCkmHbfG7qZMLpE/kxJsizrAl3qbNz/S98fsj4T3YnKh3BGVElTKDXLDZygCfKl/wZZ9a5hrhfvMviFkmiQod8cfoFZuIORpJeFDAy1bH+hlzQ7c+bFb3PxGjzIgC7yMosb0kZxlFqgDfKavZcveHs4QgHsVFZOSIG+M3kqxait7lrPO4Te9zTez9wN+iEnH9uh9ihChXjVkpDmgDr6yqumGfWt+nzrAJzHpWKbyaq2ayRdyps6pAvCP5Y3r9q/5DHWAr2LyrvgekbXaNRI+I1EE+MaKpqEDk3s/2B8Jf8VkUmxqlzopWQ3YoZEzxygD/GF106YDfZ9jfyQ88vFrlzZSb4/tDnFARvUvk2XrrHGFL/QuuHl/33+kDvCMUr/Qdakrlik8oaw2bUKa7CgBj1uz4JZ9vazZgceUPO9xS/ROTlys8peZ/OkRqgDP95HNNz/U+2nqAI8pddJ1uqFcrnIYevXIhnh+7Dh1gKetbt7M3g94s0+Z01N0p6GkdFVj6DyVhLctb16/n/Na4VlzicnFytKV6hpqVx3SOFPc8HJGNq490PufqAOCFZNOF8rbtaqmMDxGEeDdjHy077Ps/UAAYzK0UF60goay8mxTGJ04QR3gRauaNjzW/585kwQBjUkhJN4Zv4/yVVzetGy2gsB7VjdveqTvj6kDghuTjmapbTByAxWsbEpy3Dk8qGfBjfvXcIYAAh+Tjnti+6WQTBEraNSgBvBYRjZvfrj3D6kDiMlJiqDcEruLIlaIZdvpsbPUAR6yomnDw+z9ADF5ua3RHQmxjjpWJCazpsVRrvCOZcmBAzyPBDF5tTtie6hjJegTKYoAz2Rk48BjA5+jDiAmr2EgvKFN6qCUZZedGKcI8ISl9X2P9X1OFHgrKojJGexM7OM89LKzJ3IUAe63snH9wbVfICNBTM5msbK0L7yBapZRQc/reSZd4f6MvOHR/j+hDvBvv2KX7YCM26O7YmKckpaLmTElvp7D3VY3bXq0n/Na4WtlPGuxXmrYFttFScsmo1MDuNmqphv293GGAPyvnMctrgvf1KUsp6blSckMr2KGe3U3DD3SRx8JYrJ09yQepqZlIRVYEgWXWlLf8zh7P0BMzk2z1Lottpuyzp9QMCkCXKizsefg4BeoA4jJudsc2RqXklR2ngosc4ULM7Kh51Afez9ATM6PIqiP1T3JNsr5sDJmiPdnwWVWNAw+MfAlMhLEZBm0yO1rwuso7tyvCp0kXJeR6w4M/BfqAGKyPJxW8oHEwUZ5AfWdm2yKZa5wkZWNGw4MfJY6gJgss72JQ7KgUOI5yOc4zRVu0d2w/tF+3vsBYrICOuTFN0e3U+I5kAyRIsANuhr6Hx/4E+qAwBLKeArPNW2N3r1YWUahS2XpHMGD2uusX3Vo4E+pA4LMLuOZrjPZW/e4ImjUuiSGmaUIqHlGHhz4sxBL1hF4FY/JpNi0K76PQpcgL1jsBkHN+8jBL0qiTCmAajwD6w+v7wuvp9bFXpIMNUAtdSX7n1j7FfZHAtWLSSEk3hXb2yA1U+5i2DkeTKJmliWHDg1+njoAVY1JR0xMPFL/a0KIBZzXl8tOUATURHfDul8Z5ExzoBYx6Vggte2te5wVAdeVzlygCKhBRtYPPM4ZAkANY9LRp60fDG+k6LOz9AJFQJUtSfY+vpa9H0CtY9KxJ/FoUmqi7rNgahpV1lG3/NAA78YC3BGTTgp8tOFTvGlr1naS3SConkWJFU8MfqnSJ40AxGQJNCHyUPxxkeNeZ2BbFkVA1TLy0NCXJJGbEXBTTDo61RW3R++h+tduJi2DIqAKltT3/uq6/yYLnCEAuC8mHTdFb78hsoULcIVsLuMEJXVApS2tH/jQ2i9SB2B21TjTdRY7Yns6lW4uwwdiMpNmCQ+qkJEHWdcKFEGo7XN7SVAeqj8UEeNciUuXxGIGDJXVVddHRgLFq3HjEhfqP9rwKYn+6eL1sDh+ARXUUbfy0BB7PwDvxKSjTkx+vOmzAqfzTLEL7AZBpSxKdH947ZepA1C8ZDTqijYuIdYdqPso1yM0OelKTKIi2hPdB9d+WWR/JFC0hlhMdM+e4m6t59boDq6KbbDMFeXXEXf6yK8o7I8Eis/IaFQSRcFVR2/cFtu1LnJT4LtJYhJl1lnX85H1f847loFiP4cFwekjJen9V666awZmd3z/mmC/wNk0OFsA5dSVXPPE0JeoA1B8Rian+siLP+K6BxUPJg52qz1BzkmGKcplSXLNocE/ow7AnDPSjTHpeKz+19ukDrpJYD4663s+REYC88tIl8ak48nGpxRBDeB1smydwYr5W5jofmItc61ACa6ZkTU+rG52v9f8+QBep4KeZbBintriyz4y9BXqAJSQkbHY1RkZqvlhdbNTQsqnm78oB+x9WwbPJjHPPjK+9MNDXxZ57wdQSkbK4oxp6Oq9xpoQ/mTjZxNSfXCuFru/MR9dyb5fHfqviqhSCqBIDdHoLBnp9ph0RMTYxxo+0yotDMgFU+QwoxZz09t886HBL/COZaBIV+yPvCZXP5u8lByC8mTjU13KyiBcNklirgxzsbZl+741v08dgOIzsv5aa3au/se8McUnhMSDyd9apfYHICaZLkPJNrbfu6fnE9QBKCkjZfH6CeiNbvKi/fUfGdQ2+vviiZwohpIGjCBuW/LYzhVPUgqg+IxMRiLFZOQ0j30o76l7TE6pL2R/6NtPPUUxGcUocrSEhAdWf3JNy22UAihesoi51ssz1Xu9yz3xhzQx/O/pf/bnBZQlBjGK9OF1X+5IrKIOQIUy0pPd5GS2h4Q7orsVW/p+5hkf9gcSG0JQlCc3/PnCWDd1AErIyFn3R/onJqeTcmvsHlGQ/y3zjG37az++KDCUMbuwFH1i3Rdbol2UAiheQ+l9ZGhqCY+HF4xsie5YIC98euJvslbaNxfSlolJzKYr2fdAz+8m1GZKARTbWc1wpnmR/19vr6tcrfY31Df+3fhXR8wLPolJ0WZMYybrFu64b9XHbJvvUkAJOVc/14x8/9/gdJRer0LKHv/G2F8e19/0wRUdOT9iHHuHkY0rqJJ2W9ejNy56kFIApWakLM5rzYcfYnKyCQvZ/zjxty/mfuT138jw2AXztXcZ3LhcWIoeWvu5tjiLWoHSMjIZicx+Fl2AYnLaC9kffTv1NU//FgzLHH7uZSHEeldc6iN/Z/NXI3I9pQBK0jDDu7ECHZOOs+apr478d93Oe/e3cO7Zn4VsiyEOR0/zxr09n1JEDsQHSpOMRmWpDNvQnYj0W0w6xq3Rvxj9n6OeXdRz4fmjlqkzynFn98GbFz/svzsUqHhGzml/ZFC6yWlpK/Wd1N8fyb/oxV/88OGjpk5MBlpcTe5Z/dvLGzZSCqBWfaTPY3Lac9kf/Ev623k757Fu8sWjVoGYDK6lDQP3r/p4ndZKKYCaZ6Q/J10vd948842xvzxtvuelX/NPj9p5YjKIZEG+tWvfls5HQqzhAkrt+QShPhIpb0YGIiYdpm18N/30s9nvT24b8YLUayezY+cY9EFTry14uO+p9vhqSgHMJSPnvT9yxn95QBYIHNePfX38f6WtlAdy/Z3s8KmfM+6DQwwJncmeg4N/KoR42yhQeow53zLLPdcarG7y0u82ZP/FyP84YfzC7b/Q8/a5Yy8z9IPjgZ6P97fcSR2AuSnX/khicpJlm68UXviH8b92dW+Rlc68fJihHwRN0YVPDH0+JnOOOTBHyYr1kZe61QDuyjpnnvrm+F+dNlx6Jpxt2eefo5v0vxsX7d7a9bgmxSgF4NqMDGhMOgp24cXcj55JfcOdv7yR5181zAL3gF+1xjt3LPtwd+MGjg4AXJ6RwY3J99PIPP9M6utvFF61XbYIduLFY7lCitvAl7Z1PXLz4ockUaMUgPszMnDPJq/plfzhf0n/o6sOt0sdeTubGuVO8Behq6539+rfbIp0Ugtg7jdSZfZHEpPXL8TTqa8dyR/WbVdMdaZefzs7Skz6R1Sp2979K0Otd1MKYL4ZWbH9kTP+pMTkRcPG2a+Nf/W8ebr2Q+G9/Nl3X+OK+IAkiN0NQ/v6/kAWmGUF5vfBWMn9kcRk0W1lyH45/9y3ar1jRBtT3n3teS6H1ymi+uT6rzRHu6ZucADzUtH9kcRkadLWxHdS3ziSr9nmRdGUzjzP1klv29b16E2LHpAlXhUJlEGyFn0kMXkdZ42T/yf1D2/pr9fkZx8//GZeT3MVPEcW5Bs6dm1etKdOW0A1AK9nJEt4ru8Xhde/l/72SePtKv+82SMnUykOQPcSURCH2rbfuPj+pshiqgH4ICPpJotl2ebP8s//3+z3ho0z1YvJN86khk9TfK/oadp029IDLbFllALwU0YSkyUwbeMn2R/8OPuvKWu8Cj9d7sT5iZPvUXb3W5Jcs6P7Qx2JHm4loJzhVN39kTNh0nUunkl//afZZ/N2rqI/i3TePs17QlxMFMSW2JLdK39jkROQlAMoe0ZWfX8kMVlOuq1/a+KvXiu8YtlGhX4KJS2ffOUFSu3KgBQawgvv7/nYokQ/1QAqwQ1zrZcym5icT1j+IP3M/8t+t0L//nM/eYkiu83iuhV7Vn+iMbxYEESqAVQkI2MxN/SRdJNlk7Myrxd+9k+pb+p2trz/5sKr58bGT1Jhlxhs3bKl80BjpJ2ABCqnPhpVXNNHEpPl7SwLx/Vj30//7zJuHSmcuDB28l1qW1uKqG5YuHN9x86mSDuH6QCByshpxGSZHdff+EnmB68XyrD6Rhq1T7/OKp6aianJG9p3DrZtT2otVAMIZkYSk5Vyynj32ey/vV44mrPmfpKOoqsnDz9HMatvQXTRYOsdQ+07onId1QCqwFVrdi7HpGtlWbZ1OPejl3PPnjTfnduaWP3I2dHUKSpZHQkl2Rbv3rz4/qXJQUFgfhWoSq/mjv2RxGSNpeyJH2f/9WfZF1LWuB2yShhAJ/JnT/JGrcpSxHBTtOOmxff2t9xBNYBqZ6Q79kcSk24xal74Tuqbb+qvFtlc2mP5868RkxUhhgRJVLZ0Pri5Y68iRygIUH2unWv9QJYTk9Wn2/oJ/dg/p7912rjOfg85L5/6KYcMlDsgBWFt2+13dj+hijFRkCkIQEYSky41bo2+ox87nP3xcf3nM7SToexLb6fyo9Rq/jQ5PNB622DrHU3RjrCUoCBADbl2XSsx6VIT1tg549Sr+ZeO5F/K2R9YHCsdz58+w7zr3HXULe9dcEt3w9rmyGJJVCkIQEYSk952Qv/F24U3XiscOWW8bTvt5AX93JtHKUuJjWN0ecNQT/PmjvpVyfDCEGMcICPnhCU8rjZuj72Rf+Xo2OE3X/nhcPYMBZmdGBJa4l2L6latat60tL5fEjVqAriNV55H0k16iXOBLqRS59JvvTXy0s9HXhzJnpzIXTAq9mYSz3WNjeG2BdFFq5s3dTcOaXId4xlwadi4e38kMeltE7lcXtcv/m3eSh09+8NXz/776cyJnD6uW4VAVSMixyJKYlnD4Nq22zuT/aZpMkIAtyfN1FyrFzOSSVdvMCxrNH3tQ+9EQXh37OhP3nv6yLkfh0KmHbIt311QURCFkOg0jjcuvmfTonsVgQPkAI9JejMjiUnvXKdQ6MLExPX+GduwdMMu2Fbh7bEjb4289Obw86O5Cx79Lbcnlqxo3LCsYd2CeJdoy7KoSKLCSADIyBq0wsSkJ4yk06ZllXZpJ9vQQtacyBZSKX34vfFXj48eOZU6ntHHXfVbqws3dcSXdybXtMdXxtRkWI5F5Di7/gF/8Na6VrpJD9MNYyxbhtc+C4JgOtlpTGT0iayeyhnptD4ykjs9lj0znD89nDmV0VPl/ZWLghDXGpvD7fXhtoZIa0OkJSIlNCUeVeIRORGWE2JIZAgCZCQxifm6kEpV+mI5Iapbuaw+Ydi6k6ampRtTfzh/oVtTP2LqesgwLcOyCrYgyIJzCyiyIEuCKomyIqqyKEuiqkiK5PxPoqpKalROCoLEMAPISI8iJj1jDvOuAFATXn8eeTmRy+kVmsIaFgCu770EwU8Z6XSSxKRnhIlJAC7PyFDIo2cI0E364lIJgiRyvQC4V72P+khi0pMUmW0SAFwq6ceMFASBmPSSCPOuANzZR/purpVu0pMkUfTrQATg4YyMRn0810VMeoxGTAJwWR+p+PpziZj0GFVVBaoAwB2Svu4jQ2wI8SJJEFjIA8AVfaQf1+xcgSU8nsQGSgCu6COD8QyImPQeVZadLzjUAUANMzIgywmZdPUqDq4DQEbSTWJGYR5PAqgFH++PvCaeTXqVM0w5uA5AtTPS7+tar8akq5cbSlWlCACq2Ucqwdu3TTfpYZwzAIA+sgqISc9eOVFUeUIJoDoZGeDv5cSkhyXCYYoAgIysHJ5NetvkpDkLeQBUTDLYGUk36Qd1NJQAKtZH8koiYtLz5MmNIVxEAOX+Ch7Ida1XY6WrH0TYGQKgvH1kJMIKQbpJH8Wkoogc8QqgfBnJa4iISR8mJUUAUIaMDPD+SGLSz8KqSkMJoAwZyfPID2JDiE8IgsCCNABkZCU+XYlJn4hpGkUAQEaWHTHpExJn1wEgI8uNSVcaSgCBxv5IuslgNZRhlrwCKCUjmYWaHc8m/SbKUQMAyEi6Scx4OUUxRlICuB7O2SEmg0tTVXZQApgtIzlDgJgM9BUVBNbyAJgtI1mzQ0zSUFIEANfISNa1logNIf4khELxSIQ6ALhcgrlWuklcFJZlTnkFcFFdJKLRRxKTuFw8HKYIAELs/ZgH9k36mXNX8BACABlJN4kZxTRNYOoVCDD2RxKTmI0sSRrH1wGBzUjW7BCTuK64pokiVxkIZEby2GXe2BASlKSkCECwMpL9kWXCEp5AUGVZY+IFCIzJd2Nxy5cPMRkIURpKIDAZyZqdMmLSNSgkUUywjRIgI0E3iZk4Nw9reQAyEsQkrk0QhDoaSsCn2B9ZuU9OYjJAZEniRgJ8mJHsj6SbRLnURSKcywP4LSPZ+0FMopxJydQr4JuMZH8kMYmyU2Q5wnubAe+Lsz+y8tgQElAxTZP4Bgp4WV0kEiYj6SZRwXssHOYhJeDdjGQ5HjGJypJEkbNeATISs2NDSKBpisJrtgAyEnSTmFFM00SmXgGP4AwBYhJVv/yCUB+NUgfAAxnJGQLEJGpCEsUY+0MAd6tjf2SNsCEEkyKaJnMqOuBWceZaa4clPHhffSzGQ0rAnRnJ/sjaIiYx9Y1p6skHOykBV+EMAWISLjL96mZyEnBPRjLXSkzCXZx7MsxyHoCMxC+xhAdXimmaxs0JkJGYwhIeXEOCpedA7dRHo2SkqxCTuIY4DymBGvWRfEklJuEBkijWx2LUAajq11PmWolJeIgsis4XW+oAVEciHGbvhwuxhAezYeErUB3OV1Je1+NOLOHBdcQ1jVkgoNIZyV1GNwlv38OsKQDISLpJYEaTb/DhbHSAjAwkPvtQXFLGYjI9JUBGEpPAjEkZiYj0lAAZSUwC1yQIQpK3iADzxv5ID2EJD0r8ViUIDRw7AMwD+yM91x4Qkyg5KRvjceoAzK2PZH+k95LS6SipAkpl2fZIKsXQAYr/fjn5+h0ykphEgJLSskYyGcYPUExGNsRiPNf36uWjBJjj0BHFRp5TAtftRaaeU5CRHsUSHsz7/icpgZlJzrdJnuV7/FOOSVfM1+RzynSagQRcQRbFevZQeR/dJOY9hnjuAlxFkSQy0icNJU0AytVTjmYylmVRCkCR5bpwmIwkJoEPcMbSWDZrmCalQJCpspwgI4lJYCbjmUyBpERQaYriZCR1ICaB2aTz+WyhQB0QNDFVjWgadfATJyKJSVSEbhhj2Sx1QHDw0g+6SaA0hmmOZjLUAb4nimKS18wRk8AcmJY1ns2aLH+Ff8miWBeNiizYISaBuXEG2EQ2y6Ie+JKmKHFNY1ErMQnMVyqXy+s6Qw1+4gRkWFWpg++/6BOTqJKCYUzkcow3+IAoCHWRiCxJlIKYBMpp8lFlLmcyAQsvc9KxPhJhojU4iElU21g2qxsGdYAXcXoAMQlUQ6ZQyOTz1AHe4gSkE5PUgZgEqsGwrNF0mjrAEyRRrItEJHZGBg/PJlFLlm2nc7k8E7Bwt7CixNj1QTcJ1EpW1zP5POMQbvx8nFrRqrCilZikCqgt07ImcjnewAVXUWU5Hg5zvE7AMekKF0kXCrlCgQEJNzSRUU2LsFoHdJNwG6ehHM/lLM6ARe3IkpQIh1mtA2IS7sXJdqCJBDEJzMYZlMOpFIMTVaNIUh1n6+DqzyKeTcLNnJ4yxSJYVL6JTITDvFEZdJPwJNOy0vl8gb2VqAxtak8ky1lBTMLbnJhM5XIWYxXlI4liPBxmTySISfiEM1Cn52ApBebJ6R2jqur0kTyJBDEJv3EaSqet1A2DUYu5fN6FQpqqxlSVgAQxCT8zLWsyLDm1B6WQp9ay8hgSJWGlKzysYBgTuRwDGNc1+RhS0xTWsoJuEgGUNYx0NksdcO0POEGIhcNhAhLEJILMGcOTS2HZYYnLiNMdpCTxGBLEJPB+WOYMg3dygYBEeT9YiEn4MCyzhQLnpweQJIpRVVUVhXgE3SRwnbDM63pW103CMhhkUdRUNSzLdJCgmwRK4CSlk5e88NnPASlJkx0ki3RATAJz5sRkKp83TZOx7htO1+h0kLFwWObFkKj0YCMmERDTJ/hwirrnP7N+eV4586sgJoHycwZ8VtcznA3rQe+fxaqqxCOISaDiYek0l05Y5mkuPdE+qmpEUURRJCBR/c8KYhKB5oRlwTRzhQLLfFxIkaSIqsqSxEGsoJsEasyJyZxh6IbBHpKak0RRUxRNliWW54CYBNxGd/Jyag8JeVn9dHTaRycgeVUyiEnAC3lpGE5eOqlpcY9UOB0nT89RFJm9jyAmAY/2l9mph5fkZTk/egRBlqTY1KNHqgFiEvAD07LyhYLTYjIbO2eiIIRlOaxprMqBJ7DSFZjjneM0lxld19lPUhxNUaKq6kQjZwKAbhIIUl6GQpZlFUxTn1oly7106ZNFEBRJCiuKJIrsdwQxCWCSaVnOH7rzh2EEcCOmk4uKLCtT2xzZywFiEsB1Gk3TNJ2wNKay0/mzz+616Sx0yE46Tv2Ziw4f3sg8mwSqxpoKy8kdJk5w2rbpqeB0QlGc2rkhT61QlTgZB3STAKrwRXV6n4k++ZYv27YmTzSwp9QwDkNOIk6ttJGm2sTpfY0svQHdJADX3JlTE7bWVG5O9qBTB7W/H57Tf/rgfXzlj0x/Bb70V8LVPzi15lSQpt7aGHJ6RHHyWaLExClATAIAULz/L8AA08IKlmKSsbMAAAAASUVORK5CYII=");background-repeat:no-repeat;background-size:203px 98px}body.toc2{padding-right:0}body.toc2 #toc.toc2{position:absolute;margin-top:0 !important;width:15em;top:0;border-top-width:0 !important;border-bottom-width:0 !important;margin-left:-15.9375em;z-index:1000;padding:0 1em 1.25em 0em;overflow:auto}body.toc2 #toc.toc2 #toctitle{margin-top:0;margin-bottom:0.8rem;font-size:1.2em}body.toc2 #toc.toc2>ul{font-size:0.9em;margin-bottom:0}body.toc2 #toc.toc2 ul ul{margin-left:0;padding-left:1em}body.toc2 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:0.5em;margin-bottom:0.5em}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{padding-left:15.9375em;max-width:none}body.book #header-spring h1{max-width:1400px;margin:0 auto}body.book #header,body.book #content,body.book #footnotes,body.book #footer{max-width:1400px}body.is-position-fixed #toc.toc2{position:fixed;height:100%}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}h1{font-size:1.75em}h2{font-size:1.6em}h3,#toctitle,.sidebarblock>.content>.title{font-size:1.5em}h4{font-size:1.4em}h5{font-size:1.2em}h6{font-size:1.2em}#tocbot a.toc-link.node-name--H1{font-style:italic}#tocbot ol{margin:0;padding:0}#tocbot ol li{list-style:none;padding:0 0;margin:0;display:block}#tocbot{z-index:999}#tocbot .toc-link{position:relative;display:block;z-index:999;padding:.4rem .6rem}#tocbot a.is-active-link{padding-right:3px;background:black;color:white}}@media only screen and (min-width: 768px){#tocbot>ul.toc-list{margin-bottom:0.5em;margin-left:0.125em}#tocbot ul.sectlevel0,#tocbot a.toc-link.node-name--H1+ul{padding-left:0}#tocbot a.toc-link{height:100%}.is-collapsible{max-height:3000px;overflow:hidden}.is-collapsed{max-height:0}}@media only screen and (min-width: 768px){body.toc2 #header,body.toc2 #content,body.toc2 #footer{background-repeat:repeat-y;background-position:14em 0;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAMAAAAoyzS7AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyhpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQwIDc5LjE2MDQ1MSwgMjAxNy8wNS8wNi0wMTowODoyMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTggKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6RDE0NUNENzNGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6RDE0NUNENzRGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpEMTQ1Q0Q3MUYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpEMTQ1Q0Q3MkYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjmGxxYAAAAGUExURd3d2AAAAJlCnKAAAAAMSURBVHjaYmAACDAAAAIAAU9tWeEAAAAASUVORK5CYII=);background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6NDMyRDZERkQ1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6NDMyRDZERkU1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGQjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkRGQzUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjdyLKIAAAAPSURBVHjaYnj16RNAgAEABZgCz/xXiToAAAAASUVORK5CYII=");background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ODRBOEI2NTI1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6ODRBOEI2NTM1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGRjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkUwMDUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/Pul87iAAAAAPSURBVHjaYrj17BlAgAEABUQCpxgONc4AAAAASUVORK5CYII=")}}@media only screen and (min-width: 1280px){body.toc2{padding-right:0}body.toc2 #toc.toc2{width:25em;left:auto;margin-left:-26.9375em}body.toc2 #toc.toc2 #toctitle{font-size:1.375em}body.toc2 #toc.toc2>ul{font-size:0.95em}body.toc2 #toc.toc2 ul ul{padding-left:1.25em}body.toc2 body.toc2.toc-right{padding-left:0;padding-right:20em}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{padding-left:26.9375em;max-width:2000px}body.toc2 #header-spring h1{margin:0 auto;max-width:2000px}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:0.8125em}body.toc2 #header,body.toc2 #content,body.toc2 #footer{background-repeat:repeat-y;background-position:24em 0;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAMAAAAoyzS7AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyhpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQwIDc5LjE2MDQ1MSwgMjAxNy8wNS8wNi0wMTowODoyMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTggKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6RDE0NUNENzNGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6RDE0NUNENzRGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpEMTQ1Q0Q3MUYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpEMTQ1Q0Q3MkYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjmGxxYAAAAGUExURd3d2AAAAJlCnKAAAAAMSURBVHjaYmAACDAAAAIAAU9tWeEAAAAASUVORK5CYII=);background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6NDMyRDZERkQ1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6NDMyRDZERkU1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGQjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkRGQzUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjdyLKIAAAAPSURBVHjaYnj16RNAgAEABZgCz/xXiToAAAAASUVORK5CYII=");background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ODRBOEI2NTI1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6ODRBOEI2NTM1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGRjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkUwMDUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/Pul87iAAAAAPSURBVHjaYrj17BlAgAEABUQCpxgONc4AAAAASUVORK5CYII=")}#header{min-height:150px;padding-right:310px}#header::after{height:147px;width:305px;background-size:305px 147px}} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/favicon.ico b/spring-cloud-sleuth/3.0.0.M1/reference/html/favicon.ico new file mode 100644 index 00000000..1a4956e6 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/favicon.ico differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/features.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/features.html new file mode 100644 index 00000000..47c5599f --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/features.html @@ -0,0 +1,489 @@ + + + + + + + +Features + + + + + + + + + + +
+
+

1. Features

+
+
+

Sleuth sets up instrumentation not only to track timing, but also to catch +errors so that they can be analyzed or correlated with logs. This works the +same way regardless of if the error came from a common instrumented library, +such as RestTemplate, or your own code annotated with @NewSpan or similar.

+
+
+

Below, we’ll use the word Zipkin to describe the tracing system, and include +Zipkin screenshots. However, most services accepting Zipkin format +have similar base features. Sleuth can also be configured to send data in other +formats, something detailed later.

+
+
+

1.1. Contextualizing errors

+
+

Without distributed tracing, it can be difficult to understand the impact of a +an exception. For example, it can be hard to know if a specific request caused +the caller to fail or not.

+
+
+

Zipkin reduces time in triage by contextualizing errors and delays.

+
+
+

Requests colored red in the search screen failed:

+
+
+
+Error Traces +
+
+
+

If you then click on one of the traces, you can understand if the failure +happened before the request hit another service or not:

+
+
+
+Error Traces Info propagation +
+
+
+

For example, the above error happened in the "backend" service, and caused the +"frontend" service to fail.

+
+
+
+

1.2. Log correlation

+
+

Sleuth configures the logging context with variables including the service name +(%{spring.zipkin.service.name}) and the trace ID (%{traceId}). These help +you connect logs with distributed traces and allow you choice in what tools you +use to troubleshoot your services.

+
+
+

Once you find any log with an error, you can look for the trace ID in the +message. Paste that into Zipkin to visualize the entire trace, regardless of +how many services the first request ended up hitting.

+
+
+
+
backend.log:  2020-04-09 17:45:40.516 ERROR [backend,5e8eeec48b08e26882aba313eb08f0a4,dcc1df555b5777b3,true] 97203 --- [nio-9000-exec-1] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+frontend.log:2020-04-09 17:45:40.574 ERROR [frontend,5e8eeec48b08e26882aba313eb08f0a4,82aba313eb08f0a4,true] 97192 --- [nio-8081-exec-2] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+
+
+
+

Above, you’ll notice the trace ID is 5e8eeec48b08e26882aba313eb08f0a4, for +example. This log configuration was automatically setup by Sleuth.

+
+
+

If you use a log aggregating tool (such as Kibana, Splunk, and others), you can order the events that took place. +An example from Kibana would resemble the following image:

+
+
+
+Log correlation with Kibana +
+
+
+

If you want to use Logstash, the following listing shows the Grok pattern for Logstash:

+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+ + + + + +
+ + +If you want to use Grok together with the logs from Cloud Foundry, you have to use the following pattern: +
+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "(?m)OUT\s+%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+

1.2.1. JSON Logback with Logstash

+
+

Often, you do not want to store your logs in a text file but in a JSON file that Logstash can immediately pick. +To do so, you have to do the following (for readability, we pass the dependencies in the groupId:artifactId:version notation).

+
+
+

Dependencies Setup

+
+
+
    +
  1. +

    Ensure that Logback is on the classpath (ch.qos.logback:logback-core).

    +
    2. +
  2. +

    Add Logstash Logback encode. For example, to use version 4.6, add net.logstash.logback:logstash-logback-encoder:4.6.

    +
    3. +
+
+
+

Logback Setup

+
+
+

Consider the following example of a Logback configuration file (logback-spring.xml).

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
+    <springProperty scope="context" name="springAppName" source="spring.application.name"/>
+    <!-- Example for logging into the build folder of your project -->
+    <property name="LOG_FILE" value="${BUILD_FOLDER:-build}/${springAppName}"/>
+
+    <!-- You can override this to have a custom pattern -->
+    <property name="CONSOLE_LOG_PATTERN"
+              value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>
+
+    <!-- Appender to log to console -->
+    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
+        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
+            <!-- Minimum logging level to be presented in the console logs-->
+            <level>DEBUG</level>
+        </filter>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+
+    <!-- Appender to log to file -->
+    <appender name="flatfile" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+    <!-- Appender to log to file in a JSON format -->
+    <appender name="logstash" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}.json</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.json.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
+            <providers>
+                <timestamp>
+                    <timeZone>UTC</timeZone>
+                </timestamp>
+                <pattern>
+                    <pattern>
+                        {
+                        "timestamp": "@timestamp",
+                        "severity": "%level",
+                        "service": "${springAppName:-}",
+                        "trace": "%X{traceId:-}",
+                        "span": "%X{spanId:-}",
+                        "pid": "${PID:-}",
+                        "thread": "%thread",
+                        "class": "%logger{40}",
+                        "rest": "%message"
+                        }
+                    </pattern>
+                </pattern>
+            </providers>
+        </encoder>
+    </appender>
+    <root level="INFO">
+        <appender-ref ref="console"/>
+        <!-- uncomment this to have also JSON logs -->
+        <!--<appender-ref ref="logstash"/>-->
+        <!--<appender-ref ref="flatfile"/>-->
+    </root>
+</configuration>
+
+
+
+

That Logback configuration file:

+
+
+
    +
  • +

    Logs information from the application in a JSON format to a build/${spring.application.name}.json file.

    +
    • +
  • +

    Has commented out two additional appenders: console and standard log file.

    +
    • +
  • +

    Has the same logging pattern as the one presented in the previous section.

    +
    • +
+
+
+ + + + + +
+ + +If you use a custom logback-spring.xml, you must pass the spring.application.name in the bootstrap rather than the application property file. +Otherwise, your custom logback file does not properly read the property. +
+
+
+
+
+

1.3. Service Dependency Graph

+
+

When you consider distributed tracing tracks requests, it makes sense that +trace data can paint a picture of your architecture.

+
+
+

Zipkin includes a tool to build service dependency diagrams from traces, +including the count of calls and how many errors exist.

+
+
+

The example application will make a simple diagram like this, but your real +environment diagram may be more complex. +image::https://raw.githubusercontent.com/spring-cloud/spring-cloud-sleuth/master/docs/src/main/asciidoc/images/zipkin-depedendencies.png[Zipkin Dependencies]

+
+
+

Note: Production environments will generate a lot of data. You will likely +need to run a separate service to aggregate the dependency graph. You can learn +more here.

+
+
+
+

1.4. Request scoped properties (Baggage)

+
+

Distributed tracing works by propagating fields inside and across services that +connect the trace together: traceId and spanId notably. The context that holds +these fields can optionally push other fields that need to be consistent +regardless of many services are touched. The simple name for these extra fields +is "Baggage".

+
+
+

Sleuth allows you to define which baggage are permitted to exist in the trace +context, including what header names are used.

+
+
+

The following example shows setting baggage values:

+
+
+
+
Span initialSpan = this.tracer.nextSpan().name("span").start();
+BUSINESS_PROCESS.updateValue(initialSpan.context(), "ALM");
+COUNTRY_CODE.updateValue(initialSpan.context(), "FO");
+
+
+
+ + + + + +
+ + +There is currently no limitation of the count or size of baggage +items. Keep in mind that too many can decrease system throughput or increase +RPC latency. In extreme cases, too much baggage can crash the application, due +to exceeding transport-level message or header capacity. +
+
+
+

1.4.1. Baggage versus Tags

+
+

Like trace IDs, Baggage is attached to messages or requests, usually as +headers. Tags are key value pairs sent in a Span to Zipkin. Baggage values are +not added spans by default, which means you can’t search based on Baggage +unless you opt-in.

+
+
+

To make baggage also tags, use the property spring.sleuth.baggage.tag-fields +like so:

+
+
+
+
spring:
+  sleuth:
+    baggage:
+      remoteFields:
+        - country-code
+        - x-vcap-request-id
+      tagFields:
+        - country-code
+
+
+
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/.gitkeep b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/.gitkeep new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/.gitkeep @@ -0,0 +1 @@ + diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/kibana.png b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/kibana.png new file mode 100644 index 00000000..571e7afe Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/kibana.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-dependencies.png b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-dependencies.png new file mode 100644 index 00000000..ae09dafe Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-dependencies.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-trace-screenshot.png b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-trace-screenshot.png new file mode 100644 index 00000000..be65504c Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-trace-screenshot.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-trace.png b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-trace.png new file mode 100644 index 00000000..4ccf4547 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-trace.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-traces.png b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-traces.png new file mode 100644 index 00000000..ab7db620 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-error-traces.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-trace-screenshot.png b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-trace-screenshot.png new file mode 100644 index 00000000..4e133364 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/html/images/zipkin-trace-screenshot.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/index.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/index.html new file mode 100644 index 00000000..71ec6332 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/index.html @@ -0,0 +1,2785 @@ + + + + + + + + +Spring Cloud Sleuth + + + + + + + + + + +
+
+
+
+

3.0.0.M1

+
+
+
+
+

1. Overview

+
+
+

Spring Cloud Sleuth provides Spring Boot auto-configuration for distributed +tracing. Underneath, Spring Cloud Sleuth is a layer over a Tracer library named +Brave.

+
+
+

Sleuth configures everything you need to get started. This includes where trace +data (spans) are reported to, how many traces to keep (sampling), if remote +fields (baggage) are sent, and which libraries are traced.

+
+
+

We maintain an example app where two Spring Boot services collaborate on an +HTTP request. Sleuth configures these apps, so that timing of these requests are +recorded into Zipkin, a distributed tracing system. Tracing +UIs visualize latency, such as time in one service vs waiting for other +services.

+
+
+

Here’s an example of what it looks like:

+
+
+
+Zipkin Trace +
+
+
+

The source repository of this +example includes demonstrations of many things, including WebFlux and messaging. +Most features require only a property or dependency change to work. These +snippets showcase the value of Spring Cloud Sleuth: Through auto-configuration, +Sleuth make getting started with distributed tracing easy!

+
+
+

To keep things simple, the same example is used throughout documentation using +basic HTTP communication.

+
+
+
+
+

2. Features

+
+
+

Sleuth sets up instrumentation not only to track timing, but also to catch +errors so that they can be analyzed or correlated with logs. This works the +same way regardless of if the error came from a common instrumented library, +such as RestTemplate, or your own code annotated with @NewSpan or similar.

+
+
+

Below, we’ll use the word Zipkin to describe the tracing system, and include +Zipkin screenshots. However, most services accepting Zipkin format +have similar base features. Sleuth can also be configured to send data in other +formats, something detailed later.

+
+
+

2.1. Contextualizing errors

+
+

Without distributed tracing, it can be difficult to understand the impact of a +an exception. For example, it can be hard to know if a specific request caused +the caller to fail or not.

+
+
+

Zipkin reduces time in triage by contextualizing errors and delays.

+
+
+

Requests colored red in the search screen failed:

+
+
+
+Error Traces +
+
+
+

If you then click on one of the traces, you can understand if the failure +happened before the request hit another service or not:

+
+
+
+Error Traces Info propagation +
+
+
+

For example, the above error happened in the "backend" service, and caused the +"frontend" service to fail.

+
+
+
+

2.2. Log correlation

+
+

Sleuth configures the logging context with variables including the service name +(%{spring.zipkin.service.name}) and the trace ID (%{traceId}). These help +you connect logs with distributed traces and allow you choice in what tools you +use to troubleshoot your services.

+
+
+

Once you find any log with an error, you can look for the trace ID in the +message. Paste that into Zipkin to visualize the entire trace, regardless of +how many services the first request ended up hitting.

+
+
+
+
backend.log:  2020-04-09 17:45:40.516 ERROR [backend,5e8eeec48b08e26882aba313eb08f0a4,dcc1df555b5777b3,true] 97203 --- [nio-9000-exec-1] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+frontend.log:2020-04-09 17:45:40.574 ERROR [frontend,5e8eeec48b08e26882aba313eb08f0a4,82aba313eb08f0a4,true] 97192 --- [nio-8081-exec-2] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+
+
+
+

Above, you’ll notice the trace ID is 5e8eeec48b08e26882aba313eb08f0a4, for +example. This log configuration was automatically setup by Sleuth.

+
+
+

If you use a log aggregating tool (such as Kibana, Splunk, and others), you can order the events that took place. +An example from Kibana would resemble the following image:

+
+
+
+Log correlation with Kibana +
+
+
+

If you want to use Logstash, the following listing shows the Grok pattern for Logstash:

+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+ + + + + +
+ + +If you want to use Grok together with the logs from Cloud Foundry, you have to use the following pattern: +
+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "(?m)OUT\s+%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+

2.2.1. JSON Logback with Logstash

+
+

Often, you do not want to store your logs in a text file but in a JSON file that Logstash can immediately pick. +To do so, you have to do the following (for readability, we pass the dependencies in the groupId:artifactId:version notation).

+
+
+

Dependencies Setup

+
+
+
    +
  1. +

    Ensure that Logback is on the classpath (ch.qos.logback:logback-core).

    +
    2. +
  2. +

    Add Logstash Logback encode. For example, to use version 4.6, add net.logstash.logback:logstash-logback-encoder:4.6.

    +
    3. +
+
+
+

Logback Setup

+
+
+

Consider the following example of a Logback configuration file (logback-spring.xml).

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
+    <springProperty scope="context" name="springAppName" source="spring.application.name"/>
+    <!-- Example for logging into the build folder of your project -->
+    <property name="LOG_FILE" value="${BUILD_FOLDER:-build}/${springAppName}"/>
+
+    <!-- You can override this to have a custom pattern -->
+    <property name="CONSOLE_LOG_PATTERN"
+              value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>
+
+    <!-- Appender to log to console -->
+    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
+        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
+            <!-- Minimum logging level to be presented in the console logs-->
+            <level>DEBUG</level>
+        </filter>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+
+    <!-- Appender to log to file -->
+    <appender name="flatfile" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+    <!-- Appender to log to file in a JSON format -->
+    <appender name="logstash" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}.json</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.json.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
+            <providers>
+                <timestamp>
+                    <timeZone>UTC</timeZone>
+                </timestamp>
+                <pattern>
+                    <pattern>
+                        {
+                        "timestamp": "@timestamp",
+                        "severity": "%level",
+                        "service": "${springAppName:-}",
+                        "trace": "%X{traceId:-}",
+                        "span": "%X{spanId:-}",
+                        "pid": "${PID:-}",
+                        "thread": "%thread",
+                        "class": "%logger{40}",
+                        "rest": "%message"
+                        }
+                    </pattern>
+                </pattern>
+            </providers>
+        </encoder>
+    </appender>
+    <root level="INFO">
+        <appender-ref ref="console"/>
+        <!-- uncomment this to have also JSON logs -->
+        <!--<appender-ref ref="logstash"/>-->
+        <!--<appender-ref ref="flatfile"/>-->
+    </root>
+</configuration>
+
+
+
+

That Logback configuration file:

+
+
+
    +
  • +

    Logs information from the application in a JSON format to a build/${spring.application.name}.json file.

    +
    • +
  • +

    Has commented out two additional appenders: console and standard log file.

    +
    • +
  • +

    Has the same logging pattern as the one presented in the previous section.

    +
    • +
+
+
+ + + + + +
+ + +If you use a custom logback-spring.xml, you must pass the spring.application.name in the bootstrap rather than the application property file. +Otherwise, your custom logback file does not properly read the property. +
+
+
+
+
+

2.3. Service Dependency Graph

+
+

When you consider distributed tracing tracks requests, it makes sense that +trace data can paint a picture of your architecture.

+
+
+

Zipkin includes a tool to build service dependency diagrams from traces, +including the count of calls and how many errors exist.

+
+
+

The example application will make a simple diagram like this, but your real +environment diagram may be more complex. +image::https://raw.githubusercontent.com/spring-cloud/spring-cloud-sleuth/master/docs/src/main/asciidoc/images/zipkin-depedendencies.png[Zipkin Dependencies]

+
+
+

Note: Production environments will generate a lot of data. You will likely +need to run a separate service to aggregate the dependency graph. You can learn +more here.

+
+
+
+

2.4. Request scoped properties (Baggage)

+
+

Distributed tracing works by propagating fields inside and across services that +connect the trace together: traceId and spanId notably. The context that holds +these fields can optionally push other fields that need to be consistent +regardless of many services are touched. The simple name for these extra fields +is "Baggage".

+
+
+

Sleuth allows you to define which baggage are permitted to exist in the trace +context, including what header names are used.

+
+
+

The following example shows setting baggage values:

+
+
+
+
Span initialSpan = this.tracer.nextSpan().name("span").start();
+BUSINESS_PROCESS.updateValue(initialSpan.context(), "ALM");
+COUNTRY_CODE.updateValue(initialSpan.context(), "FO");
+
+
+
+ + + + + +
+ + +There is currently no limitation of the count or size of baggage +items. Keep in mind that too many can decrease system throughput or increase +RPC latency. In extreme cases, too much baggage can crash the application, due +to exceeding transport-level message or header capacity. +
+
+
+

2.4.1. Baggage versus Tags

+
+

Like trace IDs, Baggage is attached to messages or requests, usually as +headers. Tags are key value pairs sent in a Span to Zipkin. Baggage values are +not added spans by default, which means you can’t search based on Baggage +unless you opt-in.

+
+
+

To make baggage also tags, use the property spring.sleuth.baggage.tag-fields +like so:

+
+
+
+
spring:
+  sleuth:
+    baggage:
+      remoteFields:
+        - country-code
+        - x-vcap-request-id
+      tagFields:
+        - country-code
+
+
+
+
+
+
+
+

3. Adding Sleuth to your Project

+
+
+

This section addresses how to add Sleuth to your project with either Maven or Gradle.

+
+
+ + + + + +
+ + +To ensure that your application name is properly displayed in Zipkin, set the spring.application.name property in bootstrap.yml. +
+
+
+

3.1. Sleuth with Zipkin via HTTP

+
+

If you want both Sleuth and Zipkin, add the spring-cloud-starter-zipkin dependency.

+
+
+

The following example shows how to do so for Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+

The following example shows how to do so for Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+
+

3.2. Sleuth with Zipkin over RabbitMQ or Kafka

+
+

If you want to use RabbitMQ or Kafka instead of HTTP, add the spring-rabbit or spring-kafka dependency. +The default destination name is zipkin.

+
+
+

If using Kafka, you must set the property spring.zipkin.sender.type property accordingly:

+
+
+
+
spring.zipkin.sender.type: kafka
+
+
+
+ + + + + +
+ + +spring-cloud-sleuth-stream is deprecated and incompatible with these destinations. +
+
+
+

If you want Sleuth over RabbitMQ, add the spring-cloud-starter-zipkin and spring-rabbit +dependencies.

+
+
+

The following example shows how to do so for Gradle:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+<dependency> (3)
+    <groupId>org.springframework.amqp</groupId>
+    <artifactId>spring-rabbit</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies {
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin" (2)
+    compile "org.springframework.amqp:spring-rabbit" (3)
+}
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
+

3.3. Overriding the auto-configuration of Zipkin

+
+

Spring Cloud Sleuth supports sending traces to multiple tracing systems as of version 2.1.0. +In order to get this to work, every tracing system needs to have a Reporter<Span> and Sender. +If you want to override the provided beans you need to give them a specific name. +To do this you can use respectively ZipkinAutoConfiguration.REPORTER_BEAN_NAME and ZipkinAutoConfiguration.SENDER_BEAN_NAME.

+
+
+
+
@Configuration
+protected static class MyConfig {
+
+    @Bean(ZipkinAutoConfiguration.REPORTER_BEAN_NAME)
+    Reporter<zipkin2.Span> myReporter() {
+        return AsyncReporter.create(mySender());
+    }
+
+    @Bean(ZipkinAutoConfiguration.SENDER_BEAN_NAME)
+    MySender mySender() {
+        return new MySender();
+    }
+
+    static class MySender extends Sender {
+
+        private boolean spanSent = false;
+
+        boolean isSpanSent() {
+            return this.spanSent;
+        }
+
+        @Override
+        public Encoding encoding() {
+            return Encoding.JSON;
+        }
+
+        @Override
+        public int messageMaxBytes() {
+            return Integer.MAX_VALUE;
+        }
+
+        @Override
+        public int messageSizeInBytes(List<byte[]> encodedSpans) {
+            return encoding().listSizeInBytes(encodedSpans);
+        }
+
+        @Override
+        public Call<Void> sendSpans(List<byte[]> encodedSpans) {
+            this.spanSent = true;
+            return Call.create(null);
+        }
+
+    }
+
+}
+
+
+
+
+

3.4. Only Sleuth (log correlation)

+
+

If you want to use only Spring Cloud Sleuth without the Zipkin integration, add the spring-cloud-starter-sleuth module to your project.

+
+
+

The following example shows how to add Sleuth with Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-sleuth</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+

The following example shows how to add Sleuth with Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+
+
+
+

4. How Sleuth works

+
+
+

Spring Cloud Sleuth is a layer over Brave.

+
+
+

Brave is a distributed tracing instrumentation library. Brave typically +intercepts production requests to gather timing data, correlate and propagate +trace contexts.

+
+
+

Trace data, also called spans, are typically reported to Zipkin. +Zipkin is an Open Source tracing system, which includes a UI and various +collectors, such as HTTP and messaging.

+
+
+

Many Open Source and commercial products accept Zipkin format. +Some options are documented here, +but many are not. If you cannot use Zipkin and your product isn’t listed, clarify +with your support representative and have them update that page. In many cases, +products already support Zipkin format, they just don’t document it.

+
+
+

Traces connect from service to service using header propagation. The default +format is B3. Similar to data +formats, you can configure alternate header formats also, provided trace and +span IDs are compatible with B3. Most notably, this means the trace ID and span +IDs are lower-case hex, not UUIDs. Besides trace identifiers, other properties +(Baggage) can also be passed along with the request. Remote Baggage must be +predefined, but is flexible otherwise.

+
+
+

Sleuth configures everything you need to get started with tracing. Sleuth +configures where trace data (spans) are reported to, how many traces to keep +(sampling), if remote fields (baggage) are sent, and which libraries are traced. +Sleuth also adds annotation based tracing features and some instrumentation not +available otherwise, such as Reactor. If cannot find the configuration you are +looking for in the documentation, ask Gitter +before assuming something cannot be done.

+
+
+

4.1. Brave Basics

+
+

Most instrumentation work is done for you by default. Sleuth provides beans to +allow you to change what’s traced, and it even provides annotations to avoid +using tracing libraries! All of this is explained later in this document.

+
+
+

That said, you might want to know more about how things work underneath. Here +are some pointers.

+
+
+

Here are the most core types you might use: +* SpanCustomizer - to change the span currently in progress +* Tracer - to get a start new spans ad-hoc

+
+
+

Here are the most relevant links from the OpenZipkin Brave project: +* [Brave’s core library](github.com/openzipkin/brave/tree/master/brave) +* [Baggage (propagated fields)](github.com/openzipkin/brave/tree/master/brave#baggage) +* [HTTP tracing](github.com/openzipkin/brave/tree/master/instrumentation/http)

+
+
+
+
+
+

5. Sampling

+
+
+

By default Spring Cloud Sleuth doesn’t sample spans. +That means that traces appear in logs but not in any remote store. +For testing the default is often enough, and it probably is all you need if you use only the logs (for example, with an ELK aggregator). +If you export span data to Zipkin, there is also an Sampler.ALWAYS_SAMPLE setting that exports everything, RateLimitingSampler setting that samples X transactions per second (defaults to 1000) or ProbabilityBasedSampler setting that samples a fixed fraction of spans.

+
+
+ + + + + +
+ + +The RateLimitingSampler is the default if you use spring-cloud-sleuth-zipkin. +You can configure the rate limit by setting spring.sleuth.sampler.rate. +
+
+
+

A sampler can be installed by creating a bean definition, as shown in the following example:

+
+
+
+
@Bean
+public Sampler defaultSampler() {
+    return Sampler.ALWAYS_SAMPLE;
+}
+
+
+
+ + + + + +
+ + +You can set the HTTP header b3 to 1, or, when doing messaging, you can set the spanFlags header to 1. +Doing so forces the current request to be sampled regardless of configuration. +
+
+
+

In order to use the rate-limited sampler set the spring.sleuth.sampler.rate property to choose an amount of traces to accept on a per-second interval. The minimum number is 0 and the max is 2,147,483,647 (max int).

+
+
+
+
+

6. Baggage

+
+
+

Baggage are fields that are propagated with the trace, optionally out of process. You can use +properties to define fields that have no special configuration such as name mapping:

+
+
+
    +
  • +

    spring.sleuth.remote-fields is a list of header names to accept and propagate to remote services.

    +
    • +
  • +

    spring.sleuth.local-fields is a list of names to propagate locally

    +
    • +
+
+
+

No prefixing applies with these keys. What you set is literally what is used.

+
+
+

A name set in either of these properties will result in a BaggageField of the same name.

+
+
+

In order to automatically set the baggage values to Slf4j’s MDC, you have to set +the spring.sleuth.baggage.correlation-fields property with a list of whitelisted +local or remote keys. E.g. spring.sleuth.baggage.correlation-fields=country-code will set the +value of the country-code baggage into MDC.

+
+
+ + + + + +
+ + +Remember that adding entries to MDC can drastically decrease the performance of your application! +
+
+
+

If you want to add the baggage entries as tags, to make it possible to search for spans via the baggage entries, you can set the value of +spring.sleuth.baggage.tag-fields with a list of whitelisted baggage keys. To disable the feature you have to pass the spring.sleuth.propagation.tag.enabled=false property.

+
+
+

6.1. Java configuration

+
+

If you need to do anything more advanced than above, do not define properties and instead use a +@Bean config for the baggage fields you use. + * BaggagePropagationCustomizer sets up baggage fields + * Add a SingleBaggageField to control header names for a BaggageField. + * CorrelationScopeCustomizer sets up MDC fields + * Add a SingleCorrelationField to change the MDC name of a BaggageField or if updates flush.

+
+
+
+
+
+

7. Instrumentation

+
+
+

Spring Cloud Sleuth automatically instruments all your Spring applications, so you should not have to do anything to activate it. +The instrumentation is added by using a variety of technologies according to the stack that is available. For example, for a servlet web application, we use a Filter, and, for Spring Integration, we use ChannelInterceptors.

+
+
+

You can customize the keys used in span tags. +To limit the volume of span data, an HTTP request is, by default, tagged only with a handful of metadata, such as the status code, the host, and the URL. +You can add request headers by configuring spring.sleuth.keys.http.headers (a list of header names).

+
+
+ + + + + +
+ + +Tags are collected and exported only if there is a Sampler that allows it. By default, there is no such Sampler, to ensure that there is no danger of accidentally collecting too much data without configuring something). +
+
+
+
+
+

8. Span lifecycle

+
+
+

You can do the following operations on the Span by means of brave.Tracer:

+
+
+
    +
  • +

    start: When you start a span, its name is assigned and the start timestamp is recorded.

    +
    • +
  • +

    close: The span gets finished (the end time of the span is recorded) and, if the span is sampled, it is eligible for collection (for example, to Zipkin).

    +
    • +
  • +

    continue: A new instance of span is created. +It is a copy of the one that it continues.

    +
    • +
  • +

    detach: The span does not get stopped or closed. +It only gets removed from the current thread.

    +
    • +
  • +

    create with explicit parent: You can create a new span and set an explicit parent for it.

    +
    • +
+
+
+ + + + + +
+ + +Spring Cloud Sleuth creates an instance of Tracer for you. In order to use it, you can autowire it. +
+
+
+

8.1. Creating and finishing spans

+
+

You can manually create spans by using the Tracer, as shown in the following example:

+
+
+
+
// Start a span. If there was a span present in this thread it will become
+// the `newSpan`'s parent.
+Span newSpan = this.tracer.nextSpan().name("calculateTax");
+try (Tracer.SpanInScope ws = this.tracer.withSpanInScope(newSpan.start())) {
+    // ...
+    // You can tag a span
+    newSpan.tag("taxValue", taxValue);
+    // ...
+    // You can log an event on a span
+    newSpan.annotate("taxCalculated");
+}
+finally {
+    // Once done remember to finish the span. This will allow collecting
+    // the span to send it to Zipkin
+    newSpan.finish();
+}
+
+
+
+

In the preceding example, we could see how to create a new instance of the span. +If there is already a span in this thread, it becomes the parent of the new span.

+
+
+ + + + + +
+ + +Always clean after you create a span. Also, always finish any span that you want to send to Zipkin. +
+
+
+ + + + + +
+ + +If your span contains a name greater than 50 chars, that name is truncated to 50 chars. +Your names have to be explicit and concrete. Big names lead to latency issues and sometimes even exceptions. +
+
+
+
+

8.2. Continuing Spans

+
+

Sometimes, you do not want to create a new span but you want to continue one. An example of such a +situation might be as follows:

+
+
+
    +
  • +

    AOP: If there was already a span created before an aspect was reached, you might not want to create a new span.

    +
    • +
+
+
+

To continue a span, you can use brave.Tracer, as shown in the following example:

+
+
+
+
// let's assume that we're in a thread Y and we've received
+// the `initialSpan` from thread X
+Span continuedSpan = this.tracer.toSpan(newSpan.context());
+try {
+    // ...
+    // You can tag a span
+    continuedSpan.tag("taxValue", taxValue);
+    // ...
+    // You can log an event on a span
+    continuedSpan.annotate("taxCalculated");
+}
+finally {
+    // Once done remember to flush the span. That means that
+    // it will get reported but the span itself is not yet finished
+    continuedSpan.flush();
+}
+
+
+
+
+

8.3. Creating a Span with an explicit Parent

+
+

You might want to start a new span and provide an explicit parent of that span. +Assume that the parent of a span is in one thread and you want to start a new span in another thread. +In Brave, whenever you call nextSpan(), it creates a span in reference to the span that is currently in scope. +You can put the span in scope and then call nextSpan(), as shown in the following example:

+
+
+
+
// let's assume that we're in a thread Y and we've received
+// the `initialSpan` from thread X. `initialSpan` will be the parent
+// of the `newSpan`
+Span newSpan = null;
+try (Tracer.SpanInScope ws = this.tracer.withSpanInScope(initialSpan)) {
+    newSpan = this.tracer.nextSpan().name("calculateCommission");
+    // ...
+    // You can tag a span
+    newSpan.tag("commissionValue", commissionValue);
+    // ...
+    // You can log an event on a span
+    newSpan.annotate("commissionCalculated");
+}
+finally {
+    // Once done remember to finish the span. This will allow collecting
+    // the span to send it to Zipkin. The tags and events set on the
+    // newSpan will not be present on the parent
+    if (newSpan != null) {
+        newSpan.finish();
+    }
+}
+
+
+
+ + + + + +
+ + +After creating such a span, you must finish it. Otherwise it is not reported (for example, to Zipkin). +
+
+
+
+
+
+

9. Naming spans

+
+
+

Picking a span name is not a trivial task. A span name should depict an operation name. +The name should be low cardinality, so it should not include identifiers.

+
+
+

Since there is a lot of instrumentation going on, some span names are artificial:

+
+
+
    +
  • +

    controller-method-name when received by a Controller with a method name of controllerMethodName

    +
    • +
  • +

    async for asynchronous operations done with wrapped Callable and Runnable interfaces.

    +
    • +
  • +

    Methods annotated with @Scheduled return the simple name of the class.

    +
    • +
+
+
+

Fortunately, for asynchronous processing, you can provide explicit naming.

+
+
+

9.1. @SpanName Annotation

+
+

You can name the span explicitly by using the @SpanName annotation, as shown in the following example:

+
+
+
+
@SpanName("calculateTax")
+class TaxCountingRunnable implements Runnable {
+
+    @Override
+    public void run() {
+        // perform logic
+    }
+
+}
+
+
+
+

In this case, when processed in the following manner, the span is named calculateTax:

+
+
+
+
Runnable runnable = new TraceRunnable(this.tracing, spanNamer,
+        new TaxCountingRunnable());
+Future<?> future = executorService.submit(runnable);
+// ... some additional logic ...
+future.get();
+
+
+
+
+

9.2. toString() method

+
+

It is pretty rare to create separate classes for Runnable or Callable. +Typically, one creates an anonymous instance of those classes. +You cannot annotate such classes. +To overcome that limitation, if there is no @SpanName annotation present, we check whether the class has a custom implementation of the toString() method.

+
+
+

Running such code leads to creating a span named calculateTax, as shown in the following example:

+
+
+
+
Runnable runnable = new TraceRunnable(this.tracing, spanNamer, new Runnable() {
+    @Override
+    public void run() {
+        // perform logic
+    }
+
+    @Override
+    public String toString() {
+        return "calculateTax";
+    }
+});
+Future<?> future = executorService.submit(runnable);
+// ... some additional logic ...
+future.get();
+
+
+
+
+
+
+

10. Managing Spans with Annotations

+
+
+

You can manage spans with a variety of annotations.

+
+
+

10.1. Rationale

+
+

There are a number of good reasons to manage spans with annotations, including:

+
+
+
    +
  • +

    API-agnostic means to collaborate with a span. Use of annotations lets users add to a span with no library dependency on a span api. +Doing so lets Sleuth change its core API to create less impact to user code.

    +
    • +
  • +

    Reduced surface area for basic span operations. Without this feature, you must use the span api, which has lifecycle commands that could be used incorrectly. +By only exposing scope, tag, and log functionality, you can collaborate without accidentally breaking span lifecycle.

    +
    • +
  • +

    Collaboration with runtime generated code. With libraries such as Spring Data and Feign, the implementations of interfaces are generated at runtime. +Consequently, span wrapping of objects was tedious. +Now you can provide annotations over interfaces and the arguments of those interfaces.

    +
    • +
+
+
+
+

10.2. Creating New Spans

+
+

If you do not want to create local spans manually, you can use the @NewSpan annotation. +Also, we provide the @SpanTag annotation to add tags in an automated fashion.

+
+
+

Now we can consider some examples of usage.

+
+
+
+
@NewSpan
+void testMethod();
+
+
+
+

Annotating the method without any parameter leads to creating a new span whose name equals the annotated method name.

+
+
+
+
@NewSpan("customNameOnTestMethod4")
+void testMethod4();
+
+
+
+

If you provide the value in the annotation (either directly or by setting the name parameter), the created span has the provided value as the name.

+
+
+
+
// method declaration
+@NewSpan(name = "customNameOnTestMethod5")
+void testMethod5(@SpanTag("testTag") String param);
+
+// and method execution
+this.testBean.testMethod5("test");
+
+
+
+

You can combine both the name and a tag. Let’s focus on the latter. +In this case, the value of the annotated method’s parameter runtime value becomes the value of the tag. +In our sample, the tag key is testTag, and the tag value is test.

+
+
+
+
@NewSpan(name = "customNameOnTestMethod3")
+@Override
+public void testMethod3() {
+}
+
+
+
+

You can place the @NewSpan annotation on both the class and an interface. +If you override the interface’s method and provide a different value for the @NewSpan annotation, the most +concrete one wins (in this case customNameOnTestMethod3 is set).

+
+
+
+

10.3. Continuing Spans

+
+

If you want to add tags and annotations to an existing span, you can use the @ContinueSpan annotation, as shown in the following example:

+
+
+
+
// method declaration
+@ContinueSpan(log = "testMethod11")
+void testMethod11(@SpanTag("testTag11") String param);
+
+// method execution
+this.testBean.testMethod11("test");
+this.testBean.testMethod13();
+
+
+
+

(Note that, in contrast with the @NewSpan annotation ,you can also add logs with the log parameter.)

+
+
+

That way, the span gets continued and:

+
+
+
    +
  • +

    Log entries named testMethod11.before and testMethod11.after are created.

    +
    • +
  • +

    If an exception is thrown, a log entry named testMethod11.afterFailure is also created.

    +
    • +
  • +

    A tag with a key of testTag11 and a value of test is created.

    +
    • +
+
+
+
+

10.4. Advanced Tag Setting

+
+

There are 3 different ways to add tags to a span. All of them are controlled by the SpanTag annotation. +The precedence is as follows:

+
+
+
    +
  1. +

    Try with a bean of TagValueResolver type and a provided name.

    +
    2. +
  2. +

    If the bean name has not been provided, try to evaluate an expression. +We search for a TagValueExpressionResolver bean. +The default implementation uses SPEL expression resolution. +IMPORTANT You can only reference properties from the SPEL expression. Method execution is not allowed due to security constraints.

    +
    3. +
  3. +

    If we do not find any expression to evaluate, return the toString() value of the parameter.

    +
    4. +
+
+
+

10.4.1. Custom extractor

+
+

The value of the tag for the following method is computed by an implementation of TagValueResolver interface. +Its class name has to be passed as the value of the resolver attribute.

+
+
+

Consider the following annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForTagValueResolver(
+        @SpanTag(key = "test", resolver = TagValueResolver.class) String test) {
+}
+
+
+
+

Now further consider the following TagValueResolver bean implementation:

+
+
+
+
@Bean(name = "myCustomTagValueResolver")
+public TagValueResolver tagValueResolver() {
+    return parameter -> "Value from myCustomTagValueResolver";
+}
+
+
+
+

The two preceding examples lead to setting a tag value equal to Value from myCustomTagValueResolver.

+
+
+
+

10.4.2. Resolving Expressions for a Value

+
+

Consider the following annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForTagValueExpression(@SpanTag(key = "test",
+        expression = "'hello' + ' characters'") String test) {
+}
+
+
+
+

No custom implementation of a TagValueExpressionResolver leads to evaluation of the SPEL expression, and a tag with a value of 4 characters is set on the span. +If you want to use some other expression resolution mechanism, you can create your own implementation of the bean.

+
+
+
+

10.4.3. Using the toString() method

+
+

Consider the following annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForArgumentToString(@SpanTag("test") Long param) {
+}
+
+
+
+

Running the preceding method with a value of 15 leads to setting a tag with a String value of "15".

+
+
+
+
+
+
+

11. Customizations

+
+
+

The Tracer object is fully managed by sleuth, so you rarely need to affect it. That said, +Sleuth supports a number of Customizer types, that allow you to configure +anything not already done by Sleuth with auto-configuration or properties.

+
+
+

If you define one of the following as a Bean, Sleuth will invoke it to +customize behaviour:

+
+
+
    +
  • +

    RpcTracingCustomizer - for RPC tagging and sampling policy

    +
    • +
  • +

    HttpTracingCustomizer - for HTTP tagging and sampling policy

    +
    • +
  • +

    MessagingTracingCustomizer - for messaging tagging and sampling policy

    +
    • +
  • +

    CurrentTraceContextCustomizer - to integrate decorators such as correlation.

    +
    • +
  • +

    BaggagePropagationCustomizer - for propagating baggage fields in process and over headers

    +
    • +
  • +

    CorrelationScopeDecoratorCustomizer - for scope decorations such as MDC (logging) field correlation

    +
    • +
+
+
+

11.1. HTTP

+
+

11.1.1. Data Policy

+
+

The default span data policy for HTTP requests is described in Brave: +github.com/openzipkin/brave/tree/master/instrumentation/http#span-data-policy

+
+
+

To add different data to the span, you need to register a bean of type +brave.http.HttpRequestParser or brave.http.HttpResponseParser based on when +the data is collected.

+
+
+

The bean names correspond to the request or response side, and whether it is +a client or server. For example, sleuthHttpClientRequestParser changes what +is collected before a client request is sent to the server.

+
+
+

For your convenience @HttpClientRequestParser, @HttpClientResponseParser +and corresponding server annotations can be used to inject the proper beans +or to reference the bean names via their static String NAME fields.

+
+
+

Here’s an example adding the HTTP url in addition to defaults:

+
+
+
+
@Configuration
+class Config {
+  @Bean(name = { HttpClientRequestParser.NAME, HttpServerRequestParser.NAME })
+  HttpRequestParser sleuthHttpServerRequestParser() {
+      return (req, context, span) -> {
+          HttpRequestParser.DEFAULT.parse(req, context, span);
+          String url = req.url();
+          if (url != null) {
+              span.tag("http.url", url);
+          }
+      };
+  }
+}
+
+
+
+
+

11.1.2. Sampling

+
+

If client /server sampling is required, just register a bean of type +brave.sampler.SamplerFunction<HttpRequest> and name the bean +sleuthHttpClientSampler for client sampler and sleuthHttpServerSampler +for server sampler.

+
+
+

For your convenience the @HttpClientSampler and @HttpServerSampler +annotations can be used to inject the proper beans or to reference the bean +names via their static String NAME fields.

+
+
+

Check out Brave’s code to see an example of how to make a path-based sampler +github.com/openzipkin/brave/tree/master/instrumentation/http#sampling-policy

+
+
+

If you want to completely rewrite the HttpTracing bean you can use the SkipPatternProvider +interface to retrieve the URL Pattern for spans that should be not sampled. Below you can see +an example of usage of SkipPatternProvider inside a server side, Sampler<HttpRequest>.

+
+
+
+
@Configuration
+class Config {
+  @Bean(name = HttpServerSampler.NAME)
+  SamplerFunction<HttpRequest> myHttpSampler(SkipPatternProvider provider) {
+      Pattern pattern = provider.skipPattern();
+      return request -> {
+          String url = request.path();
+          boolean shouldSkip = pattern.matcher(url).matches();
+          if (shouldSkip) {
+              return false;
+          }
+          return null;
+      };
+  }
+}
+
+
+
+
+
+

11.2. TracingFilter

+
+

You can also modify the behavior of the TracingFilter, which is the component that is responsible for processing the input HTTP request and adding tags basing on the HTTP response. +You can customize the tags or modify the response headers by registering your own instance of the TracingFilter bean.

+
+
+

In the following example, we register the TracingFilter bean, add the ZIPKIN-TRACE-ID response header containing the current Span’s trace id, and add a tag with key custom and a value tag to the span.

+
+
+
+
@Component
+@Order(TraceWebServletAutoConfiguration.TRACING_FILTER_ORDER + 1)
+class MyFilter extends GenericFilterBean {
+
+    private final Tracer tracer;
+
+    MyFilter(Tracer tracer) {
+        this.tracer = tracer;
+    }
+
+    @Override
+    public void doFilter(ServletRequest request, ServletResponse response,
+            FilterChain chain) throws IOException, ServletException {
+        Span currentSpan = this.tracer.currentSpan();
+        if (currentSpan == null) {
+            chain.doFilter(request, response);
+            return;
+        }
+        // for readability we're returning trace id in a hex form
+        ((HttpServletResponse) response).addHeader("ZIPKIN-TRACE-ID",
+                currentSpan.context().traceIdString());
+        // we can also add some custom tags
+        currentSpan.tag("custom", "tag");
+        chain.doFilter(request, response);
+    }
+
+}
+
+
+
+
+

11.3. Messaging

+
+

Sleuth automatically configures the MessagingTracing bean which serves as a +foundation for Messaging instrumentation such as Kafka or JMS.

+
+
+

If a customization of producer / consumer sampling of messaging traces is required, +just register a bean of type brave.sampler.SamplerFunction<MessagingRequest> and +name the bean sleuthProducerSampler for producer sampler and sleuthConsumerSampler +for consumer sampler.

+
+
+

For your convenience the @ProducerSampler and @ConsumerSampler +annotations can be used to inject the proper beans or to reference the bean +names via their static String NAME fields.

+
+
+

Ex. Here’s a sampler that traces 100 consumer requests per second, except for +the "alerts" channel. Other requests will use a global rate provided by the +Tracing component.

+
+
+
+
@Configuration
+class Config {
+}
+
+
+
+

For more, see github.com/openzipkin/brave/tree/master/instrumentation/messaging#sampling-policy

+
+
+
+

11.4. RPC

+
+

Sleuth automatically configures the RpcTracing bean which serves as a +foundation for RPC instrumentation such as gRPC or Dubbo.

+
+
+

If a customization of client / server sampling of the RPC traces is required, +just register a bean of type brave.sampler.SamplerFunction<RpcRequest> and +name the bean sleuthRpcClientSampler for client sampler and +sleuthRpcServerSampler for server sampler.

+
+
+

For your convenience the @RpcClientSampler and @RpcServerSampler +annotations can be used to inject the proper beans or to reference the bean +names via their static String NAME fields.

+
+
+

Ex. Here’s a sampler that traces 100 "GetUserToken" server requests per second. +This doesn’t start new traces for requests to the health check service. Other +requests will use the global sampling configuration.

+
+
+
+
@Configuration
+class Config {
+  @Bean(name = RpcServerSampler.NAME)
+  SamplerFunction<RpcRequest> myRpcSampler() {
+      Matcher<RpcRequest> userAuth = and(serviceEquals("users.UserService"),
+              methodEquals("GetUserToken"));
+      return RpcRuleSampler.newBuilder()
+              .putRule(serviceEquals("grpc.health.v1.Health"), Sampler.NEVER_SAMPLE)
+              .putRule(userAuth, RateLimitingSampler.create(100)).build();
+  }
+}
+
+
+
+

For more, see github.com/openzipkin/brave/tree/master/instrumentation/rpc#sampling-policy

+
+
+
+

11.5. Custom service name

+
+

By default, Sleuth assumes that, when you send a span to Zipkin, you want the span’s service name to be equal to the value of the spring.application.name property. +That is not always the case, though. +There are situations in which you want to explicitly provide a different service name for all spans coming from your application. +To achieve that, you can pass the following property to your application to override that value (the example is for a service named myService):

+
+
+
+
spring.zipkin.service.name: myService
+
+
+
+
+

11.6. Customization of Reported Spans

+
+

Before reporting spans (for example, to Zipkin) you may want to modify that span in some way. +You can do so by using the FinishedSpanHandler interface.

+
+
+

In Sleuth, we generate spans with a fixed name. +Some users want to modify the name depending on values of tags. +You can implement the FinishedSpanHandler interface to alter that name.

+
+
+

The following example shows how to register two beans that implement FinishedSpanHandler:

+
+
+
+
@Bean
+FinishedSpanHandler handlerOne() {
+    return new FinishedSpanHandler() {
+        @Override
+        public boolean handle(TraceContext traceContext, MutableSpan span) {
+            span.name("foo");
+            return true; // keep this span
+        }
+    };
+}
+
+@Bean
+FinishedSpanHandler handlerTwo() {
+    return new FinishedSpanHandler() {
+        @Override
+        public boolean handle(TraceContext traceContext, MutableSpan span) {
+            span.name(span.name() + " bar");
+            return true; // keep this span
+        }
+    };
+}
+
+
+
+

The preceding example results in changing the name of the reported span to foo bar, just before it gets reported (for example, to Zipkin).

+
+
+
+

11.7. Host Locator

+
+ + + + + +
+ + +This section is about defining host from service discovery. +It is NOT about finding Zipkin through service discovery. +
+
+
+

To define the host that corresponds to a particular span, we need to resolve the host name and port. +The default approach is to take these values from server properties. +If those are not set, we try to retrieve the host name from the network interfaces.

+
+
+

If you have the discovery client enabled and prefer to retrieve the host address from the registered instance in a service registry, you have to set the spring.zipkin.locator.discovery.enabled property (it is applicable for both HTTP-based and Stream-based span reporting), as follows:

+
+
+
+
spring.zipkin.locator.discovery.enabled: true
+
+
+
+
+
+
+

12. Sending Spans to Zipkin

+
+
+

By default, if you add spring-cloud-starter-zipkin as a dependency to your project, when the span is closed, it is sent to Zipkin over HTTP. +The communication is asynchronous. +You can configure the URL by setting the spring.zipkin.baseUrl property, as follows:

+
+
+
+
spring.zipkin.baseUrl: https://192.168.99.100:9411/
+
+
+
+

If you want to find Zipkin through service discovery, you can pass the Zipkin’s service ID inside the URL, as shown in the following example for zipkinserver service ID:

+
+
+
+
spring.zipkin.baseUrl: https://zipkinserver/
+
+
+
+

To disable this feature just set spring.zipkin.discoveryClientEnabled to `false.

+
+
+

When the Discovery Client feature is enabled, Sleuth uses +LoadBalancerClient to find the URL of the Zipkin Server. It means +that you can set up the load balancing configuration e.g. via Ribbon.

+
+
+
+
zipkinserver:
+  ribbon:
+    ListOfServers: host1,host2
+
+
+
+

If you have web, rabbit, activemq or kafka together on the classpath, you might need to pick the means by which you would like to send spans to zipkin. +To do so, set web, rabbit, activemq or kafka to the spring.zipkin.sender.type property. +The following example shows setting the sender type for web:

+
+
+
+
spring.zipkin.sender.type: web
+
+
+
+

To customize the RestTemplate that sends spans to Zipkin via HTTP, you can register +the ZipkinRestTemplateCustomizer bean.

+
+
+
+
@Configuration
+class MyConfig {
+    @Bean ZipkinRestTemplateCustomizer myCustomizer() {
+        return new ZipkinRestTemplateCustomizer() {
+            @Override
+            void customize(RestTemplate restTemplate) {
+                // customize the RestTemplate
+            }
+        };
+    }
+}
+
+
+
+

If, however, you would like to control the full process of creating the RestTemplate +object, you will have to create a bean of zipkin2.reporter.Sender type.

+
+
+
+
    @Bean Sender myRestTemplateSender(ZipkinProperties zipkin,
+            ZipkinRestTemplateCustomizer zipkinRestTemplateCustomizer) {
+        RestTemplate restTemplate = mySuperCustomRestTemplate();
+        zipkinRestTemplateCustomizer.customize(restTemplate);
+        return myCustomSender(zipkin, restTemplate);
+    }
+
+
+
+
+
+

13. Zipkin Stream Span Consumer

+
+
+ + + + + +
+ + +We recommend using Zipkin’s native support for message-based span sending. +Starting from the Edgware release, the Zipkin Stream server is deprecated. +In the Finchley release, it got removed. +
+
+
+

If for some reason you need to create the deprecated Stream Zipkin server, see the Dalston Documentation.

+
+
+
+
+

14. Integrations

+
+
+

14.1. OpenTracing

+
+

Spring Cloud Sleuth is compatible with OpenTracing. +If you have OpenTracing on the classpath, we automatically register the OpenTracing Tracer bean. +If you wish to disable this, set spring.sleuth.opentracing.enabled to false

+
+
+
+

14.2. Runnable and Callable

+
+

If you wrap your logic in Runnable or Callable, you can wrap those classes in their Sleuth representative, as shown in the following example for Runnable:

+
+
+
+
Runnable runnable = new Runnable() {
+    @Override
+    public void run() {
+        // do some work
+    }
+
+    @Override
+    public String toString() {
+        return "spanNameFromToStringMethod";
+    }
+};
+// Manual `TraceRunnable` creation with explicit "calculateTax" Span name
+Runnable traceRunnable = new TraceRunnable(this.tracing, spanNamer, runnable,
+        "calculateTax");
+// Wrapping `Runnable` with `Tracing`. That way the current span will be available
+// in the thread of `Runnable`
+Runnable traceRunnableFromTracer = this.tracing.currentTraceContext()
+        .wrap(runnable);
+
+
+
+

The following example shows how to do so for Callable:

+
+
+
+
Callable<String> callable = new Callable<String>() {
+    @Override
+    public String call() throws Exception {
+        return someLogic();
+    }
+
+    @Override
+    public String toString() {
+        return "spanNameFromToStringMethod";
+    }
+};
+// Manual `TraceCallable` creation with explicit "calculateTax" Span name
+Callable<String> traceCallable = new TraceCallable<>(this.tracing, spanNamer,
+        callable, "calculateTax");
+// Wrapping `Callable` with `Tracing`. That way the current span will be available
+// in the thread of `Callable`
+Callable<String> traceCallableFromTracer = this.tracing.currentTraceContext()
+        .wrap(callable);
+
+
+
+

That way, you ensure that a new span is created and closed for each execution.

+
+
+
+

14.3. Spring Cloud CircuitBreaker

+
+

If you have Spring Cloud CircuitBreaker on the classpath, we will wrap the passed command Supplier and the fallback Function in its trace representations. In order to disable this instrumentation set spring.sleuth.circuitbreaker.enabled to false.

+
+
+
+

14.4. RxJava

+
+

We registering a custom RxJavaSchedulersHook that wraps all Action0 instances in their Sleuth representative, which is called TraceAction. +The hook either starts or continues a span, depending on whether tracing was already going on before the Action was scheduled. +To disable the custom RxJavaSchedulersHook, set the spring.sleuth.rxjava.schedulers.hook.enabled to false.

+
+
+

You can define a list of regular expressions for thread names for which you do not want spans to be created. +To do so, provide a comma-separated list of regular expressions in the spring.sleuth.rxjava.schedulers.ignoredthreads property.

+
+
+ + + + + +
+ + +The suggest approach to reactive programming and Sleuth is to use +the Reactor support. +
+
+
+
+

14.5. HTTP integration

+
+

Features from this section can be disabled by setting the spring.sleuth.web.enabled property with value equal to false.

+
+
+

14.5.1. HTTP Filter

+
+

Through the TracingFilter, all sampled incoming requests result in creation of a Span. +That Span’s name is http: + the path to which the request was sent. +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.

+
+
+

By default, all the spring boot actuator endpoints are automatically added to the skip pattern. +If you want to disable this behaviour set spring.sleuth.web.ignore-auto-configured-skip-patterns +to true.

+
+
+

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.

+
+
+
+

14.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. +In that case, please file an issue in Spring Cloud Sleuth.

+
+
+
+

14.5.3. Async Servlet support

+
+

If your controller returns a Callable or a WebAsyncTask, Spring Cloud Sleuth continues the existing span instead of creating a new one.

+
+
+
+

14.5.4. WebFlux support

+
+

Through TraceWebFilter, all sampled incoming requests result in creation of a Span. +That Span’s name is http: + the path to which the request was sent. +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.

+
+
+

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

+
+
+
+

14.5.5. Dubbo RPC support

+
+

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

+
+
+
+
<dependency>
+    <groupId>io.zipkin.brave</groupId>
+    <artifactId>brave-instrumentation-dubbo</artifactId>
+</dependency>
+
+
+
+

You need to also set a dubbo.properties file with the following contents:

+
+
+
+
dubbo.provider.filter=tracing
+dubbo.consumer.filter=tracing
+
+
+
+

You can read more about Brave - Dubbo integration here. +An example of Spring Cloud Sleuth and Dubbo can be found here.

+
+
+
+
+

14.6. HTTP Client Integration

+
+

14.6.1. Synchronous Rest Template

+
+

We inject a RestTemplate interceptor to ensure that all the tracing information is passed to the requests. +Each time a call is made, a new Span is created. +It gets closed upon receiving the response. +To block the synchronous RestTemplate features, set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+ + +You have to register RestTemplate as a bean so that the interceptors get injected. +If you create a RestTemplate instance with a new keyword, the instrumentation does NOT work. +
+
+
+
+

14.6.2. Asynchronous Rest Template

+
+ + + + + +
+ + +Starting with Sleuth 2.0.0, we no longer register a bean of AsyncRestTemplate type. +It is up to you to create such a bean. +Then we instrument it. +
+
+
+

To block the AsyncRestTemplate features, set spring.sleuth.web.async.client.enabled to false. +To disable creation of the default TraceAsyncClientHttpRequestFactoryWrapper, set spring.sleuth.web.async.client.factory.enabled +to false. +If you do not want to create AsyncRestClient at all, set spring.sleuth.web.async.client.template.enabled to false.

+
+
+
Multiple Asynchronous Rest Templates
+
+

Sometimes you need to use multiple implementations of the Asynchronous Rest Template. +In the following snippet, you can see an example of how to set up such a custom AsyncRestTemplate:

+
+
+
+
@Configuration
+@EnableAutoConfiguration
+static class Config {
+
+    @Bean(name = "customAsyncRestTemplate")
+    public AsyncRestTemplate traceAsyncRestTemplate() {
+        return new AsyncRestTemplate(asyncClientFactory(),
+                clientHttpRequestFactory());
+    }
+
+    private ClientHttpRequestFactory clientHttpRequestFactory() {
+        ClientHttpRequestFactory clientHttpRequestFactory = new CustomClientHttpRequestFactory();
+        // CUSTOMIZE HERE
+        return clientHttpRequestFactory;
+    }
+
+    private AsyncClientHttpRequestFactory asyncClientFactory() {
+        AsyncClientHttpRequestFactory factory = new CustomAsyncClientHttpRequestFactory();
+        // CUSTOMIZE HERE
+        return factory;
+    }
+
+}
+
+
+
+
+
+

14.6.3. WebClient

+
+

We inject a ExchangeFilterFunction implementation that creates a span and, through on-success and on-error callbacks, takes care of closing client-side spans.

+
+
+

To block this feature, set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+ + +You have to register WebClient as a bean so that the tracing instrumentation gets applied. +If you create a WebClient instance with a new keyword, the instrumentation does NOT work. +
+
+
+
+

14.6.4. Traverson

+
+

If you use the Traverson library, you can inject a RestTemplate as a bean into your Traverson object. +Since RestTemplate is already intercepted, you get full support for tracing in your client. The following pseudo code +shows how to do that:

+
+
+
+
@Autowired RestTemplate restTemplate;
+
+Traverson traverson = new Traverson(URI.create("https://some/address"),
+    MediaType.APPLICATION_JSON, MediaType.APPLICATION_JSON_UTF8).setRestOperations(restTemplate);
+// use Traverson
+
+
+
+
+

14.6.5. Apache HttpClientBuilder and HttpAsyncClientBuilder

+
+

We instrument the HttpClientBuilder and HttpAsyncClientBuilder so that +tracing context gets injected to the sent requests.

+
+
+

To block these features, set spring.sleuth.web.client.enabled to false.

+
+
+
+

14.6.6. Netty HttpClient

+
+

We instrument the Netty’s HttpClient.

+
+
+

To block this feature, set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+ + +You have to register HttpClient as a bean so that the instrumentation happens. +If you create a HttpClient instance with a new keyword, the instrumentation does NOT work. +
+
+
+
+

14.6.7. UserInfoRestTemplateCustomizer

+
+

We instrument the Spring Security’s UserInfoRestTemplateCustomizer.

+
+
+

To block this feature, set spring.sleuth.web.client.enabled to false.

+
+
+
+
+

14.7. Feign

+
+

By default, Spring Cloud Sleuth provides integration with Feign through TraceFeignClientAutoConfiguration. +You can disable it entirely by setting spring.sleuth.feign.enabled to false. +If you do so, no Feign-related instrumentation take place.

+
+
+

Part of Feign instrumentation is done through a FeignBeanPostProcessor. +You can disable it by setting spring.sleuth.feign.processor.enabled to false. +If you set it to false, Spring Cloud Sleuth does not instrument any of your custom Feign components. +However, all the default instrumentation is still there.

+
+
+
+

14.8. gRPC

+
+

Spring Cloud Sleuth provides instrumentation for gRPC through TraceGrpcAutoConfiguration. You can disable it entirely by setting spring.sleuth.grpc.enabled to false.

+
+
+

14.8.1. Variant 1

+
+
Dependencies
+
+ + + + + +
+ + +The gRPC integration relies on two external libraries to instrument clients and servers and both of those libraries must be on the class path to enable the instrumentation. +
+
+
+

Maven:

+
+
+
+
        <dependency>
+            <groupId>io.github.lognet</groupId>
+            <artifactId>grpc-spring-boot-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.zipkin.brave</groupId>
+            <artifactId>brave-instrumentation-grpc</artifactId>
+        </dependency>
+
+
+
+

Gradle:

+
+
+
+
    compile("io.github.lognet:grpc-spring-boot-starter")
+    compile("io.zipkin.brave:brave-instrumentation-grpc")
+
+
+
+
+
Server Instrumentation
+
+

Spring Cloud Sleuth leverages grpc-spring-boot-starter to register Brave’s gRPC server interceptor with all services annotated with @GRpcService.

+
+
+
+
Client Instrumentation
+
+

gRPC clients leverage a ManagedChannelBuilder to construct a ManagedChannel used to communicate to the gRPC server. The native ManagedChannelBuilder provides static methods as entry points for construction of ManagedChannel instances, however, this mechanism is outside the influence of the Spring application context.

+
+
+ + + + + +
+ + +Spring Cloud Sleuth provides a SpringAwareManagedChannelBuilder that can be customized through the Spring application context and injected by gRPC clients. This builder must be used when creating ManagedChannel instances. +
+
+
+

Sleuth creates a TracingManagedChannelBuilderCustomizer which inject Brave’s client interceptor into the SpringAwareManagedChannelBuilder.

+
+
+
+
+

14.8.2. Variant 2

+
+

Grpc Spring Boot Starter automatically detects the presence of Spring Cloud Sleuth and brave’s instrumentation for gRPC and registers the necessary client and/or server tooling.

+
+
+
+
+

14.9. Asynchronous Communication

+
+

14.9.1. @Async Annotated methods

+
+

In Spring Cloud Sleuth, we instrument async-related components so that the tracing information is passed between threads. +You can disable this behavior by setting the value of spring.sleuth.async.enabled to false.

+
+
+

If you annotate your method with @Async, we automatically create a new Span with the following characteristics:

+
+
+
    +
  • +

    If the method is annotated with @SpanName, the value of the annotation is the Span’s name.

    +
    • +
  • +

    If the method is not annotated with @SpanName, the Span name is the annotated method name.

    +
    • +
  • +

    The span is tagged with the method’s class name and method name.

    +
    • +
+
+
+
+

14.9.2. @Scheduled Annotated Methods

+
+

In Spring Cloud Sleuth, we instrument scheduled method execution so that the tracing information is passed between threads. +You can disable this behavior by setting the value of spring.sleuth.scheduled.enabled to false.

+
+
+

If you annotate your method with @Scheduled, we automatically create a new span with the following characteristics:

+
+
+
    +
  • +

    The span name is the annotated method name.

    +
    • +
  • +

    The span is tagged with the method’s class name and method name.

    +
    • +
+
+
+

If you want to skip span creation for some @Scheduled annotated classes, you can set the spring.sleuth.scheduled.skipPattern with a regular expression that matches the fully qualified name of the @Scheduled annotated class.

+
+
+
+

14.9.3. Executor, ExecutorService, and ScheduledExecutorService

+
+

We provide LazyTraceExecutor, TraceableExecutorService, and TraceableScheduledExecutorService. Those implementations create spans each time a new task is submitted, invoked, or scheduled.

+
+
+

The following example shows how to pass tracing information with TraceableExecutorService when working with CompletableFuture:

+
+
+
+
CompletableFuture<Long> completableFuture = CompletableFuture.supplyAsync(() -> {
+    // perform some logic
+    return 1_000_000L;
+}, new TraceableExecutorService(beanFactory, executorService,
+        // 'calculateTax' explicitly names the span - this param is optional
+        "calculateTax"));
+
+
+
+ + + + + +
+ + +Sleuth does not work with parallelStream() out of the box. +If you want to have the tracing information propagated through the stream, you have to use the approach with supplyAsync(...), as shown earlier. +
+
+
+

If there are beans that implement the Executor interface that you would like +to exclude from span creation, you can use the spring.sleuth.async.ignored-beans +property where you can provide a list of bean names.

+
+
+
Customization of Executors
+
+

Sometimes, you need to set up a custom instance of the AsyncExecutor. +The following example shows how to set up such a custom Executor:

+
+
+
+
@Configuration
+@EnableAutoConfiguration
+@EnableAsync
+// add the infrastructure role to ensure that the bean gets auto-proxied
+@Role(BeanDefinition.ROLE_INFRASTRUCTURE)
+static class CustomExecutorConfig extends AsyncConfigurerSupport {
+
+    @Autowired
+    BeanFactory beanFactory;
+
+    @Override
+    public Executor getAsyncExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        // CUSTOMIZE HERE
+        executor.setCorePoolSize(7);
+        executor.setMaxPoolSize(42);
+        executor.setQueueCapacity(11);
+        executor.setThreadNamePrefix("MyExecutor-");
+        // DON'T FORGET TO INITIALIZE
+        executor.initialize();
+        return new LazyTraceExecutor(this.beanFactory, executor);
+    }
+
+}
+
+
+
+ + + + + +
+ + +To ensure that your configuration gets post processed, remember +to add the @Role(BeanDefinition.ROLE_INFRASTRUCTURE) on your +@Configuration class +
+
+
+
+
+
+

14.10. Messaging

+
+

Features from this section can be disabled by setting the spring.sleuth.messaging.enabled property with value equal to false.

+
+
+

14.10.1. Spring Integration and Spring Cloud Stream

+
+

Spring Cloud Sleuth integrates with Spring Integration. +It creates spans for publish and subscribe events. +To disable Spring Integration instrumentation, set spring.sleuth.integration.enabled to false.

+
+
+

You can provide the spring.sleuth.integration.patterns pattern to explicitly provide the names of channels that you want to include for tracing. +By default, all channels but hystrixStreamOutput channel are included.

+
+
+ + + + + +
+ + +When using the Executor to build a Spring Integration IntegrationFlow, you must use the untraced version of the Executor. +Decorating the Spring Integration Executor Channel with TraceableExecutorService causes the spans to be improperly closed. +
+
+
+

If you want to customize the way tracing context is read from and written to message headers, +it’s enough for you to register beans of types:

+
+
+
    +
  • +

    Propagation.Setter<MessageHeaderAccessor, String> - for writing headers to the message

    +
    • +
  • +

    Propagation.Getter<MessageHeaderAccessor, String> - for reading headers from the message

    +
    • +
+
+
+
+

14.10.2. Spring RabbitMq

+
+

We instrument the RabbitTemplate so that tracing headers get injected +into the message.

+
+
+

To block this feature, set spring.sleuth.messaging.rabbit.enabled to false.

+
+
+
+

14.10.3. Spring Kafka

+
+

We instrument the Spring Kafka’s ProducerFactory and ConsumerFactory +so that tracing headers get injected into the created Spring Kafka’s +Producer and Consumer.

+
+
+

To block this feature, set spring.sleuth.messaging.kafka.enabled to false.

+
+
+
+

14.10.4. Spring Kafka Streams

+
+

We instrument the KafkaStreams KafkaClientSupplier so that tracing headers +get injected into the Producer and Consumer`s. A `KafkaStreamsTracing bean +allows for further instrumentation through additional TransformerSupplier and +ProcessorSupplier methods.

+
+
+

To block this feature, set spring.sleuth.messaging.kafka.streams.enabled to false.

+
+
+
+

14.10.5. Spring JMS

+
+

We instrument the JmsTemplate so that tracing headers get injected +into the message. We also support @JmsListener annotated methods on the consumer side.

+
+
+

To block this feature, set spring.sleuth.messaging.jms.enabled to false.

+
+
+ + + + + +
+ + +We don’t support baggage propagation for JMS +
+
+
+
+

14.10.6. Spring Cloud AWS Messaging SQS

+
+

We instrument @SqsListener which is provided by org.springframework.cloud:spring-cloud-aws-messaging +so that tracing headers get extracted from the message and a trace gets put into the context.

+
+
+

To block this feature, set spring.sleuth.messaging.sqs.enabled to false.

+
+
+
+
+

14.11. Redis

+
+

We set tracing property to Lettcue ClientResources instance to enable Brave tracing built in Lettuce . +To disable Redis support, set the spring.sleuth.redis.enabled property to false.

+
+
+
+

14.12. Quartz

+
+

We instrument quartz jobs by adding Job/Trigger listeners to the Quartz Scheduler.

+
+
+

To turn off this feature, set the spring.sleuth.quartz.enabled property to false.

+
+
+
+

14.13. Project Reactor

+
+

For projects depending on Project Reactor such as Spring Cloud Gateway, we suggest turning the spring.sleuth.reactor.decorate-on-each option to false. That way an increased performance gain should be observed in comparison to the standard instrumentation mechanism. What this option does is it will wrap decorate onLast operator instead of onEach which will result in creation of far fewer objects. The downside of this is that when Project Reactor will change threads, the trace propagation will continue without issues, however anything relying on the ThreadLocal such as e.g. MDC entries can be buggy.

+
+
+
+
+
+

15. Configuration properties

+
+
+

To see the list of all Sleuth related configuration properties please check the Appendix page.

+
+
+
+
+

16. Running examples

+
+
+

You can see the running examples deployed in the Pivotal Web Services. +Check them out at the following links:

+
+
+ +
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/highlight.min.js b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/highlight.min.js new file mode 100644 index 00000000..dcbbb4c7 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/highlight.min.js @@ -0,0 +1,2 @@ +/*! highlight.js v9.13.1 | BSD3 License | git.io/hljslicense */ +!function(e){var n="object"==typeof window&&window||"object"==typeof self&&self;"undefined"!=typeof exports?e(exports):n&&(n.hljs=e({}),"function"==typeof define&&define.amd&&define([],function(){return n.hljs}))}(function(e){function n(e){return e.replace(/&/g,"&").replace(//g,">")}function t(e){return e.nodeName.toLowerCase()}function r(e,n){var t=e&&e.exec(n);return t&&0===t.index}function a(e){return k.test(e)}function i(e){var n,t,r,i,o=e.className+" ";if(o+=e.parentNode?e.parentNode.className:"",t=M.exec(o))return w(t[1])?t[1]:"no-highlight";for(o=o.split(/\s+/),n=0,r=o.length;r>n;n++)if(i=o[n],a(i)||w(i))return i}function o(e){var n,t={},r=Array.prototype.slice.call(arguments,1);for(n in e)t[n]=e[n];return r.forEach(function(e){for(n in e)t[n]=e[n]}),t}function c(e){var n=[];return function r(e,a){for(var i=e.firstChild;i;i=i.nextSibling)3===i.nodeType?a+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:a,node:i}),a=r(i,a),t(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:a,node:i}));return a}(e,0),n}function u(e,r,a){function i(){return e.length&&r.length?e[0].offset!==r[0].offset?e[0].offset"}function c(e){l+=""}function u(e){("start"===e.event?o:c)(e.node)}for(var s=0,l="",f=[];e.length||r.length;){var g=i();if(l+=n(a.substring(s,g[0].offset)),s=g[0].offset,g===e){f.reverse().forEach(c);do u(g.splice(0,1)[0]),g=i();while(g===e&&g.length&&g[0].offset===s);f.reverse().forEach(o)}else"start"===g[0].event?f.push(g[0].node):f.pop(),u(g.splice(0,1)[0])}return l+n(a.substr(s))}function s(e){return e.v&&!e.cached_variants&&(e.cached_variants=e.v.map(function(n){return o(e,{v:null},n)})),e.cached_variants||e.eW&&[o(e)]||[e]}function l(e){function n(e){return e&&e.source||e}function t(t,r){return new RegExp(n(t),"m"+(e.cI?"i":"")+(r?"g":""))}function r(a,i){if(!a.compiled){if(a.compiled=!0,a.k=a.k||a.bK,a.k){var o={},c=function(n,t){e.cI&&(t=t.toLowerCase()),t.split(" ").forEach(function(e){var t=e.split("|");o[t[0]]=[n,t[1]?Number(t[1]):1]})};"string"==typeof a.k?c("keyword",a.k):B(a.k).forEach(function(e){c(e,a.k[e])}),a.k=o}a.lR=t(a.l||/\w+/,!0),i&&(a.bK&&(a.b="\\b("+a.bK.split(" ").join("|")+")\\b"),a.b||(a.b=/\B|\b/),a.bR=t(a.b),a.endSameAsBegin&&(a.e=a.b),a.e||a.eW||(a.e=/\B|\b/),a.e&&(a.eR=t(a.e)),a.tE=n(a.e)||"",a.eW&&i.tE&&(a.tE+=(a.e?"|":"")+i.tE)),a.i&&(a.iR=t(a.i)),null==a.r&&(a.r=1),a.c||(a.c=[]),a.c=Array.prototype.concat.apply([],a.c.map(function(e){return s("self"===e?a:e)})),a.c.forEach(function(e){r(e,a)}),a.starts&&r(a.starts,i);var u=a.c.map(function(e){return e.bK?"\\.?("+e.b+")\\.?":e.b}).concat([a.tE,a.i]).map(n).filter(Boolean);a.t=u.length?t(u.join("|"),!0):{exec:function(){return null}}}}r(e)}function f(e,t,a,i){function o(e){return new RegExp(e.replace(/[-\/\\^$*+?.()|[\]{}]/g,"\\$&"),"m")}function c(e,n){var t,a;for(t=0,a=n.c.length;a>t;t++)if(r(n.c[t].bR,e))return n.c[t].endSameAsBegin&&(n.c[t].eR=o(n.c[t].bR.exec(e)[0])),n.c[t]}function u(e,n){if(r(e.eR,n)){for(;e.endsParent&&e.parent;)e=e.parent;return e}return e.eW?u(e.parent,n):void 0}function s(e,n){return!a&&r(n.iR,e)}function p(e,n){var t=R.cI?n[0].toLowerCase():n[0];return e.k.hasOwnProperty(t)&&e.k[t]}function d(e,n,t,r){var a=r?"":j.classPrefix,i='',i+n+o}function h(){var e,t,r,a;if(!E.k)return n(k);for(a="",t=0,E.lR.lastIndex=0,r=E.lR.exec(k);r;)a+=n(k.substring(t,r.index)),e=p(E,r),e?(M+=e[1],a+=d(e[0],n(r[0]))):a+=n(r[0]),t=E.lR.lastIndex,r=E.lR.exec(k);return a+n(k.substr(t))}function b(){var e="string"==typeof E.sL;if(e&&!L[E.sL])return n(k);var t=e?f(E.sL,k,!0,B[E.sL]):g(k,E.sL.length?E.sL:void 0);return E.r>0&&(M+=t.r),e&&(B[E.sL]=t.top),d(t.language,t.value,!1,!0)}function v(){y+=null!=E.sL?b():h(),k=""}function m(e){y+=e.cN?d(e.cN,"",!0):"",E=Object.create(e,{parent:{value:E}})}function N(e,n){if(k+=e,null==n)return v(),0;var t=c(n,E);if(t)return t.skip?k+=n:(t.eB&&(k+=n),v(),t.rB||t.eB||(k=n)),m(t,n),t.rB?0:n.length;var r=u(E,n);if(r){var a=E;a.skip?k+=n:(a.rE||a.eE||(k+=n),v(),a.eE&&(k=n));do E.cN&&(y+=I),E.skip||E.sL||(M+=E.r),E=E.parent;while(E!==r.parent);return r.starts&&(r.endSameAsBegin&&(r.starts.eR=r.eR),m(r.starts,"")),a.rE?0:n.length}if(s(n,E))throw new Error('Illegal lexeme "'+n+'" for mode "'+(E.cN||"")+'"');return k+=n,n.length||1}var R=w(e);if(!R)throw new Error('Unknown language: "'+e+'"');l(R);var x,E=i||R,B={},y="";for(x=E;x!==R;x=x.parent)x.cN&&(y=d(x.cN,"",!0)+y);var k="",M=0;try{for(var C,A,S=0;;){if(E.t.lastIndex=S,C=E.t.exec(t),!C)break;A=N(t.substring(S,C.index),C[0]),S=C.index+A}for(N(t.substr(S)),x=E;x.parent;x=x.parent)x.cN&&(y+=I);return{r:M,value:y,language:e,top:E}}catch(O){if(O.message&&-1!==O.message.indexOf("Illegal"))return{r:0,value:n(t)};throw O}}function g(e,t){t=t||j.languages||B(L);var r={r:0,value:n(e)},a=r;return t.filter(w).filter(x).forEach(function(n){var t=f(n,e,!1);t.language=n,t.r>a.r&&(a=t),t.r>r.r&&(a=r,r=t)}),a.language&&(r.second_best=a),r}function p(e){return j.tabReplace||j.useBR?e.replace(C,function(e,n){return j.useBR&&"\n"===e?"
":j.tabReplace?n.replace(/\t/g,j.tabReplace):""}):e}function d(e,n,t){var r=n?y[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),-1===e.indexOf(r)&&a.push(r),a.join(" ").trim()}function h(e){var n,t,r,o,s,l=i(e);a(l)||(j.useBR?(n=document.createElementNS("http://www.w3.org/1999/xhtml","div"),n.innerHTML=e.innerHTML.replace(/\n/g,"").replace(//g,"\n")):n=e,s=n.textContent,r=l?f(l,s,!0):g(s),t=c(n),t.length&&(o=document.createElementNS("http://www.w3.org/1999/xhtml","div"),o.innerHTML=r.value,r.value=u(t,c(o),s)),r.value=p(r.value),e.innerHTML=r.value,e.className=d(e.className,l,r.language),e.result={language:r.language,re:r.r},r.second_best&&(e.second_best={language:r.second_best.language,re:r.second_best.r}))}function b(e){j=o(j,e)}function v(){if(!v.called){v.called=!0;var e=document.querySelectorAll("pre code");E.forEach.call(e,h)}}function m(){addEventListener("DOMContentLoaded",v,!1),addEventListener("load",v,!1)}function N(n,t){var r=L[n]=t(e);r.aliases&&r.aliases.forEach(function(e){y[e]=n})}function R(){return B(L)}function w(e){return e=(e||"").toLowerCase(),L[e]||L[y[e]]}function x(e){var n=w(e);return n&&!n.disableAutodetect}var E=[],B=Object.keys,L={},y={},k=/^(no-?highlight|plain|text)$/i,M=/\blang(?:uage)?-([\w-]+)\b/i,C=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,I="",j={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0};return e.highlight=f,e.highlightAuto=g,e.fixMarkup=p,e.highlightBlock=h,e.configure=b,e.initHighlighting=v,e.initHighlightingOnLoad=m,e.registerLanguage=N,e.listLanguages=R,e.getLanguage=w,e.autoDetection=x,e.inherit=o,e.IR="[a-zA-Z]\\w*",e.UIR="[a-zA-Z_]\\w*",e.NR="\\b\\d+(\\.\\d+)?",e.CNR="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",e.BNR="\\b(0b[01]+)",e.RSR="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",e.BE={b:"\\\\[\\s\\S]",r:0},e.ASM={cN:"string",b:"'",e:"'",i:"\\n",c:[e.BE]},e.QSM={cN:"string",b:'"',e:'"',i:"\\n",c:[e.BE]},e.PWM={b:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/},e.C=function(n,t,r){var a=e.inherit({cN:"comment",b:n,e:t,c:[]},r||{});return a.c.push(e.PWM),a.c.push({cN:"doctag",b:"(?:TODO|FIXME|NOTE|BUG|XXX):",r:0}),a},e.CLCM=e.C("//","$"),e.CBCM=e.C("/\\*","\\*/"),e.HCM=e.C("#","$"),e.NM={cN:"number",b:e.NR,r:0},e.CNM={cN:"number",b:e.CNR,r:0},e.BNM={cN:"number",b:e.BNR,r:0},e.CSSNM={cN:"number",b:e.NR+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",r:0},e.RM={cN:"regexp",b:/\//,e:/\/[gimuy]*/,i:/\n/,c:[e.BE,{b:/\[/,e:/\]/,r:0,c:[e.BE]}]},e.TM={cN:"title",b:e.IR,r:0},e.UTM={cN:"title",b:e.UIR,r:0},e.METHOD_GUARD={b:"\\.\\s*"+e.UIR,r:0},e});hljs.registerLanguage("bash",function(e){var t={cN:"variable",v:[{b:/\$[\w\d#@][\w\d_]*/},{b:/\$\{(.*?)}/}]},s={cN:"string",b:/"/,e:/"/,c:[e.BE,t,{cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]}]},a={cN:"string",b:/'/,e:/'/};return{aliases:["sh","zsh"],l:/\b-?[a-z\._]+\b/,k:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},c:[{cN:"meta",b:/^#![^\n]+sh\s*$/,r:10},{cN:"function",b:/\w[\w\d_]*\s*\(\s*\)\s*\{/,rB:!0,c:[e.inherit(e.TM,{b:/\w[\w\d_]*/})],r:0},e.HCM,s,a,t]}});hljs.registerLanguage("dockerfile",function(e){return{aliases:["docker"],cI:!0,k:"from maintainer expose env arg user onbuild stopsignal",c:[e.HCM,e.ASM,e.QSM,e.NM,{bK:"run cmd entrypoint volume add copy workdir label healthcheck shell",starts:{e:/[^\\]\n/,sL:"bash"}}],i:")?[^\s\(]+(\s+[^\s\(]+)\s*=/,r:5,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"type",b://,k:"reified",r:0},{cN:"params",b:/\(/,e:/\)/,endsParent:!0,k:t,r:0,c:[{b:/:/,e:/[=,\/]/,eW:!0,c:[{cN:"type",b:e.UIR},e.CLCM,e.CBCM],r:0},e.CLCM,e.CBCM,s,l,c,e.CNM]},e.CBCM]},{cN:"class",bK:"class interface trait",e:/[:\{(]|$/,eE:!0,i:"extends implements",c:[{bK:"public protected internal private constructor"},e.UTM,{cN:"type",b://,eB:!0,eE:!0,r:0},{cN:"type",b:/[,:]\s*/,e:/[<\(,]|$/,eB:!0,rE:!0},s,l]},c,{cN:"meta",b:"^#!/usr/bin/env",e:"$",i:"\n"},o]}});hljs.registerLanguage("java",function(e){var a="[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*",t=a+"(<"+a+"(\\s*,\\s*"+a+")*>)?",r="false synchronized int abstract float private char boolean var static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports do",s="\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",c={cN:"number",b:s,r:0};return{aliases:["jsp"],k:r,i:/<\/|#/,c:[e.C("/\\*\\*","\\*/",{r:0,c:[{b:/\w+@/,r:0},{cN:"doctag",b:"@[A-Za-z]+"}]}),e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"new throw return else",r:0},{cN:"function",b:"("+t+"\\s+)+"+e.UIR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:r,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,k:r,r:0,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},c,{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("xml",function(s){var e="[A-Za-z0-9\\._:-]+",t={eW:!0,i:/`]+/}]}]}]};return{aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist"],cI:!0,c:[{cN:"meta",b:"",r:10,c:[{b:"\\[",e:"\\]"}]},s.C("",{r:10}),{b:"<\\!\\[CDATA\\[",e:"\\]\\]>",r:10},{cN:"meta",b:/<\?xml/,e:/\?>/,r:10},{b:/<\?(php)?/,e:/\?>/,sL:"php",c:[{b:"/\\*",e:"\\*/",skip:!0},{b:'b"',e:'"',skip:!0},{b:"b'",e:"'",skip:!0},s.inherit(s.ASM,{i:null,cN:null,c:null,skip:!0}),s.inherit(s.QSM,{i:null,cN:null,c:null,skip:!0})]},{cN:"tag",b:"|$)",e:">",k:{name:"style"},c:[t],starts:{e:"",rE:!0,sL:["css","xml"]}},{cN:"tag",b:"|$)",e:">",k:{name:"script"},c:[t],starts:{e:"",rE:!0,sL:["actionscript","javascript","handlebars","xml"]}},{cN:"tag",b:"",c:[{cN:"name",b:/[^\/><\s]+/,r:0},t]}]}});hljs.registerLanguage("properties",function(r){var t="[ \\t\\f]*",e="[ \\t\\f]+",s="("+t+"[:=]"+t+"|"+e+")",n="([^\\\\\\W:= \\t\\f\\n]|\\\\.)+",a="([^\\\\:= \\t\\f\\n]|\\\\.)+",c={e:s,r:0,starts:{cN:"string",e:/$/,r:0,c:[{b:"\\\\\\n"}]}};return{cI:!0,i:/\S/,c:[r.C("^\\s*[!#]","$"),{b:n+s,rB:!0,c:[{cN:"attr",b:n,endsParent:!0,r:0}],starts:c},{b:a+s,rB:!0,r:0,c:[{cN:"meta",b:a,endsParent:!0,r:0}],starts:c},{cN:"attr",r:0,b:a+t+"$"}]}});hljs.registerLanguage("diff",function(e){return{aliases:["patch"],c:[{cN:"meta",r:10,v:[{b:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{b:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{b:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{cN:"comment",v:[{b:/Index: /,e:/$/},{b:/={3,}/,e:/$/},{b:/^\-{3}/,e:/$/},{b:/^\*{3} /,e:/$/},{b:/^\+{3}/,e:/$/},{b:/\*{5}/,e:/\*{5}$/}]},{cN:"addition",b:"^\\+",e:"$"},{cN:"deletion",b:"^\\-",e:"$"},{cN:"addition",b:"^\\!",e:"$"}]}});hljs.registerLanguage("shell",function(s){return{aliases:["console"],c:[{cN:"meta",b:"^\\s{0,3}[\\w\\d\\[\\]()@-]*[>%$#]",starts:{e:"$",sL:"bash"}}]}});hljs.registerLanguage("asciidoc",function(e){return{aliases:["adoc"],c:[e.C("^/{4,}\\n","\\n/{4,}$",{r:10}),e.C("^//","$",{r:0}),{cN:"title",b:"^\\.\\w.*$"},{b:"^[=\\*]{4,}\\n",e:"\\n^[=\\*]{4,}$",r:10},{cN:"section",r:10,v:[{b:"^(={1,5}) .+?( \\1)?$"},{b:"^[^\\[\\]\\n]+?\\n[=\\-~\\^\\+]{2,}$"}]},{cN:"meta",b:"^:.+?:",e:"\\s",eE:!0,r:10},{cN:"meta",b:"^\\[.+?\\]$",r:0},{cN:"quote",b:"^_{4,}\\n",e:"\\n_{4,}$",r:10},{cN:"code",b:"^[\\-\\.]{4,}\\n",e:"\\n[\\-\\.]{4,}$",r:10},{b:"^\\+{4,}\\n",e:"\\n\\+{4,}$",c:[{b:"<",e:">",sL:"xml",r:0}],r:10},{cN:"bullet",b:"^(\\*+|\\-+|\\.+|[^\\n]+?::)\\s+"},{cN:"symbol",b:"^(NOTE|TIP|IMPORTANT|WARNING|CAUTION):\\s+",r:10},{cN:"strong",b:"\\B\\*(?![\\*\\s])",e:"(\\n{2}|\\*)",c:[{b:"\\\\*\\w",r:0}]},{cN:"emphasis",b:"\\B'(?!['\\s])",e:"(\\n{2}|')",c:[{b:"\\\\'\\w",r:0}],r:0},{cN:"emphasis",b:"_(?![_\\s])",e:"(\\n{2}|_)",r:0},{cN:"string",v:[{b:"``.+?''"},{b:"`.+?'"}]},{cN:"code",b:"(`.+?`|\\+.+?\\+)",r:0},{cN:"code",b:"^[ \\t]",e:"$",r:0},{b:"^'{3,}[ \\t]*$",r:10},{b:"(link:)?(http|https|ftp|file|irc|image:?):\\S+\\[.*?\\]",rB:!0,c:[{b:"(link|image:?):",r:0},{cN:"link",b:"\\w",e:"[^\\[]+",r:0},{cN:"string",b:"\\[",e:"\\]",eB:!0,eE:!0,r:0}],r:10}]}});hljs.registerLanguage("aspectj",function(e){var t="false synchronized int abstract float private char boolean static null if const for true while long throw strictfp finally protected import native final return void enum else extends implements break transient new catch instanceof byte super volatile case assert short package default double public try this switch continue throws privileged aspectOf adviceexecution proceed cflowbelow cflow initialization preinitialization staticinitialization withincode target within execution getWithinTypeName handler thisJoinPoint thisJoinPointStaticPart thisEnclosingJoinPointStaticPart declare parents warning error soft precedence thisAspectInstance",i="get set args call";return{k:t,i:/<\/|#/,c:[e.C("/\\*\\*","\\*/",{r:0,c:[{b:/\w+@/,r:0},{cN:"doctag",b:"@[A-Za-z]+"}]}),e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"aspect",e:/[{;=]/,eE:!0,i:/[:;"\[\]]/,c:[{bK:"extends implements pertypewithin perthis pertarget percflowbelow percflow issingleton"},e.UTM,{b:/\([^\)]*/,e:/[)]+/,k:t+" "+i,eE:!1}]},{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,r:0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"pointcut after before around throwing returning",e:/[)]/,eE:!1,i:/["\[\]]/,c:[{b:e.UIR+"\\s*\\(",rB:!0,c:[e.UTM]}]},{b:/[:]/,rB:!0,e:/[{;]/,r:0,eE:!1,k:t,i:/["\[\]]/,c:[{b:e.UIR+"\\s*\\(",k:t+" "+i,r:0},e.QSM]},{bK:"new throw",r:0},{cN:"function",b:/\w+ +\w+(\.)?\w+\s*\([^\)]*\)\s*((throws)[\w\s,]+)?[\{;]/,rB:!0,e:/[{;=]/,k:t,eE:!0,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,r:0,k:t,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},e.CNM,{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("gradle",function(e){return{cI:!0,k:{keyword:"task project allprojects subprojects artifacts buildscript configurations dependencies repositories sourceSets description delete from into include exclude source classpath destinationDir includes options sourceCompatibility targetCompatibility group flatDir doLast doFirst flatten todir fromdir ant def abstract break case catch continue default do else extends final finally for if implements instanceof native new private protected public return static switch synchronized throw throws transient try volatile while strictfp package import false null super this true antlrtask checkstyle codenarc copy boolean byte char class double float int interface long short void compile runTime file fileTree abs any append asList asWritable call collect compareTo count div dump each eachByte eachFile eachLine every find findAll flatten getAt getErr getIn getOut getText grep immutable inject inspect intersect invokeMethods isCase join leftShift minus multiply newInputStream newOutputStream newPrintWriter newReader newWriter next plus pop power previous print println push putAt read readBytes readLines reverse reverseEach round size sort splitEachLine step subMap times toInteger toList tokenize upto waitForOrKill withPrintWriter withReader withStream withWriter withWriterAppend write writeLine"},c:[e.CLCM,e.CBCM,e.ASM,e.QSM,e.NM,e.RM]}});hljs.registerLanguage("json",function(e){var i={literal:"true false null"},n=[e.QSM,e.CNM],r={e:",",eW:!0,eE:!0,c:n,k:i},t={b:"{",e:"}",c:[{cN:"attr",b:/"/,e:/"/,c:[e.BE],i:"\\n"},e.inherit(r,{b:/:/})],i:"\\S"},c={b:"\\[",e:"\\]",c:[e.inherit(r)],i:"\\S"};return n.splice(n.length,0,t,c),{c:n,k:i,i:"\\S"}});hljs.registerLanguage("sql",function(e){var t=e.C("--","$");return{cI:!0,i:/[<>{}*]/,c:[{bK:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment with",e:/;/,eW:!0,l:/[\w\.]+/,k:{keyword:"as abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias allocate allow alter always analyze ancillary and any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force foreign form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notnull notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second section securefile security seed segment select self sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unnest unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null unknown",built_in:"array bigint binary bit blob bool boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text time timestamp varchar varying void"},c:[{cN:"string",b:"'",e:"'",c:[e.BE,{b:"''"}]},{cN:"string",b:'"',e:'"',c:[e.BE,{b:'""'}]},{cN:"string",b:"`",e:"`",c:[e.BE]},e.CNM,e.CBCM,t,e.HCM]},e.CBCM,t,e.HCM]}});hljs.registerLanguage("go",function(e){var t={keyword:"break default func interface select case map struct chan else goto package switch const fallthrough if range type continue for import return var go defer bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune",literal:"true false iota nil",built_in:"append cap close complex copy imag len make new panic print println real recover delete"};return{aliases:["golang"],k:t,i:"",rB:!0,e:"\\s*=>",c:[{cN:"params",v:[{b:r},{b:/\(\s*\)/},{b:/\(/,e:/\)/,eB:!0,eE:!0,k:t,c:s}]}]},{b://,sL:"xml",c:[{b:/<\w+\s*\/>/,skip:!0},{b:/<\w+/,e:/(\/\w+|\w+\/)>/,skip:!0,c:[{b:/<\w+\s*\/>/,skip:!0},"self"]}]}],r:0},{cN:"function",bK:"function",e:/\{/,eE:!0,c:[e.inherit(e.TM,{b:r}),{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,c:s}],i:/\[|%/},{b:/\$[(.]/},e.METHOD_GUARD,{cN:"class",bK:"class",e:/[{;=]/,eE:!0,i:/[:"\[\]]/,c:[{bK:"extends"},e.UTM]},{bK:"constructor",e:/\{/,eE:!0}],i:/#(?!!)/}}); \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/a11y-dark.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/a11y-dark.min.css new file mode 100644 index 00000000..b93b742a --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/a11y-dark.min.css @@ -0,0 +1,99 @@ +/* a11y-dark theme */ +/* Based on the Tomorrow Night Eighties theme: https://github.com/isagalaev/highlight.js/blob/master/src/styles/tomorrow-night-eighties.css */ +/* @author: ericwbailey */ + +/* Comment */ +.hljs-comment, +.hljs-quote { + color: #d4d0ab; +} + +/* Red */ +.hljs-variable, +.hljs-template-variable, +.hljs-tag, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class, +.hljs-regexp, +.hljs-deletion { + color: #ffa07a; +} + +/* Orange */ +.hljs-number, +.hljs-built_in, +.hljs-builtin-name, +.hljs-literal, +.hljs-type, +.hljs-params, +.hljs-meta, +.hljs-link { + color: #f5ab35; +} + +/* Yellow */ +.hljs-attribute { + color: #ffd700; +} + +/* Green */ +.hljs-string, +.hljs-symbol, +.hljs-bullet, +.hljs-addition { + color: #abe338; +} + +/* Blue */ +.hljs-title, +.hljs-section { + color: #00e0e0; +} + +/* Purple */ +.hljs-keyword, +.hljs-selector-tag { + color: #dcc6e0; +} + +.hljs { + display: block; + overflow-x: auto; + background: #2b2b2b; + color: #f8f8f2; + padding: 0.5em; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +@media screen and (-ms-high-contrast: active) { + .hljs-addition, + .hljs-attribute, + .hljs-built_in, + .hljs-builtin-name, + .hljs-bullet, + .hljs-comment, + .hljs-link, + .hljs-literal, + .hljs-meta, + .hljs-number, + .hljs-params, + .hljs-string, + .hljs-symbol, + .hljs-type, + .hljs-quote { + color: highlight; + } + + .hljs-keyword, + .hljs-selector-tag { + font-weight: bold; + } +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/an-old-hope.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/an-old-hope.min.css new file mode 100644 index 00000000..a6d56f4b --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/an-old-hope.min.css @@ -0,0 +1,89 @@ +/* + +An Old Hope – Star Wars Syntax (c) Gustavo Costa +Original theme - Ocean Dark Theme – by https://github.com/gavsiu +Based on Jesse Leite's Atom syntax theme 'An Old Hope' – https://github.com/JesseLeite/an-old-hope-syntax-atom + +*/ + +/* Death Star Comment */ +.hljs-comment, +.hljs-quote +{ + color: #B6B18B; +} + +/* Darth Vader */ +.hljs-variable, +.hljs-template-variable, +.hljs-tag, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class, +.hljs-regexp, +.hljs-deletion +{ + color: #EB3C54; +} + +/* Threepio */ +.hljs-number, +.hljs-built_in, +.hljs-builtin-name, +.hljs-literal, +.hljs-type, +.hljs-params, +.hljs-meta, +.hljs-link +{ + color: #E7CE56; +} + +/* Luke Skywalker */ +.hljs-attribute +{ + color: #EE7C2B; +} + +/* Obi Wan Kenobi */ +.hljs-string, +.hljs-symbol, +.hljs-bullet, +.hljs-addition +{ + color: #4FB4D7; +} + +/* Yoda */ +.hljs-title, +.hljs-section +{ + color: #78BB65; +} + +/* Mace Windu */ +.hljs-keyword, +.hljs-selector-tag +{ + color: #B45EA4; +} + +/* Millenium Falcon */ +.hljs +{ + display: block; + overflow-x: auto; + background: #1C1D21; + color: #c0c5ce; + padding: 0.5em; +} + +.hljs-emphasis +{ + font-style: italic; +} + +.hljs-strong +{ + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-dark-reasonable.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-dark-reasonable.min.css new file mode 100644 index 00000000..fd41c996 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-dark-reasonable.min.css @@ -0,0 +1,77 @@ +/* + +Atom One Dark With support for ReasonML by Gidi Morris, based off work by Daniel Gamage + +Original One Dark Syntax theme from https://github.com/atom/one-dark-syntax + +*/ +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + line-height: 1.3em; + color: #abb2bf; + background: #282c34; + border-radius: 5px; +} +.hljs-keyword, .hljs-operator { + color: #F92672; +} +.hljs-pattern-match { + color: #F92672; +} +.hljs-pattern-match .hljs-constructor { + color: #61aeee; +} +.hljs-function { + color: #61aeee; +} +.hljs-function .hljs-params { + color: #A6E22E; +} +.hljs-function .hljs-params .hljs-typing { + color: #FD971F; +} +.hljs-module-access .hljs-module { + color: #7e57c2; +} +.hljs-constructor { + color: #e2b93d; +} +.hljs-constructor .hljs-string { + color: #9CCC65; +} +.hljs-comment, .hljs-quote { + color: #b18eb1; + font-style: italic; +} +.hljs-doctag, .hljs-formula { + color: #c678dd; +} +.hljs-section, .hljs-name, .hljs-selector-tag, .hljs-deletion, .hljs-subst { + color: #e06c75; +} +.hljs-literal { + color: #56b6c2; +} +.hljs-string, .hljs-regexp, .hljs-addition, .hljs-attribute, .hljs-meta-string { + color: #98c379; +} +.hljs-built_in, .hljs-class .hljs-title { + color: #e6c07b; +} +.hljs-attr, .hljs-variable, .hljs-template-variable, .hljs-type, .hljs-selector-class, .hljs-selector-attr, .hljs-selector-pseudo, .hljs-number { + color: #d19a66; +} +.hljs-symbol, .hljs-bullet, .hljs-link, .hljs-meta, .hljs-selector-id, .hljs-title { + color: #61aeee; +} +.hljs-emphasis { + font-style: italic; +} +.hljs-strong { + font-weight: bold; +} +.hljs-link { + text-decoration: underline; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-dark.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-dark.min.css new file mode 100644 index 00000000..1616aafe --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-dark.min.css @@ -0,0 +1,96 @@ +/* + +Atom One Dark by Daniel Gamage +Original One Dark Syntax theme from https://github.com/atom/one-dark-syntax + +base: #282c34 +mono-1: #abb2bf +mono-2: #818896 +mono-3: #5c6370 +hue-1: #56b6c2 +hue-2: #61aeee +hue-3: #c678dd +hue-4: #98c379 +hue-5: #e06c75 +hue-5-2: #be5046 +hue-6: #d19a66 +hue-6-2: #e6c07b + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + color: #abb2bf; + background: #282c34; +} + +.hljs-comment, +.hljs-quote { + color: #5c6370; + font-style: italic; +} + +.hljs-doctag, +.hljs-keyword, +.hljs-formula { + color: #c678dd; +} + +.hljs-section, +.hljs-name, +.hljs-selector-tag, +.hljs-deletion, +.hljs-subst { + color: #e06c75; +} + +.hljs-literal { + color: #56b6c2; +} + +.hljs-string, +.hljs-regexp, +.hljs-addition, +.hljs-attribute, +.hljs-meta-string { + color: #98c379; +} + +.hljs-built_in, +.hljs-class .hljs-title { + color: #e6c07b; +} + +.hljs-attr, +.hljs-variable, +.hljs-template-variable, +.hljs-type, +.hljs-selector-class, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-number { + color: #d19a66; +} + +.hljs-symbol, +.hljs-bullet, +.hljs-link, +.hljs-meta, +.hljs-selector-id, +.hljs-title { + color: #61aeee; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-link { + text-decoration: underline; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-light.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-light.min.css new file mode 100644 index 00000000..d5bd1d2a --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/atom-one-light.min.css @@ -0,0 +1,96 @@ +/* + +Atom One Light by Daniel Gamage +Original One Light Syntax theme from https://github.com/atom/one-light-syntax + +base: #fafafa +mono-1: #383a42 +mono-2: #686b77 +mono-3: #a0a1a7 +hue-1: #0184bb +hue-2: #4078f2 +hue-3: #a626a4 +hue-4: #50a14f +hue-5: #e45649 +hue-5-2: #c91243 +hue-6: #986801 +hue-6-2: #c18401 + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + color: #383a42; + background: #fafafa; +} + +.hljs-comment, +.hljs-quote { + color: #a0a1a7; + font-style: italic; +} + +.hljs-doctag, +.hljs-keyword, +.hljs-formula { + color: #a626a4; +} + +.hljs-section, +.hljs-name, +.hljs-selector-tag, +.hljs-deletion, +.hljs-subst { + color: #e45649; +} + +.hljs-literal { + color: #0184bb; +} + +.hljs-string, +.hljs-regexp, +.hljs-addition, +.hljs-attribute, +.hljs-meta-string { + color: #50a14f; +} + +.hljs-built_in, +.hljs-class .hljs-title { + color: #c18401; +} + +.hljs-attr, +.hljs-variable, +.hljs-template-variable, +.hljs-type, +.hljs-selector-class, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-number { + color: #986801; +} + +.hljs-symbol, +.hljs-bullet, +.hljs-link, +.hljs-meta, +.hljs-selector-id, +.hljs-title { + color: #4078f2; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-link { + text-decoration: underline; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/dracula.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/dracula.min.css new file mode 100644 index 00000000..578f0b40 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/dracula.min.css @@ -0,0 +1,76 @@ +/* + +Dracula Theme v1.2.0 + +https://github.com/zenorocha/dracula-theme + +Copyright 2015, All rights reserved + +Code licensed under the MIT license +https://zenorocha.mit-license.org/ + +@author Éverton Ribeiro +@author Zeno Rocha + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #282a36; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-section, +.hljs-link { + color: #8be9fd; +} + +.hljs-function .hljs-keyword { + color: #ff79c6; +} + +.hljs, +.hljs-subst { + color: #f8f8f2; +} + +.hljs-string, +.hljs-title, +.hljs-name, +.hljs-type, +.hljs-attribute, +.hljs-symbol, +.hljs-bullet, +.hljs-addition, +.hljs-variable, +.hljs-template-tag, +.hljs-template-variable { + color: #f1fa8c; +} + +.hljs-comment, +.hljs-quote, +.hljs-deletion, +.hljs-meta { + color: #6272a4; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-title, +.hljs-section, +.hljs-doctag, +.hljs-type, +.hljs-name, +.hljs-strong { + font-weight: bold; +} + +.hljs-emphasis { + font-style: italic; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/github.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/github.min.css new file mode 100644 index 00000000..791932b8 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/github.min.css @@ -0,0 +1,99 @@ +/* + +github.com style (c) Vasily Polovnyov + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + color: #333; + background: #f8f8f8; +} + +.hljs-comment, +.hljs-quote { + color: #998; + font-style: italic; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-subst { + color: #333; + font-weight: bold; +} + +.hljs-number, +.hljs-literal, +.hljs-variable, +.hljs-template-variable, +.hljs-tag .hljs-attr { + color: #008080; +} + +.hljs-string, +.hljs-doctag { + color: #d14; +} + +.hljs-title, +.hljs-section, +.hljs-selector-id { + color: #900; + font-weight: bold; +} + +.hljs-subst { + font-weight: normal; +} + +.hljs-type, +.hljs-class .hljs-title { + color: #458; + font-weight: bold; +} + +.hljs-tag, +.hljs-name, +.hljs-attribute { + color: #000080; + font-weight: normal; +} + +.hljs-regexp, +.hljs-link { + color: #009926; +} + +.hljs-symbol, +.hljs-bullet { + color: #990073; +} + +.hljs-built_in, +.hljs-builtin-name { + color: #0086b3; +} + +.hljs-meta { + color: #999; + font-weight: bold; +} + +.hljs-deletion { + background: #fdd; +} + +.hljs-addition { + background: #dfd; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/monokai-sublime.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/monokai-sublime.min.css new file mode 100644 index 00000000..ed52c92e --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/monokai-sublime.min.css @@ -0,0 +1,83 @@ +/* + +Monokai Sublime style. Derived from Monokai by noformnocontent https://nn.mit-license.org/ + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #23241f; +} + +.hljs, +.hljs-tag, +.hljs-subst { + color: #f8f8f2; +} + +.hljs-strong, +.hljs-emphasis { + color: #a8a8a2; +} + +.hljs-bullet, +.hljs-quote, +.hljs-number, +.hljs-regexp, +.hljs-literal, +.hljs-link { + color: #ae81ff; +} + +.hljs-code, +.hljs-title, +.hljs-section, +.hljs-selector-class { + color: #a6e22e; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-name, +.hljs-attr { + color: #f92672; +} + +.hljs-symbol, +.hljs-attribute { + color: #66d9ef; +} + +.hljs-params, +.hljs-class .hljs-title { + color: #f8f8f2; +} + +.hljs-string, +.hljs-type, +.hljs-built_in, +.hljs-builtin-name, +.hljs-selector-id, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-addition, +.hljs-variable, +.hljs-template-variable { + color: #e6db74; +} + +.hljs-comment, +.hljs-deletion, +.hljs-meta { + color: #75715e; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/monokai.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/monokai.min.css new file mode 100644 index 00000000..a5735585 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/monokai.min.css @@ -0,0 +1,70 @@ +/* +Monokai style - ported by Luigi Maselli - https://grigio.org +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #272822; color: #ddd; +} + +.hljs-tag, +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-strong, +.hljs-name { + color: #f92672; +} + +.hljs-code { + color: #66d9ef; +} + +.hljs-class .hljs-title { + color: white; +} + +.hljs-attribute, +.hljs-symbol, +.hljs-regexp, +.hljs-link { + color: #bf79db; +} + +.hljs-string, +.hljs-bullet, +.hljs-subst, +.hljs-title, +.hljs-section, +.hljs-emphasis, +.hljs-type, +.hljs-built_in, +.hljs-builtin-name, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-addition, +.hljs-variable, +.hljs-template-tag, +.hljs-template-variable { + color: #a6e22e; +} + +.hljs-comment, +.hljs-quote, +.hljs-deletion, +.hljs-meta { + color: #75715e; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-doctag, +.hljs-title, +.hljs-section, +.hljs-type, +.hljs-selector-id { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/solarized-light.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/solarized-light.min.css new file mode 100644 index 00000000..fdcfcc72 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/solarized-light.min.css @@ -0,0 +1,84 @@ +/* + +Orginal Style from ethanschoonover.com/solarized (c) Jeremy Hull + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #fdf6e3; + color: #657b83; +} + +.hljs-comment, +.hljs-quote { + color: #93a1a1; +} + +/* Solarized Green */ +.hljs-keyword, +.hljs-selector-tag, +.hljs-addition { + color: #859900; +} + +/* Solarized Cyan */ +.hljs-number, +.hljs-string, +.hljs-meta .hljs-meta-string, +.hljs-literal, +.hljs-doctag, +.hljs-regexp { + color: #2aa198; +} + +/* Solarized Blue */ +.hljs-title, +.hljs-section, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class { + color: #268bd2; +} + +/* Solarized Yellow */ +.hljs-attribute, +.hljs-attr, +.hljs-variable, +.hljs-template-variable, +.hljs-class .hljs-title, +.hljs-type { + color: #b58900; +} + +/* Solarized Orange */ +.hljs-symbol, +.hljs-bullet, +.hljs-subst, +.hljs-meta, +.hljs-meta .hljs-keyword, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-link { + color: #cb4b16; +} + +/* Solarized Red */ +.hljs-built_in, +.hljs-deletion { + color: #dc322f; +} + +.hljs-formula { + background: #eee8d5; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/zenburn.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/zenburn.min.css new file mode 100644 index 00000000..07be5020 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/highlight/styles/zenburn.min.css @@ -0,0 +1,80 @@ +/* + +Zenburn style from voldmar.ru (c) Vladimir Epifanov +based on dark.css by Ivan Sagalaev + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #3f3f3f; + color: #dcdcdc; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-tag { + color: #e3ceab; +} + +.hljs-template-tag { + color: #dcdcdc; +} + +.hljs-number { + color: #8cd0d3; +} + +.hljs-variable, +.hljs-template-variable, +.hljs-attribute { + color: #efdcbc; +} + +.hljs-literal { + color: #efefaf; +} + +.hljs-subst { + color: #8f8f8f; +} + +.hljs-title, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class, +.hljs-section, +.hljs-type { + color: #efef8f; +} + +.hljs-symbol, +.hljs-bullet, +.hljs-link { + color: #dca3a3; +} + +.hljs-deletion, +.hljs-string, +.hljs-built_in, +.hljs-builtin-name { + color: #cc9393; +} + +.hljs-addition, +.hljs-comment, +.hljs-quote, +.hljs-meta { + color: #7f9f7f; +} + + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/toc.js b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/toc.js new file mode 100644 index 00000000..0b6fcd65 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/toc.js @@ -0,0 +1,80 @@ +var toctitle = document.getElementById('toctitle'); +var path = window.location.pathname; +if (toctitle != null) { + var oldtoc = toctitle.nextElementSibling; + var newtoc = document.createElement('div'); + newtoc.setAttribute('id', 'tocbot'); + newtoc.setAttribute('class', 'js-toc desktop-toc'); + oldtoc.setAttribute('class', 'mobile-toc'); + oldtoc.parentNode.appendChild(newtoc); + tocbot.init({ + contentSelector: '#content', + headingSelector: 'h1, h2, h3, h4, h5', + positionFixedSelector: 'body', + fixedSidebarOffset: 90, + smoothScroll: false + }); + if (!path.endsWith("index.html") && !path.endsWith("/")) { + var link = document.createElement("a"); + if (document.getElementById('index-link')) { + indexLinkElement = document.querySelector('#index-link > p > a'); + linkHref = indexLinkElement.getAttribute("href"); + link.setAttribute("href", linkHref); + } else { + link.setAttribute("href", "index.html"); + } + link.innerHTML = " Back to index"; + var block = document.createElement("div"); + block.setAttribute('class', 'back-action'); + block.appendChild(link); + var toc = document.getElementById('toc'); + var next = document.getElementById('toctitle').nextElementSibling; + toc.insertBefore(block, next); + } +} + +var headerHtml = '
\n' + + '

\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '

\n' + + '
'; + +var header = document.createElement("div"); +header.innerHTML = headerHtml; +document.body.insertBefore(header, document.body.firstChild); diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/tocbot/tocbot.css b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/tocbot/tocbot.css new file mode 100644 index 00000000..0632de23 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/tocbot/tocbot.css @@ -0,0 +1 @@ +.toc{overflow-y:auto}.toc>.toc-list{overflow:hidden;position:relative}.toc>.toc-list li{list-style:none}.toc-list{margin:0;padding-left:10px}a.toc-link{color:currentColor;height:100%}.is-collapsible{max-height:1000px;overflow:hidden;transition:all 300ms ease-in-out}.is-collapsed{max-height:0}.is-position-fixed{position:fixed !important;top:0}.is-active-link{font-weight:700}.toc-link::before{background-color:#EEE;content:' ';display:inline-block;height:inherit;left:0;margin-top:-1px;position:absolute;width:2px}.is-active-link::before{background-color:#54BC4B} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/js/tocbot/tocbot.min.js b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/tocbot/tocbot.min.js new file mode 100644 index 00000000..943d8fdb --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/js/tocbot/tocbot.min.js @@ -0,0 +1 @@ +!function(e){function t(o){if(n[o])return n[o].exports;var l=n[o]={i:o,l:!1,exports:{}};return e[o].call(l.exports,l,l.exports,t),l.l=!0,l.exports}var n={};t.m=e,t.c=n,t.d=function(e,n,o){t.o(e,n)||Object.defineProperty(e,n,{configurable:!1,enumerable:!0,get:o})},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},t.p="",t(t.s=0)}([function(e,t,n){(function(o){var l,i,s;!function(n,o){i=[],l=o(n),void 0!==(s="function"==typeof l?l.apply(t,i):l)&&(e.exports=s)}(void 0!==o?o:this.window||this.global,function(e){"use strict";function t(){for(var e={},t=0;te.fixedSidebarOffset?-1===n.className.indexOf(e.positionFixedClass)&&(n.className+=h+e.positionFixedClass):n.className=n.className.split(h+e.positionFixedClass).join("")}function s(t){var n=document.documentElement.scrollTop||f.scrollTop;e.positionFixedSelector&&i();var o,l=t;if(m&&null!==document.querySelector(e.tocSelector)&&l.length>0){d.call(l,function(t,i){if(t.offsetTop>n+e.headingsOffset+10){return o=l[0===i?i:i-1],!0}if(i===l.length-1)return o=l[l.length-1],!0});var s=document.querySelector(e.tocSelector).querySelectorAll("."+e.linkClass);u.call(s,function(t){t.className=t.className.split(h+e.activeLinkClass).join("")});var c=document.querySelector(e.tocSelector).querySelectorAll("."+e.listItemClass);u.call(c,function(t){t.className=t.className.split(h+e.activeListItemClass).join("")});var a=document.querySelector(e.tocSelector).querySelector("."+e.linkClass+".node-name--"+o.nodeName+'[href="#'+o.id+'"]');-1===a.className.indexOf(e.activeLinkClass)&&(a.className+=h+e.activeLinkClass);var p=a.parentNode;p&&-1===p.className.indexOf(e.activeListItemClass)&&(p.className+=h+e.activeListItemClass);var C=document.querySelector(e.tocSelector).querySelectorAll("."+e.listClass+"."+e.collapsibleClass);u.call(C,function(t){-1===t.className.indexOf(e.isCollapsedClass)&&(t.className+=h+e.isCollapsedClass)}),a.nextSibling&&-1!==a.nextSibling.className.indexOf(e.isCollapsedClass)&&(a.nextSibling.className=a.nextSibling.className.split(h+e.isCollapsedClass).join("")),r(a.parentNode.parentNode)}}function r(t){return-1!==t.className.indexOf(e.collapsibleClass)&&-1!==t.className.indexOf(e.isCollapsedClass)?(t.className=t.className.split(h+e.isCollapsedClass).join(""),r(t.parentNode.parentNode)):t}function c(t){var n=t.target||t.srcElement;"string"==typeof n.className&&-1!==n.className.indexOf(e.linkClass)&&(m=!1)}function a(){m=!0}var u=[].forEach,d=[].some,f=document.body,m=!0,h=" ";return{enableTocAnimation:a,disableTocAnimation:c,render:n,updateToc:s}}},function(e,t){e.exports=function(e){function t(e){return e[e.length-1]}function n(e){return+e.nodeName.split("H").join("")}function o(t){var o={id:t.id,children:[],nodeName:t.nodeName,headingLevel:n(t),textContent:t.textContent.trim()};return e.includeHtml&&(o.childNodes=t.childNodes),o}function l(l,i){for(var s=o(l),r=n(l),c=i,a=t(c),u=a?a.headingLevel:0,d=r-u;d>0;)a=t(c),a&&void 0!==a.children&&(c=a.children),d--;return r>=e.collapseDepth&&(s.isCollapsed=!0),c.push(s),c}function i(t,n){var o=n;e.ignoreSelector&&(o=n.split(",").map(function(t){return t.trim()+":not("+e.ignoreSelector+")"}));try{return document.querySelector(t).querySelectorAll(o)}catch(e){return console.warn("Element not found: "+t),null}}function s(e){return r.call(e,function(e,t){return l(o(t),e.nest),e},{nest:[]})}var r=[].reduce;return{nestHeadingsArray:s,selectHeadings:i}}},function(e,t){function n(e){function t(e){return"a"===e.tagName.toLowerCase()&&(e.hash.length>0||"#"===e.href.charAt(e.href.length-1))&&(n(e.href)===s||n(e.href)+"#"===s)}function n(e){return e.slice(0,e.lastIndexOf("#"))}function l(e){var t=document.getElementById(e.substring(1));t&&(/^(?:a|select|input|button|textarea)$/i.test(t.tagName)||(t.tabIndex=-1),t.focus())}!function(){document.documentElement.style}();var i=e.duration,s=location.hash?n(location.href):location.href;!function(){function n(n){!t(n.target)||n.target.className.indexOf("no-smooth-scroll")>-1||"#"===n.target.href.charAt(n.target.href.length-2)&&"!"===n.target.href.charAt(n.target.href.length-1)||-1===n.target.className.indexOf(e.linkClass)||o(n.target.hash,{duration:i,callback:function(){l(n.target.hash)}})}document.body.addEventListener("click",n,!1)}()}function o(e,t){function n(e){s=e-i,window.scrollTo(0,c.easing(s,r,u,d)),s + + + + + + + + + + + + + + DEBUG + + + ${CONSOLE_LOG_PATTERN} + utf8 + + + + + + ${LOG_FILE} + + ${LOG_FILE}.%d{yyyy-MM-dd}.gz + 7 + + + ${CONSOLE_LOG_PATTERN} + utf8 + + + + + ${LOG_FILE}.json + + ${LOG_FILE}.json.%d{yyyy-MM-dd}.gz + 7 + + + + + UTC + + + + { + "timestamp": "@timestamp", + "severity": "%level", + "service": "${springAppName:-}", + "trace": "%X{traceId:-}", + "span": "%X{spanId:-}", + "pid": "${PID:-}", + "thread": "%thread", + "class": "%logger{40}", + "rest": "%message" + } + + + + + + + + + + + + diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/overview.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/overview.html new file mode 100644 index 00000000..1373e4cc --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/overview.html @@ -0,0 +1,170 @@ + + + + + + + +Overview + + + + + + + + + + +
+
+

Overview

+
+
+

Spring Cloud Sleuth provides Spring Boot auto-configuration for distributed +tracing. Underneath, Spring Cloud Sleuth is a layer over a Tracer library named +Brave.

+
+
+

Sleuth configures everything you need to get started. This includes where trace +data (spans) are reported to, how many traces to keep (sampling), if remote +fields (baggage) are sent, and which libraries are traced.

+
+
+

We maintain an example app where two Spring Boot services collaborate on an +HTTP request. Sleuth configures these apps, so that timing of these requests are +recorded into Zipkin, a distributed tracing system. Tracing +UIs visualize latency, such as time in one service vs waiting for other +services.

+
+
+

Here’s an example of what it looks like:

+
+
+
+Zipkin Trace +
+
+
+

The source repository of this +example includes demonstrations of many things, including WebFlux and messaging. +Most features require only a property or dependency change to work. These +snippets showcase the value of Spring Cloud Sleuth: Through auto-configuration, +Sleuth make getting started with distributed tracing easy!

+
+
+

To keep things simple, the same example is used throughout documentation using +basic HTTP communication.

+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/sagan-boot.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/sagan-boot.html new file mode 100644 index 00000000..0725903e --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/sagan-boot.html @@ -0,0 +1,219 @@ + + + + + + + +Untitled + + + + + + + + + + +
+
+
+
+

Add Sleuth to your classpath:

+
+
+

Maven

+
+
+
+
<dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-sleuth</artifactId>
+            <version>${spring-cloud-sleuth.version}</version>
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+    </dependencies>
+</dependencyManagement>
+<dependencies>
+    <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-starter-sleuth</artifactId>
+    </dependency>
+</dependencies>
+
+
+
+

Gradle

+
+
+
+
buildscript {
+    dependencies {
+        classpath "io.spring.gradle:dependency-management-plugin:0.5.2.RELEASE"
+    }
+}
+
+apply plugin: "io.spring.dependency-management"
+
+dependencyManagement {
+     imports {
+          mavenBom "org.springframework.cloud:spring-cloud-sleuth:${springCloudSleuthVersion}"
+     }
+}
+dependencies {
+    compile 'org.springframework.cloud:spring-cloud-starter-sleuth'
+}
+
+
+
+

As long as Spring Cloud Sleuth is on the classpath any Spring Boot application will generate trace data:

+
+
+
+
@SpringBootApplication
+@RestController
+public class Application {
+
+  private static Logger log = LoggerFactory.getLogger(DemoController.class);
+
+  @RequestMapping("/")
+  public String home() {
+    log.info("Handling home");
+    return "Hello World";
+  }
+
+  public static void main(String[] args) {
+    SpringApplication.run(Application.class, args);
+  }
+
+}
+
+
+
+

Run this app and then hit the home page. You will see traceId and spanId populated in the logs. +If this app calls out to another one (e.g. with RestTemplate) it will send the trace data in +headers and if the receiver is another Sleuth app you will see the trace continue there.

+
+
+
    +
  • +

    Instead of logging the request in the handler explicitly, you could set logging.level.org.springframework.web.servlet.DispatcherServlet=DEBUG

    +
    • +
  • +

    Sleuth defaults to a rate limited sampler. That means that it will sample up to 1000 transactions per second.

    +
    • +
  • +

    Set spring.application.name=bar (for instance) to see the service name as well as the trace and span ids.

    +
    • +
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/sagan-index.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/sagan-index.html new file mode 100644 index 00000000..354aef01 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/sagan-index.html @@ -0,0 +1,163 @@ + + + + + + + +Features + + + + + + + + + + +
+
+
+
+

Spring Cloud Sleuth provides Spring Boot auto-configuration for distributed +tracing.

+
+
+
+
+

Features

+
+
+

Sleuth configures everything you need to get started. This includes where trace +data (spans) are reported to, how many traces to keep (sampling), if remote +fields (baggage) are sent, and which libraries are traced.

+
+
+

Specifically, Spring Cloud Sleuth…​

+
+
+
    +
  • +

    Adds trace and span ids to the Slf4J MDC, so you can extract all the logs from a given trace or span in a log aggregator.

    +
    • +
  • +

    Instruments common ingress and egress points from Spring applications (servlet filter, rest template, scheduled actions, message channels, feign client).

    +
    • +
  • +

    If spring-cloud-sleuth-zipkin is available then the app will generate and report Zipkin-compatible traces via HTTP. By default it sends them to a Zipkin collector service on localhost (port 9411). Configure the location of the service using spring.zipkin.baseUrl.

    +
    • +
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/setup.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/setup.html new file mode 100644 index 00000000..437c7ce4 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/setup.html @@ -0,0 +1,462 @@ + + + + + + + +Adding Sleuth to your Project + + + + + + + + + + +
+
+

Adding Sleuth to your Project

+
+
+

This section addresses how to add Sleuth to your project with either Maven or Gradle.

+
+
+ + + + + +
+ + +To ensure that your application name is properly displayed in Zipkin, set the spring.application.name property in bootstrap.yml. +
+
+
+

Sleuth with Zipkin via HTTP

+
+

If you want both Sleuth and Zipkin, add the spring-cloud-starter-zipkin dependency.

+
+
+

The following example shows how to do so for Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+

The following example shows how to do so for Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+
+

Sleuth with Zipkin over RabbitMQ or Kafka

+
+

If you want to use RabbitMQ or Kafka instead of HTTP, add the spring-rabbit or spring-kafka dependency. +The default destination name is zipkin.

+
+
+

If using Kafka, you must set the property spring.zipkin.sender.type property accordingly:

+
+
+
+
spring.zipkin.sender.type: kafka
+
+
+
+ + + + + +
+ + +spring-cloud-sleuth-stream is deprecated and incompatible with these destinations. +
+
+
+

If you want Sleuth over RabbitMQ, add the spring-cloud-starter-zipkin and spring-rabbit +dependencies.

+
+
+

The following example shows how to do so for Gradle:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+<dependency> (3)
+    <groupId>org.springframework.amqp</groupId>
+    <artifactId>spring-rabbit</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies {
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin" (2)
+    compile "org.springframework.amqp:spring-rabbit" (3)
+}
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
+

Overriding the auto-configuration of Zipkin

+
+

Spring Cloud Sleuth supports sending traces to multiple tracing systems as of version 2.1.0. +In order to get this to work, every tracing system needs to have a Reporter<Span> and Sender. +If you want to override the provided beans you need to give them a specific name. +To do this you can use respectively ZipkinAutoConfiguration.REPORTER_BEAN_NAME and ZipkinAutoConfiguration.SENDER_BEAN_NAME.

+
+
+
+
@Configuration
+protected static class MyConfig {
+
+	@Bean(ZipkinAutoConfiguration.REPORTER_BEAN_NAME)
+	Reporter<zipkin2.Span> myReporter() {
+		return AsyncReporter.create(mySender());
+	}
+
+	@Bean(ZipkinAutoConfiguration.SENDER_BEAN_NAME)
+	MySender mySender() {
+		return new MySender();
+	}
+
+	static class MySender extends Sender {
+
+		private boolean spanSent = false;
+
+		boolean isSpanSent() {
+			return this.spanSent;
+		}
+
+		@Override
+		public Encoding encoding() {
+			return Encoding.JSON;
+		}
+
+		@Override
+		public int messageMaxBytes() {
+			return Integer.MAX_VALUE;
+		}
+
+		@Override
+		public int messageSizeInBytes(List<byte[]> encodedSpans) {
+			return encoding().listSizeInBytes(encodedSpans);
+		}
+
+		@Override
+		public Call<Void> sendSpans(List<byte[]> encodedSpans) {
+			this.spanSent = true;
+			return Call.create(null);
+		}
+
+	}
+
+}
+
+
+
+
+

Only Sleuth (log correlation)

+
+

If you want to use only Spring Cloud Sleuth without the Zipkin integration, add the spring-cloud-starter-sleuth module to your project.

+
+
+

The following example shows how to add Sleuth with Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-sleuth</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+

The following example shows how to add Sleuth with Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/html/spring-cloud-sleuth.html b/spring-cloud-sleuth/3.0.0.M1/reference/html/spring-cloud-sleuth.html new file mode 100644 index 00000000..71ec6332 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/html/spring-cloud-sleuth.html @@ -0,0 +1,2785 @@ + + + + + + + + +Spring Cloud Sleuth + + + + + + + + + + +
+
+
+
+

3.0.0.M1

+
+
+
+
+

1. Overview

+
+
+

Spring Cloud Sleuth provides Spring Boot auto-configuration for distributed +tracing. Underneath, Spring Cloud Sleuth is a layer over a Tracer library named +Brave.

+
+
+

Sleuth configures everything you need to get started. This includes where trace +data (spans) are reported to, how many traces to keep (sampling), if remote +fields (baggage) are sent, and which libraries are traced.

+
+
+

We maintain an example app where two Spring Boot services collaborate on an +HTTP request. Sleuth configures these apps, so that timing of these requests are +recorded into Zipkin, a distributed tracing system. Tracing +UIs visualize latency, such as time in one service vs waiting for other +services.

+
+
+

Here’s an example of what it looks like:

+
+
+
+Zipkin Trace +
+
+
+

The source repository of this +example includes demonstrations of many things, including WebFlux and messaging. +Most features require only a property or dependency change to work. These +snippets showcase the value of Spring Cloud Sleuth: Through auto-configuration, +Sleuth make getting started with distributed tracing easy!

+
+
+

To keep things simple, the same example is used throughout documentation using +basic HTTP communication.

+
+
+
+
+

2. Features

+
+
+

Sleuth sets up instrumentation not only to track timing, but also to catch +errors so that they can be analyzed or correlated with logs. This works the +same way regardless of if the error came from a common instrumented library, +such as RestTemplate, or your own code annotated with @NewSpan or similar.

+
+
+

Below, we’ll use the word Zipkin to describe the tracing system, and include +Zipkin screenshots. However, most services accepting Zipkin format +have similar base features. Sleuth can also be configured to send data in other +formats, something detailed later.

+
+
+

2.1. Contextualizing errors

+
+

Without distributed tracing, it can be difficult to understand the impact of a +an exception. For example, it can be hard to know if a specific request caused +the caller to fail or not.

+
+
+

Zipkin reduces time in triage by contextualizing errors and delays.

+
+
+

Requests colored red in the search screen failed:

+
+
+
+Error Traces +
+
+
+

If you then click on one of the traces, you can understand if the failure +happened before the request hit another service or not:

+
+
+
+Error Traces Info propagation +
+
+
+

For example, the above error happened in the "backend" service, and caused the +"frontend" service to fail.

+
+
+
+

2.2. Log correlation

+
+

Sleuth configures the logging context with variables including the service name +(%{spring.zipkin.service.name}) and the trace ID (%{traceId}). These help +you connect logs with distributed traces and allow you choice in what tools you +use to troubleshoot your services.

+
+
+

Once you find any log with an error, you can look for the trace ID in the +message. Paste that into Zipkin to visualize the entire trace, regardless of +how many services the first request ended up hitting.

+
+
+
+
backend.log:  2020-04-09 17:45:40.516 ERROR [backend,5e8eeec48b08e26882aba313eb08f0a4,dcc1df555b5777b3,true] 97203 --- [nio-9000-exec-1] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+frontend.log:2020-04-09 17:45:40.574 ERROR [frontend,5e8eeec48b08e26882aba313eb08f0a4,82aba313eb08f0a4,true] 97192 --- [nio-8081-exec-2] o.s.c.s.i.web.ExceptionLoggingFilter     : Uncaught exception thrown
+
+
+
+

Above, you’ll notice the trace ID is 5e8eeec48b08e26882aba313eb08f0a4, for +example. This log configuration was automatically setup by Sleuth.

+
+
+

If you use a log aggregating tool (such as Kibana, Splunk, and others), you can order the events that took place. +An example from Kibana would resemble the following image:

+
+
+
+Log correlation with Kibana +
+
+
+

If you want to use Logstash, the following listing shows the Grok pattern for Logstash:

+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+ + + + + +
+ + +If you want to use Grok together with the logs from Cloud Foundry, you have to use the following pattern: +
+
+
+
+
filter {
+  # pattern matching logback pattern
+  grok {
+    match => { "message" => "(?m)OUT\s+%{TIMESTAMP_ISO8601:timestamp}\s+%{LOGLEVEL:severity}\s+\[%{DATA:service},%{DATA:trace},%{DATA:span}\]\s+%{DATA:pid}\s+---\s+\[%{DATA:thread}\]\s+%{DATA:class}\s+:\s+%{GREEDYDATA:rest}" }
+  }
+  date {
+    match => ["timestamp", "ISO8601"]
+  }
+  mutate {
+    remove_field => ["timestamp"]
+  }
+}
+
+
+
+

2.2.1. JSON Logback with Logstash

+
+

Often, you do not want to store your logs in a text file but in a JSON file that Logstash can immediately pick. +To do so, you have to do the following (for readability, we pass the dependencies in the groupId:artifactId:version notation).

+
+
+

Dependencies Setup

+
+
+
    +
  1. +

    Ensure that Logback is on the classpath (ch.qos.logback:logback-core).

    +
    2. +
  2. +

    Add Logstash Logback encode. For example, to use version 4.6, add net.logstash.logback:logstash-logback-encoder:4.6.

    +
    3. +
+
+
+

Logback Setup

+
+
+

Consider the following example of a Logback configuration file (logback-spring.xml).

+
+
+
+
<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
+    <springProperty scope="context" name="springAppName" source="spring.application.name"/>
+    <!-- Example for logging into the build folder of your project -->
+    <property name="LOG_FILE" value="${BUILD_FOLDER:-build}/${springAppName}"/>
+
+    <!-- You can override this to have a custom pattern -->
+    <property name="CONSOLE_LOG_PATTERN"
+              value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>
+
+    <!-- Appender to log to console -->
+    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
+        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
+            <!-- Minimum logging level to be presented in the console logs-->
+            <level>DEBUG</level>
+        </filter>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+
+    <!-- Appender to log to file -->
+    <appender name="flatfile" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder>
+            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
+            <charset>utf8</charset>
+        </encoder>
+    </appender>
+    <!-- Appender to log to file in a JSON format -->
+    <appender name="logstash" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_FILE}.json</file>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_FILE}.json.%d{yyyy-MM-dd}.gz</fileNamePattern>
+            <maxHistory>7</maxHistory>
+        </rollingPolicy>
+        <encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
+            <providers>
+                <timestamp>
+                    <timeZone>UTC</timeZone>
+                </timestamp>
+                <pattern>
+                    <pattern>
+                        {
+                        "timestamp": "@timestamp",
+                        "severity": "%level",
+                        "service": "${springAppName:-}",
+                        "trace": "%X{traceId:-}",
+                        "span": "%X{spanId:-}",
+                        "pid": "${PID:-}",
+                        "thread": "%thread",
+                        "class": "%logger{40}",
+                        "rest": "%message"
+                        }
+                    </pattern>
+                </pattern>
+            </providers>
+        </encoder>
+    </appender>
+    <root level="INFO">
+        <appender-ref ref="console"/>
+        <!-- uncomment this to have also JSON logs -->
+        <!--<appender-ref ref="logstash"/>-->
+        <!--<appender-ref ref="flatfile"/>-->
+    </root>
+</configuration>
+
+
+
+

That Logback configuration file:

+
+
+
    +
  • +

    Logs information from the application in a JSON format to a build/${spring.application.name}.json file.

    +
    • +
  • +

    Has commented out two additional appenders: console and standard log file.

    +
    • +
  • +

    Has the same logging pattern as the one presented in the previous section.

    +
    • +
+
+
+ + + + + +
+ + +If you use a custom logback-spring.xml, you must pass the spring.application.name in the bootstrap rather than the application property file. +Otherwise, your custom logback file does not properly read the property. +
+
+
+
+
+

2.3. Service Dependency Graph

+
+

When you consider distributed tracing tracks requests, it makes sense that +trace data can paint a picture of your architecture.

+
+
+

Zipkin includes a tool to build service dependency diagrams from traces, +including the count of calls and how many errors exist.

+
+
+

The example application will make a simple diagram like this, but your real +environment diagram may be more complex. +image::https://raw.githubusercontent.com/spring-cloud/spring-cloud-sleuth/master/docs/src/main/asciidoc/images/zipkin-depedendencies.png[Zipkin Dependencies]

+
+
+

Note: Production environments will generate a lot of data. You will likely +need to run a separate service to aggregate the dependency graph. You can learn +more here.

+
+
+
+

2.4. Request scoped properties (Baggage)

+
+

Distributed tracing works by propagating fields inside and across services that +connect the trace together: traceId and spanId notably. The context that holds +these fields can optionally push other fields that need to be consistent +regardless of many services are touched. The simple name for these extra fields +is "Baggage".

+
+
+

Sleuth allows you to define which baggage are permitted to exist in the trace +context, including what header names are used.

+
+
+

The following example shows setting baggage values:

+
+
+
+
Span initialSpan = this.tracer.nextSpan().name("span").start();
+BUSINESS_PROCESS.updateValue(initialSpan.context(), "ALM");
+COUNTRY_CODE.updateValue(initialSpan.context(), "FO");
+
+
+
+ + + + + +
+ + +There is currently no limitation of the count or size of baggage +items. Keep in mind that too many can decrease system throughput or increase +RPC latency. In extreme cases, too much baggage can crash the application, due +to exceeding transport-level message or header capacity. +
+
+
+

2.4.1. Baggage versus Tags

+
+

Like trace IDs, Baggage is attached to messages or requests, usually as +headers. Tags are key value pairs sent in a Span to Zipkin. Baggage values are +not added spans by default, which means you can’t search based on Baggage +unless you opt-in.

+
+
+

To make baggage also tags, use the property spring.sleuth.baggage.tag-fields +like so:

+
+
+
+
spring:
+  sleuth:
+    baggage:
+      remoteFields:
+        - country-code
+        - x-vcap-request-id
+      tagFields:
+        - country-code
+
+
+
+
+
+
+
+

3. Adding Sleuth to your Project

+
+
+

This section addresses how to add Sleuth to your project with either Maven or Gradle.

+
+
+ + + + + +
+ + +To ensure that your application name is properly displayed in Zipkin, set the spring.application.name property in bootstrap.yml. +
+
+
+

3.1. Sleuth with Zipkin via HTTP

+
+

If you want both Sleuth and Zipkin, add the spring-cloud-starter-zipkin dependency.

+
+
+

The following example shows how to do so for Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+

The following example shows how to do so for Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin.
+
+
+
+

3.2. Sleuth with Zipkin over RabbitMQ or Kafka

+
+

If you want to use RabbitMQ or Kafka instead of HTTP, add the spring-rabbit or spring-kafka dependency. +The default destination name is zipkin.

+
+
+

If using Kafka, you must set the property spring.zipkin.sender.type property accordingly:

+
+
+
+
spring.zipkin.sender.type: kafka
+
+
+
+ + + + + +
+ + +spring-cloud-sleuth-stream is deprecated and incompatible with these destinations. +
+
+
+

If you want Sleuth over RabbitMQ, add the spring-cloud-starter-zipkin and spring-rabbit +dependencies.

+
+
+

The following example shows how to do so for Gradle:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-zipkin</artifactId>
+</dependency>
+<dependency> (3)
+    <groupId>org.springframework.amqp</groupId>
+    <artifactId>spring-rabbit</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies {
+    compile "org.springframework.cloud:spring-cloud-starter-zipkin" (2)
+    compile "org.springframework.amqp:spring-rabbit" (3)
+}
+
+
+
+ + + + + + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-zipkin. That way, all nested dependencies get downloaded.
3To automatically configure RabbitMQ, add the spring-rabbit dependency.
+
+
+
+

3.3. Overriding the auto-configuration of Zipkin

+
+

Spring Cloud Sleuth supports sending traces to multiple tracing systems as of version 2.1.0. +In order to get this to work, every tracing system needs to have a Reporter<Span> and Sender. +If you want to override the provided beans you need to give them a specific name. +To do this you can use respectively ZipkinAutoConfiguration.REPORTER_BEAN_NAME and ZipkinAutoConfiguration.SENDER_BEAN_NAME.

+
+
+
+
@Configuration
+protected static class MyConfig {
+
+    @Bean(ZipkinAutoConfiguration.REPORTER_BEAN_NAME)
+    Reporter<zipkin2.Span> myReporter() {
+        return AsyncReporter.create(mySender());
+    }
+
+    @Bean(ZipkinAutoConfiguration.SENDER_BEAN_NAME)
+    MySender mySender() {
+        return new MySender();
+    }
+
+    static class MySender extends Sender {
+
+        private boolean spanSent = false;
+
+        boolean isSpanSent() {
+            return this.spanSent;
+        }
+
+        @Override
+        public Encoding encoding() {
+            return Encoding.JSON;
+        }
+
+        @Override
+        public int messageMaxBytes() {
+            return Integer.MAX_VALUE;
+        }
+
+        @Override
+        public int messageSizeInBytes(List<byte[]> encodedSpans) {
+            return encoding().listSizeInBytes(encodedSpans);
+        }
+
+        @Override
+        public Call<Void> sendSpans(List<byte[]> encodedSpans) {
+            this.spanSent = true;
+            return Call.create(null);
+        }
+
+    }
+
+}
+
+
+
+
+

3.4. Only Sleuth (log correlation)

+
+

If you want to use only Spring Cloud Sleuth without the Zipkin integration, add the spring-cloud-starter-sleuth module to your project.

+
+
+

The following example shows how to add Sleuth with Maven:

+
+
+
Maven
+
+
<dependencyManagement> (1)
+      <dependencies>
+          <dependency>
+              <groupId>org.springframework.cloud</groupId>
+              <artifactId>spring-cloud-dependencies</artifactId>
+              <version>${release.train.version}</version>
+              <type>pom</type>
+              <scope>import</scope>
+          </dependency>
+      </dependencies>
+</dependencyManagement>
+
+<dependency> (2)
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-sleuth</artifactId>
+</dependency>
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+

The following example shows how to add Sleuth with Gradle:

+
+
+
Gradle
+
+
dependencyManagement { (1)
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${releaseTrainVersion}"
+    }
+}
+
+dependencies { (2)
+    compile "org.springframework.cloud:spring-cloud-starter-sleuth"
+}
+
+
+
+ + + + + + + + + +
1We recommend that you add the dependency management through the Spring BOM so that you need not manage versions yourself.
2Add the dependency to spring-cloud-starter-sleuth.
+
+
+
+
+
+

4. How Sleuth works

+
+
+

Spring Cloud Sleuth is a layer over Brave.

+
+
+

Brave is a distributed tracing instrumentation library. Brave typically +intercepts production requests to gather timing data, correlate and propagate +trace contexts.

+
+
+

Trace data, also called spans, are typically reported to Zipkin. +Zipkin is an Open Source tracing system, which includes a UI and various +collectors, such as HTTP and messaging.

+
+
+

Many Open Source and commercial products accept Zipkin format. +Some options are documented here, +but many are not. If you cannot use Zipkin and your product isn’t listed, clarify +with your support representative and have them update that page. In many cases, +products already support Zipkin format, they just don’t document it.

+
+
+

Traces connect from service to service using header propagation. The default +format is B3. Similar to data +formats, you can configure alternate header formats also, provided trace and +span IDs are compatible with B3. Most notably, this means the trace ID and span +IDs are lower-case hex, not UUIDs. Besides trace identifiers, other properties +(Baggage) can also be passed along with the request. Remote Baggage must be +predefined, but is flexible otherwise.

+
+
+

Sleuth configures everything you need to get started with tracing. Sleuth +configures where trace data (spans) are reported to, how many traces to keep +(sampling), if remote fields (baggage) are sent, and which libraries are traced. +Sleuth also adds annotation based tracing features and some instrumentation not +available otherwise, such as Reactor. If cannot find the configuration you are +looking for in the documentation, ask Gitter +before assuming something cannot be done.

+
+
+

4.1. Brave Basics

+
+

Most instrumentation work is done for you by default. Sleuth provides beans to +allow you to change what’s traced, and it even provides annotations to avoid +using tracing libraries! All of this is explained later in this document.

+
+
+

That said, you might want to know more about how things work underneath. Here +are some pointers.

+
+
+

Here are the most core types you might use: +* SpanCustomizer - to change the span currently in progress +* Tracer - to get a start new spans ad-hoc

+
+
+

Here are the most relevant links from the OpenZipkin Brave project: +* [Brave’s core library](github.com/openzipkin/brave/tree/master/brave) +* [Baggage (propagated fields)](github.com/openzipkin/brave/tree/master/brave#baggage) +* [HTTP tracing](github.com/openzipkin/brave/tree/master/instrumentation/http)

+
+
+
+
+
+

5. Sampling

+
+
+

By default Spring Cloud Sleuth doesn’t sample spans. +That means that traces appear in logs but not in any remote store. +For testing the default is often enough, and it probably is all you need if you use only the logs (for example, with an ELK aggregator). +If you export span data to Zipkin, there is also an Sampler.ALWAYS_SAMPLE setting that exports everything, RateLimitingSampler setting that samples X transactions per second (defaults to 1000) or ProbabilityBasedSampler setting that samples a fixed fraction of spans.

+
+
+ + + + + +
+ + +The RateLimitingSampler is the default if you use spring-cloud-sleuth-zipkin. +You can configure the rate limit by setting spring.sleuth.sampler.rate. +
+
+
+

A sampler can be installed by creating a bean definition, as shown in the following example:

+
+
+
+
@Bean
+public Sampler defaultSampler() {
+    return Sampler.ALWAYS_SAMPLE;
+}
+
+
+
+ + + + + +
+ + +You can set the HTTP header b3 to 1, or, when doing messaging, you can set the spanFlags header to 1. +Doing so forces the current request to be sampled regardless of configuration. +
+
+
+

In order to use the rate-limited sampler set the spring.sleuth.sampler.rate property to choose an amount of traces to accept on a per-second interval. The minimum number is 0 and the max is 2,147,483,647 (max int).

+
+
+
+
+

6. Baggage

+
+
+

Baggage are fields that are propagated with the trace, optionally out of process. You can use +properties to define fields that have no special configuration such as name mapping:

+
+
+
    +
  • +

    spring.sleuth.remote-fields is a list of header names to accept and propagate to remote services.

    +
    • +
  • +

    spring.sleuth.local-fields is a list of names to propagate locally

    +
    • +
+
+
+

No prefixing applies with these keys. What you set is literally what is used.

+
+
+

A name set in either of these properties will result in a BaggageField of the same name.

+
+
+

In order to automatically set the baggage values to Slf4j’s MDC, you have to set +the spring.sleuth.baggage.correlation-fields property with a list of whitelisted +local or remote keys. E.g. spring.sleuth.baggage.correlation-fields=country-code will set the +value of the country-code baggage into MDC.

+
+
+ + + + + +
+ + +Remember that adding entries to MDC can drastically decrease the performance of your application! +
+
+
+

If you want to add the baggage entries as tags, to make it possible to search for spans via the baggage entries, you can set the value of +spring.sleuth.baggage.tag-fields with a list of whitelisted baggage keys. To disable the feature you have to pass the spring.sleuth.propagation.tag.enabled=false property.

+
+
+

6.1. Java configuration

+
+

If you need to do anything more advanced than above, do not define properties and instead use a +@Bean config for the baggage fields you use. + * BaggagePropagationCustomizer sets up baggage fields + * Add a SingleBaggageField to control header names for a BaggageField. + * CorrelationScopeCustomizer sets up MDC fields + * Add a SingleCorrelationField to change the MDC name of a BaggageField or if updates flush.

+
+
+
+
+
+

7. Instrumentation

+
+
+

Spring Cloud Sleuth automatically instruments all your Spring applications, so you should not have to do anything to activate it. +The instrumentation is added by using a variety of technologies according to the stack that is available. For example, for a servlet web application, we use a Filter, and, for Spring Integration, we use ChannelInterceptors.

+
+
+

You can customize the keys used in span tags. +To limit the volume of span data, an HTTP request is, by default, tagged only with a handful of metadata, such as the status code, the host, and the URL. +You can add request headers by configuring spring.sleuth.keys.http.headers (a list of header names).

+
+
+ + + + + +
+ + +Tags are collected and exported only if there is a Sampler that allows it. By default, there is no such Sampler, to ensure that there is no danger of accidentally collecting too much data without configuring something). +
+
+
+
+
+

8. Span lifecycle

+
+
+

You can do the following operations on the Span by means of brave.Tracer:

+
+
+
    +
  • +

    start: When you start a span, its name is assigned and the start timestamp is recorded.

    +
    • +
  • +

    close: The span gets finished (the end time of the span is recorded) and, if the span is sampled, it is eligible for collection (for example, to Zipkin).

    +
    • +
  • +

    continue: A new instance of span is created. +It is a copy of the one that it continues.

    +
    • +
  • +

    detach: The span does not get stopped or closed. +It only gets removed from the current thread.

    +
    • +
  • +

    create with explicit parent: You can create a new span and set an explicit parent for it.

    +
    • +
+
+
+ + + + + +
+ + +Spring Cloud Sleuth creates an instance of Tracer for you. In order to use it, you can autowire it. +
+
+
+

8.1. Creating and finishing spans

+
+

You can manually create spans by using the Tracer, as shown in the following example:

+
+
+
+
// Start a span. If there was a span present in this thread it will become
+// the `newSpan`'s parent.
+Span newSpan = this.tracer.nextSpan().name("calculateTax");
+try (Tracer.SpanInScope ws = this.tracer.withSpanInScope(newSpan.start())) {
+    // ...
+    // You can tag a span
+    newSpan.tag("taxValue", taxValue);
+    // ...
+    // You can log an event on a span
+    newSpan.annotate("taxCalculated");
+}
+finally {
+    // Once done remember to finish the span. This will allow collecting
+    // the span to send it to Zipkin
+    newSpan.finish();
+}
+
+
+
+

In the preceding example, we could see how to create a new instance of the span. +If there is already a span in this thread, it becomes the parent of the new span.

+
+
+ + + + + +
+ + +Always clean after you create a span. Also, always finish any span that you want to send to Zipkin. +
+
+
+ + + + + +
+ + +If your span contains a name greater than 50 chars, that name is truncated to 50 chars. +Your names have to be explicit and concrete. Big names lead to latency issues and sometimes even exceptions. +
+
+
+
+

8.2. Continuing Spans

+
+

Sometimes, you do not want to create a new span but you want to continue one. An example of such a +situation might be as follows:

+
+
+
    +
  • +

    AOP: If there was already a span created before an aspect was reached, you might not want to create a new span.

    +
    • +
+
+
+

To continue a span, you can use brave.Tracer, as shown in the following example:

+
+
+
+
// let's assume that we're in a thread Y and we've received
+// the `initialSpan` from thread X
+Span continuedSpan = this.tracer.toSpan(newSpan.context());
+try {
+    // ...
+    // You can tag a span
+    continuedSpan.tag("taxValue", taxValue);
+    // ...
+    // You can log an event on a span
+    continuedSpan.annotate("taxCalculated");
+}
+finally {
+    // Once done remember to flush the span. That means that
+    // it will get reported but the span itself is not yet finished
+    continuedSpan.flush();
+}
+
+
+
+
+

8.3. Creating a Span with an explicit Parent

+
+

You might want to start a new span and provide an explicit parent of that span. +Assume that the parent of a span is in one thread and you want to start a new span in another thread. +In Brave, whenever you call nextSpan(), it creates a span in reference to the span that is currently in scope. +You can put the span in scope and then call nextSpan(), as shown in the following example:

+
+
+
+
// let's assume that we're in a thread Y and we've received
+// the `initialSpan` from thread X. `initialSpan` will be the parent
+// of the `newSpan`
+Span newSpan = null;
+try (Tracer.SpanInScope ws = this.tracer.withSpanInScope(initialSpan)) {
+    newSpan = this.tracer.nextSpan().name("calculateCommission");
+    // ...
+    // You can tag a span
+    newSpan.tag("commissionValue", commissionValue);
+    // ...
+    // You can log an event on a span
+    newSpan.annotate("commissionCalculated");
+}
+finally {
+    // Once done remember to finish the span. This will allow collecting
+    // the span to send it to Zipkin. The tags and events set on the
+    // newSpan will not be present on the parent
+    if (newSpan != null) {
+        newSpan.finish();
+    }
+}
+
+
+
+ + + + + +
+ + +After creating such a span, you must finish it. Otherwise it is not reported (for example, to Zipkin). +
+
+
+
+
+
+

9. Naming spans

+
+
+

Picking a span name is not a trivial task. A span name should depict an operation name. +The name should be low cardinality, so it should not include identifiers.

+
+
+

Since there is a lot of instrumentation going on, some span names are artificial:

+
+
+
    +
  • +

    controller-method-name when received by a Controller with a method name of controllerMethodName

    +
    • +
  • +

    async for asynchronous operations done with wrapped Callable and Runnable interfaces.

    +
    • +
  • +

    Methods annotated with @Scheduled return the simple name of the class.

    +
    • +
+
+
+

Fortunately, for asynchronous processing, you can provide explicit naming.

+
+
+

9.1. @SpanName Annotation

+
+

You can name the span explicitly by using the @SpanName annotation, as shown in the following example:

+
+
+
+
@SpanName("calculateTax")
+class TaxCountingRunnable implements Runnable {
+
+    @Override
+    public void run() {
+        // perform logic
+    }
+
+}
+
+
+
+

In this case, when processed in the following manner, the span is named calculateTax:

+
+
+
+
Runnable runnable = new TraceRunnable(this.tracing, spanNamer,
+        new TaxCountingRunnable());
+Future<?> future = executorService.submit(runnable);
+// ... some additional logic ...
+future.get();
+
+
+
+
+

9.2. toString() method

+
+

It is pretty rare to create separate classes for Runnable or Callable. +Typically, one creates an anonymous instance of those classes. +You cannot annotate such classes. +To overcome that limitation, if there is no @SpanName annotation present, we check whether the class has a custom implementation of the toString() method.

+
+
+

Running such code leads to creating a span named calculateTax, as shown in the following example:

+
+
+
+
Runnable runnable = new TraceRunnable(this.tracing, spanNamer, new Runnable() {
+    @Override
+    public void run() {
+        // perform logic
+    }
+
+    @Override
+    public String toString() {
+        return "calculateTax";
+    }
+});
+Future<?> future = executorService.submit(runnable);
+// ... some additional logic ...
+future.get();
+
+
+
+
+
+
+

10. Managing Spans with Annotations

+
+
+

You can manage spans with a variety of annotations.

+
+
+

10.1. Rationale

+
+

There are a number of good reasons to manage spans with annotations, including:

+
+
+
    +
  • +

    API-agnostic means to collaborate with a span. Use of annotations lets users add to a span with no library dependency on a span api. +Doing so lets Sleuth change its core API to create less impact to user code.

    +
    • +
  • +

    Reduced surface area for basic span operations. Without this feature, you must use the span api, which has lifecycle commands that could be used incorrectly. +By only exposing scope, tag, and log functionality, you can collaborate without accidentally breaking span lifecycle.

    +
    • +
  • +

    Collaboration with runtime generated code. With libraries such as Spring Data and Feign, the implementations of interfaces are generated at runtime. +Consequently, span wrapping of objects was tedious. +Now you can provide annotations over interfaces and the arguments of those interfaces.

    +
    • +
+
+
+
+

10.2. Creating New Spans

+
+

If you do not want to create local spans manually, you can use the @NewSpan annotation. +Also, we provide the @SpanTag annotation to add tags in an automated fashion.

+
+
+

Now we can consider some examples of usage.

+
+
+
+
@NewSpan
+void testMethod();
+
+
+
+

Annotating the method without any parameter leads to creating a new span whose name equals the annotated method name.

+
+
+
+
@NewSpan("customNameOnTestMethod4")
+void testMethod4();
+
+
+
+

If you provide the value in the annotation (either directly or by setting the name parameter), the created span has the provided value as the name.

+
+
+
+
// method declaration
+@NewSpan(name = "customNameOnTestMethod5")
+void testMethod5(@SpanTag("testTag") String param);
+
+// and method execution
+this.testBean.testMethod5("test");
+
+
+
+

You can combine both the name and a tag. Let’s focus on the latter. +In this case, the value of the annotated method’s parameter runtime value becomes the value of the tag. +In our sample, the tag key is testTag, and the tag value is test.

+
+
+
+
@NewSpan(name = "customNameOnTestMethod3")
+@Override
+public void testMethod3() {
+}
+
+
+
+

You can place the @NewSpan annotation on both the class and an interface. +If you override the interface’s method and provide a different value for the @NewSpan annotation, the most +concrete one wins (in this case customNameOnTestMethod3 is set).

+
+
+
+

10.3. Continuing Spans

+
+

If you want to add tags and annotations to an existing span, you can use the @ContinueSpan annotation, as shown in the following example:

+
+
+
+
// method declaration
+@ContinueSpan(log = "testMethod11")
+void testMethod11(@SpanTag("testTag11") String param);
+
+// method execution
+this.testBean.testMethod11("test");
+this.testBean.testMethod13();
+
+
+
+

(Note that, in contrast with the @NewSpan annotation ,you can also add logs with the log parameter.)

+
+
+

That way, the span gets continued and:

+
+
+
    +
  • +

    Log entries named testMethod11.before and testMethod11.after are created.

    +
    • +
  • +

    If an exception is thrown, a log entry named testMethod11.afterFailure is also created.

    +
    • +
  • +

    A tag with a key of testTag11 and a value of test is created.

    +
    • +
+
+
+
+

10.4. Advanced Tag Setting

+
+

There are 3 different ways to add tags to a span. All of them are controlled by the SpanTag annotation. +The precedence is as follows:

+
+
+
    +
  1. +

    Try with a bean of TagValueResolver type and a provided name.

    +
    2. +
  2. +

    If the bean name has not been provided, try to evaluate an expression. +We search for a TagValueExpressionResolver bean. +The default implementation uses SPEL expression resolution. +IMPORTANT You can only reference properties from the SPEL expression. Method execution is not allowed due to security constraints.

    +
    3. +
  3. +

    If we do not find any expression to evaluate, return the toString() value of the parameter.

    +
    4. +
+
+
+

10.4.1. Custom extractor

+
+

The value of the tag for the following method is computed by an implementation of TagValueResolver interface. +Its class name has to be passed as the value of the resolver attribute.

+
+
+

Consider the following annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForTagValueResolver(
+        @SpanTag(key = "test", resolver = TagValueResolver.class) String test) {
+}
+
+
+
+

Now further consider the following TagValueResolver bean implementation:

+
+
+
+
@Bean(name = "myCustomTagValueResolver")
+public TagValueResolver tagValueResolver() {
+    return parameter -> "Value from myCustomTagValueResolver";
+}
+
+
+
+

The two preceding examples lead to setting a tag value equal to Value from myCustomTagValueResolver.

+
+
+
+

10.4.2. Resolving Expressions for a Value

+
+

Consider the following annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForTagValueExpression(@SpanTag(key = "test",
+        expression = "'hello' + ' characters'") String test) {
+}
+
+
+
+

No custom implementation of a TagValueExpressionResolver leads to evaluation of the SPEL expression, and a tag with a value of 4 characters is set on the span. +If you want to use some other expression resolution mechanism, you can create your own implementation of the bean.

+
+
+
+

10.4.3. Using the toString() method

+
+

Consider the following annotated method:

+
+
+
+
@NewSpan
+public void getAnnotationForArgumentToString(@SpanTag("test") Long param) {
+}
+
+
+
+

Running the preceding method with a value of 15 leads to setting a tag with a String value of "15".

+
+
+
+
+
+
+

11. Customizations

+
+
+

The Tracer object is fully managed by sleuth, so you rarely need to affect it. That said, +Sleuth supports a number of Customizer types, that allow you to configure +anything not already done by Sleuth with auto-configuration or properties.

+
+
+

If you define one of the following as a Bean, Sleuth will invoke it to +customize behaviour:

+
+
+
    +
  • +

    RpcTracingCustomizer - for RPC tagging and sampling policy

    +
    • +
  • +

    HttpTracingCustomizer - for HTTP tagging and sampling policy

    +
    • +
  • +

    MessagingTracingCustomizer - for messaging tagging and sampling policy

    +
    • +
  • +

    CurrentTraceContextCustomizer - to integrate decorators such as correlation.

    +
    • +
  • +

    BaggagePropagationCustomizer - for propagating baggage fields in process and over headers

    +
    • +
  • +

    CorrelationScopeDecoratorCustomizer - for scope decorations such as MDC (logging) field correlation

    +
    • +
+
+
+

11.1. HTTP

+
+

11.1.1. Data Policy

+
+

The default span data policy for HTTP requests is described in Brave: +github.com/openzipkin/brave/tree/master/instrumentation/http#span-data-policy

+
+
+

To add different data to the span, you need to register a bean of type +brave.http.HttpRequestParser or brave.http.HttpResponseParser based on when +the data is collected.

+
+
+

The bean names correspond to the request or response side, and whether it is +a client or server. For example, sleuthHttpClientRequestParser changes what +is collected before a client request is sent to the server.

+
+
+

For your convenience @HttpClientRequestParser, @HttpClientResponseParser +and corresponding server annotations can be used to inject the proper beans +or to reference the bean names via their static String NAME fields.

+
+
+

Here’s an example adding the HTTP url in addition to defaults:

+
+
+
+
@Configuration
+class Config {
+  @Bean(name = { HttpClientRequestParser.NAME, HttpServerRequestParser.NAME })
+  HttpRequestParser sleuthHttpServerRequestParser() {
+      return (req, context, span) -> {
+          HttpRequestParser.DEFAULT.parse(req, context, span);
+          String url = req.url();
+          if (url != null) {
+              span.tag("http.url", url);
+          }
+      };
+  }
+}
+
+
+
+
+

11.1.2. Sampling

+
+

If client /server sampling is required, just register a bean of type +brave.sampler.SamplerFunction<HttpRequest> and name the bean +sleuthHttpClientSampler for client sampler and sleuthHttpServerSampler +for server sampler.

+
+
+

For your convenience the @HttpClientSampler and @HttpServerSampler +annotations can be used to inject the proper beans or to reference the bean +names via their static String NAME fields.

+
+
+

Check out Brave’s code to see an example of how to make a path-based sampler +github.com/openzipkin/brave/tree/master/instrumentation/http#sampling-policy

+
+
+

If you want to completely rewrite the HttpTracing bean you can use the SkipPatternProvider +interface to retrieve the URL Pattern for spans that should be not sampled. Below you can see +an example of usage of SkipPatternProvider inside a server side, Sampler<HttpRequest>.

+
+
+
+
@Configuration
+class Config {
+  @Bean(name = HttpServerSampler.NAME)
+  SamplerFunction<HttpRequest> myHttpSampler(SkipPatternProvider provider) {
+      Pattern pattern = provider.skipPattern();
+      return request -> {
+          String url = request.path();
+          boolean shouldSkip = pattern.matcher(url).matches();
+          if (shouldSkip) {
+              return false;
+          }
+          return null;
+      };
+  }
+}
+
+
+
+
+
+

11.2. TracingFilter

+
+

You can also modify the behavior of the TracingFilter, which is the component that is responsible for processing the input HTTP request and adding tags basing on the HTTP response. +You can customize the tags or modify the response headers by registering your own instance of the TracingFilter bean.

+
+
+

In the following example, we register the TracingFilter bean, add the ZIPKIN-TRACE-ID response header containing the current Span’s trace id, and add a tag with key custom and a value tag to the span.

+
+
+
+
@Component
+@Order(TraceWebServletAutoConfiguration.TRACING_FILTER_ORDER + 1)
+class MyFilter extends GenericFilterBean {
+
+    private final Tracer tracer;
+
+    MyFilter(Tracer tracer) {
+        this.tracer = tracer;
+    }
+
+    @Override
+    public void doFilter(ServletRequest request, ServletResponse response,
+            FilterChain chain) throws IOException, ServletException {
+        Span currentSpan = this.tracer.currentSpan();
+        if (currentSpan == null) {
+            chain.doFilter(request, response);
+            return;
+        }
+        // for readability we're returning trace id in a hex form
+        ((HttpServletResponse) response).addHeader("ZIPKIN-TRACE-ID",
+                currentSpan.context().traceIdString());
+        // we can also add some custom tags
+        currentSpan.tag("custom", "tag");
+        chain.doFilter(request, response);
+    }
+
+}
+
+
+
+
+

11.3. Messaging

+
+

Sleuth automatically configures the MessagingTracing bean which serves as a +foundation for Messaging instrumentation such as Kafka or JMS.

+
+
+

If a customization of producer / consumer sampling of messaging traces is required, +just register a bean of type brave.sampler.SamplerFunction<MessagingRequest> and +name the bean sleuthProducerSampler for producer sampler and sleuthConsumerSampler +for consumer sampler.

+
+
+

For your convenience the @ProducerSampler and @ConsumerSampler +annotations can be used to inject the proper beans or to reference the bean +names via their static String NAME fields.

+
+
+

Ex. Here’s a sampler that traces 100 consumer requests per second, except for +the "alerts" channel. Other requests will use a global rate provided by the +Tracing component.

+
+
+
+
@Configuration
+class Config {
+}
+
+
+
+

For more, see github.com/openzipkin/brave/tree/master/instrumentation/messaging#sampling-policy

+
+
+
+

11.4. RPC

+
+

Sleuth automatically configures the RpcTracing bean which serves as a +foundation for RPC instrumentation such as gRPC or Dubbo.

+
+
+

If a customization of client / server sampling of the RPC traces is required, +just register a bean of type brave.sampler.SamplerFunction<RpcRequest> and +name the bean sleuthRpcClientSampler for client sampler and +sleuthRpcServerSampler for server sampler.

+
+
+

For your convenience the @RpcClientSampler and @RpcServerSampler +annotations can be used to inject the proper beans or to reference the bean +names via their static String NAME fields.

+
+
+

Ex. Here’s a sampler that traces 100 "GetUserToken" server requests per second. +This doesn’t start new traces for requests to the health check service. Other +requests will use the global sampling configuration.

+
+
+
+
@Configuration
+class Config {
+  @Bean(name = RpcServerSampler.NAME)
+  SamplerFunction<RpcRequest> myRpcSampler() {
+      Matcher<RpcRequest> userAuth = and(serviceEquals("users.UserService"),
+              methodEquals("GetUserToken"));
+      return RpcRuleSampler.newBuilder()
+              .putRule(serviceEquals("grpc.health.v1.Health"), Sampler.NEVER_SAMPLE)
+              .putRule(userAuth, RateLimitingSampler.create(100)).build();
+  }
+}
+
+
+
+

For more, see github.com/openzipkin/brave/tree/master/instrumentation/rpc#sampling-policy

+
+
+
+

11.5. Custom service name

+
+

By default, Sleuth assumes that, when you send a span to Zipkin, you want the span’s service name to be equal to the value of the spring.application.name property. +That is not always the case, though. +There are situations in which you want to explicitly provide a different service name for all spans coming from your application. +To achieve that, you can pass the following property to your application to override that value (the example is for a service named myService):

+
+
+
+
spring.zipkin.service.name: myService
+
+
+
+
+

11.6. Customization of Reported Spans

+
+

Before reporting spans (for example, to Zipkin) you may want to modify that span in some way. +You can do so by using the FinishedSpanHandler interface.

+
+
+

In Sleuth, we generate spans with a fixed name. +Some users want to modify the name depending on values of tags. +You can implement the FinishedSpanHandler interface to alter that name.

+
+
+

The following example shows how to register two beans that implement FinishedSpanHandler:

+
+
+
+
@Bean
+FinishedSpanHandler handlerOne() {
+    return new FinishedSpanHandler() {
+        @Override
+        public boolean handle(TraceContext traceContext, MutableSpan span) {
+            span.name("foo");
+            return true; // keep this span
+        }
+    };
+}
+
+@Bean
+FinishedSpanHandler handlerTwo() {
+    return new FinishedSpanHandler() {
+        @Override
+        public boolean handle(TraceContext traceContext, MutableSpan span) {
+            span.name(span.name() + " bar");
+            return true; // keep this span
+        }
+    };
+}
+
+
+
+

The preceding example results in changing the name of the reported span to foo bar, just before it gets reported (for example, to Zipkin).

+
+
+
+

11.7. Host Locator

+
+ + + + + +
+ + +This section is about defining host from service discovery. +It is NOT about finding Zipkin through service discovery. +
+
+
+

To define the host that corresponds to a particular span, we need to resolve the host name and port. +The default approach is to take these values from server properties. +If those are not set, we try to retrieve the host name from the network interfaces.

+
+
+

If you have the discovery client enabled and prefer to retrieve the host address from the registered instance in a service registry, you have to set the spring.zipkin.locator.discovery.enabled property (it is applicable for both HTTP-based and Stream-based span reporting), as follows:

+
+
+
+
spring.zipkin.locator.discovery.enabled: true
+
+
+
+
+
+
+

12. Sending Spans to Zipkin

+
+
+

By default, if you add spring-cloud-starter-zipkin as a dependency to your project, when the span is closed, it is sent to Zipkin over HTTP. +The communication is asynchronous. +You can configure the URL by setting the spring.zipkin.baseUrl property, as follows:

+
+
+
+
spring.zipkin.baseUrl: https://192.168.99.100:9411/
+
+
+
+

If you want to find Zipkin through service discovery, you can pass the Zipkin’s service ID inside the URL, as shown in the following example for zipkinserver service ID:

+
+
+
+
spring.zipkin.baseUrl: https://zipkinserver/
+
+
+
+

To disable this feature just set spring.zipkin.discoveryClientEnabled to `false.

+
+
+

When the Discovery Client feature is enabled, Sleuth uses +LoadBalancerClient to find the URL of the Zipkin Server. It means +that you can set up the load balancing configuration e.g. via Ribbon.

+
+
+
+
zipkinserver:
+  ribbon:
+    ListOfServers: host1,host2
+
+
+
+

If you have web, rabbit, activemq or kafka together on the classpath, you might need to pick the means by which you would like to send spans to zipkin. +To do so, set web, rabbit, activemq or kafka to the spring.zipkin.sender.type property. +The following example shows setting the sender type for web:

+
+
+
+
spring.zipkin.sender.type: web
+
+
+
+

To customize the RestTemplate that sends spans to Zipkin via HTTP, you can register +the ZipkinRestTemplateCustomizer bean.

+
+
+
+
@Configuration
+class MyConfig {
+    @Bean ZipkinRestTemplateCustomizer myCustomizer() {
+        return new ZipkinRestTemplateCustomizer() {
+            @Override
+            void customize(RestTemplate restTemplate) {
+                // customize the RestTemplate
+            }
+        };
+    }
+}
+
+
+
+

If, however, you would like to control the full process of creating the RestTemplate +object, you will have to create a bean of zipkin2.reporter.Sender type.

+
+
+
+
    @Bean Sender myRestTemplateSender(ZipkinProperties zipkin,
+            ZipkinRestTemplateCustomizer zipkinRestTemplateCustomizer) {
+        RestTemplate restTemplate = mySuperCustomRestTemplate();
+        zipkinRestTemplateCustomizer.customize(restTemplate);
+        return myCustomSender(zipkin, restTemplate);
+    }
+
+
+
+
+
+

13. Zipkin Stream Span Consumer

+
+
+ + + + + +
+ + +We recommend using Zipkin’s native support for message-based span sending. +Starting from the Edgware release, the Zipkin Stream server is deprecated. +In the Finchley release, it got removed. +
+
+
+

If for some reason you need to create the deprecated Stream Zipkin server, see the Dalston Documentation.

+
+
+
+
+

14. Integrations

+
+
+

14.1. OpenTracing

+
+

Spring Cloud Sleuth is compatible with OpenTracing. +If you have OpenTracing on the classpath, we automatically register the OpenTracing Tracer bean. +If you wish to disable this, set spring.sleuth.opentracing.enabled to false

+
+
+
+

14.2. Runnable and Callable

+
+

If you wrap your logic in Runnable or Callable, you can wrap those classes in their Sleuth representative, as shown in the following example for Runnable:

+
+
+
+
Runnable runnable = new Runnable() {
+    @Override
+    public void run() {
+        // do some work
+    }
+
+    @Override
+    public String toString() {
+        return "spanNameFromToStringMethod";
+    }
+};
+// Manual `TraceRunnable` creation with explicit "calculateTax" Span name
+Runnable traceRunnable = new TraceRunnable(this.tracing, spanNamer, runnable,
+        "calculateTax");
+// Wrapping `Runnable` with `Tracing`. That way the current span will be available
+// in the thread of `Runnable`
+Runnable traceRunnableFromTracer = this.tracing.currentTraceContext()
+        .wrap(runnable);
+
+
+
+

The following example shows how to do so for Callable:

+
+
+
+
Callable<String> callable = new Callable<String>() {
+    @Override
+    public String call() throws Exception {
+        return someLogic();
+    }
+
+    @Override
+    public String toString() {
+        return "spanNameFromToStringMethod";
+    }
+};
+// Manual `TraceCallable` creation with explicit "calculateTax" Span name
+Callable<String> traceCallable = new TraceCallable<>(this.tracing, spanNamer,
+        callable, "calculateTax");
+// Wrapping `Callable` with `Tracing`. That way the current span will be available
+// in the thread of `Callable`
+Callable<String> traceCallableFromTracer = this.tracing.currentTraceContext()
+        .wrap(callable);
+
+
+
+

That way, you ensure that a new span is created and closed for each execution.

+
+
+
+

14.3. Spring Cloud CircuitBreaker

+
+

If you have Spring Cloud CircuitBreaker on the classpath, we will wrap the passed command Supplier and the fallback Function in its trace representations. In order to disable this instrumentation set spring.sleuth.circuitbreaker.enabled to false.

+
+
+
+

14.4. RxJava

+
+

We registering a custom RxJavaSchedulersHook that wraps all Action0 instances in their Sleuth representative, which is called TraceAction. +The hook either starts or continues a span, depending on whether tracing was already going on before the Action was scheduled. +To disable the custom RxJavaSchedulersHook, set the spring.sleuth.rxjava.schedulers.hook.enabled to false.

+
+
+

You can define a list of regular expressions for thread names for which you do not want spans to be created. +To do so, provide a comma-separated list of regular expressions in the spring.sleuth.rxjava.schedulers.ignoredthreads property.

+
+
+ + + + + +
+ + +The suggest approach to reactive programming and Sleuth is to use +the Reactor support. +
+
+
+
+

14.5. HTTP integration

+
+

Features from this section can be disabled by setting the spring.sleuth.web.enabled property with value equal to false.

+
+
+

14.5.1. HTTP Filter

+
+

Through the TracingFilter, all sampled incoming requests result in creation of a Span. +That Span’s name is http: + the path to which the request was sent. +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.

+
+
+

By default, all the spring boot actuator endpoints are automatically added to the skip pattern. +If you want to disable this behaviour set spring.sleuth.web.ignore-auto-configured-skip-patterns +to true.

+
+
+

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.

+
+
+
+

14.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. +In that case, please file an issue in Spring Cloud Sleuth.

+
+
+
+

14.5.3. Async Servlet support

+
+

If your controller returns a Callable or a WebAsyncTask, Spring Cloud Sleuth continues the existing span instead of creating a new one.

+
+
+
+

14.5.4. WebFlux support

+
+

Through TraceWebFilter, all sampled incoming requests result in creation of a Span. +That Span’s name is http: + the path to which the request was sent. +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.

+
+
+

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

+
+
+
+

14.5.5. Dubbo RPC support

+
+

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

+
+
+
+
<dependency>
+    <groupId>io.zipkin.brave</groupId>
+    <artifactId>brave-instrumentation-dubbo</artifactId>
+</dependency>
+
+
+
+

You need to also set a dubbo.properties file with the following contents:

+
+
+
+
dubbo.provider.filter=tracing
+dubbo.consumer.filter=tracing
+
+
+
+

You can read more about Brave - Dubbo integration here. +An example of Spring Cloud Sleuth and Dubbo can be found here.

+
+
+
+
+

14.6. HTTP Client Integration

+
+

14.6.1. Synchronous Rest Template

+
+

We inject a RestTemplate interceptor to ensure that all the tracing information is passed to the requests. +Each time a call is made, a new Span is created. +It gets closed upon receiving the response. +To block the synchronous RestTemplate features, set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+ + +You have to register RestTemplate as a bean so that the interceptors get injected. +If you create a RestTemplate instance with a new keyword, the instrumentation does NOT work. +
+
+
+
+

14.6.2. Asynchronous Rest Template

+
+ + + + + +
+ + +Starting with Sleuth 2.0.0, we no longer register a bean of AsyncRestTemplate type. +It is up to you to create such a bean. +Then we instrument it. +
+
+
+

To block the AsyncRestTemplate features, set spring.sleuth.web.async.client.enabled to false. +To disable creation of the default TraceAsyncClientHttpRequestFactoryWrapper, set spring.sleuth.web.async.client.factory.enabled +to false. +If you do not want to create AsyncRestClient at all, set spring.sleuth.web.async.client.template.enabled to false.

+
+
+
Multiple Asynchronous Rest Templates
+
+

Sometimes you need to use multiple implementations of the Asynchronous Rest Template. +In the following snippet, you can see an example of how to set up such a custom AsyncRestTemplate:

+
+
+
+
@Configuration
+@EnableAutoConfiguration
+static class Config {
+
+    @Bean(name = "customAsyncRestTemplate")
+    public AsyncRestTemplate traceAsyncRestTemplate() {
+        return new AsyncRestTemplate(asyncClientFactory(),
+                clientHttpRequestFactory());
+    }
+
+    private ClientHttpRequestFactory clientHttpRequestFactory() {
+        ClientHttpRequestFactory clientHttpRequestFactory = new CustomClientHttpRequestFactory();
+        // CUSTOMIZE HERE
+        return clientHttpRequestFactory;
+    }
+
+    private AsyncClientHttpRequestFactory asyncClientFactory() {
+        AsyncClientHttpRequestFactory factory = new CustomAsyncClientHttpRequestFactory();
+        // CUSTOMIZE HERE
+        return factory;
+    }
+
+}
+
+
+
+
+
+

14.6.3. WebClient

+
+

We inject a ExchangeFilterFunction implementation that creates a span and, through on-success and on-error callbacks, takes care of closing client-side spans.

+
+
+

To block this feature, set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+ + +You have to register WebClient as a bean so that the tracing instrumentation gets applied. +If you create a WebClient instance with a new keyword, the instrumentation does NOT work. +
+
+
+
+

14.6.4. Traverson

+
+

If you use the Traverson library, you can inject a RestTemplate as a bean into your Traverson object. +Since RestTemplate is already intercepted, you get full support for tracing in your client. The following pseudo code +shows how to do that:

+
+
+
+
@Autowired RestTemplate restTemplate;
+
+Traverson traverson = new Traverson(URI.create("https://some/address"),
+    MediaType.APPLICATION_JSON, MediaType.APPLICATION_JSON_UTF8).setRestOperations(restTemplate);
+// use Traverson
+
+
+
+
+

14.6.5. Apache HttpClientBuilder and HttpAsyncClientBuilder

+
+

We instrument the HttpClientBuilder and HttpAsyncClientBuilder so that +tracing context gets injected to the sent requests.

+
+
+

To block these features, set spring.sleuth.web.client.enabled to false.

+
+
+
+

14.6.6. Netty HttpClient

+
+

We instrument the Netty’s HttpClient.

+
+
+

To block this feature, set spring.sleuth.web.client.enabled to false.

+
+
+ + + + + +
+ + +You have to register HttpClient as a bean so that the instrumentation happens. +If you create a HttpClient instance with a new keyword, the instrumentation does NOT work. +
+
+
+
+

14.6.7. UserInfoRestTemplateCustomizer

+
+

We instrument the Spring Security’s UserInfoRestTemplateCustomizer.

+
+
+

To block this feature, set spring.sleuth.web.client.enabled to false.

+
+
+
+
+

14.7. Feign

+
+

By default, Spring Cloud Sleuth provides integration with Feign through TraceFeignClientAutoConfiguration. +You can disable it entirely by setting spring.sleuth.feign.enabled to false. +If you do so, no Feign-related instrumentation take place.

+
+
+

Part of Feign instrumentation is done through a FeignBeanPostProcessor. +You can disable it by setting spring.sleuth.feign.processor.enabled to false. +If you set it to false, Spring Cloud Sleuth does not instrument any of your custom Feign components. +However, all the default instrumentation is still there.

+
+
+
+

14.8. gRPC

+
+

Spring Cloud Sleuth provides instrumentation for gRPC through TraceGrpcAutoConfiguration. You can disable it entirely by setting spring.sleuth.grpc.enabled to false.

+
+
+

14.8.1. Variant 1

+
+
Dependencies
+
+ + + + + +
+ + +The gRPC integration relies on two external libraries to instrument clients and servers and both of those libraries must be on the class path to enable the instrumentation. +
+
+
+

Maven:

+
+
+
+
        <dependency>
+            <groupId>io.github.lognet</groupId>
+            <artifactId>grpc-spring-boot-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.zipkin.brave</groupId>
+            <artifactId>brave-instrumentation-grpc</artifactId>
+        </dependency>
+
+
+
+

Gradle:

+
+
+
+
    compile("io.github.lognet:grpc-spring-boot-starter")
+    compile("io.zipkin.brave:brave-instrumentation-grpc")
+
+
+
+
+
Server Instrumentation
+
+

Spring Cloud Sleuth leverages grpc-spring-boot-starter to register Brave’s gRPC server interceptor with all services annotated with @GRpcService.

+
+
+
+
Client Instrumentation
+
+

gRPC clients leverage a ManagedChannelBuilder to construct a ManagedChannel used to communicate to the gRPC server. The native ManagedChannelBuilder provides static methods as entry points for construction of ManagedChannel instances, however, this mechanism is outside the influence of the Spring application context.

+
+
+ + + + + +
+ + +Spring Cloud Sleuth provides a SpringAwareManagedChannelBuilder that can be customized through the Spring application context and injected by gRPC clients. This builder must be used when creating ManagedChannel instances. +
+
+
+

Sleuth creates a TracingManagedChannelBuilderCustomizer which inject Brave’s client interceptor into the SpringAwareManagedChannelBuilder.

+
+
+
+
+

14.8.2. Variant 2

+
+

Grpc Spring Boot Starter automatically detects the presence of Spring Cloud Sleuth and brave’s instrumentation for gRPC and registers the necessary client and/or server tooling.

+
+
+
+
+

14.9. Asynchronous Communication

+
+

14.9.1. @Async Annotated methods

+
+

In Spring Cloud Sleuth, we instrument async-related components so that the tracing information is passed between threads. +You can disable this behavior by setting the value of spring.sleuth.async.enabled to false.

+
+
+

If you annotate your method with @Async, we automatically create a new Span with the following characteristics:

+
+
+
    +
  • +

    If the method is annotated with @SpanName, the value of the annotation is the Span’s name.

    +
    • +
  • +

    If the method is not annotated with @SpanName, the Span name is the annotated method name.

    +
    • +
  • +

    The span is tagged with the method’s class name and method name.

    +
    • +
+
+
+
+

14.9.2. @Scheduled Annotated Methods

+
+

In Spring Cloud Sleuth, we instrument scheduled method execution so that the tracing information is passed between threads. +You can disable this behavior by setting the value of spring.sleuth.scheduled.enabled to false.

+
+
+

If you annotate your method with @Scheduled, we automatically create a new span with the following characteristics:

+
+
+
    +
  • +

    The span name is the annotated method name.

    +
    • +
  • +

    The span is tagged with the method’s class name and method name.

    +
    • +
+
+
+

If you want to skip span creation for some @Scheduled annotated classes, you can set the spring.sleuth.scheduled.skipPattern with a regular expression that matches the fully qualified name of the @Scheduled annotated class.

+
+
+
+

14.9.3. Executor, ExecutorService, and ScheduledExecutorService

+
+

We provide LazyTraceExecutor, TraceableExecutorService, and TraceableScheduledExecutorService. Those implementations create spans each time a new task is submitted, invoked, or scheduled.

+
+
+

The following example shows how to pass tracing information with TraceableExecutorService when working with CompletableFuture:

+
+
+
+
CompletableFuture<Long> completableFuture = CompletableFuture.supplyAsync(() -> {
+    // perform some logic
+    return 1_000_000L;
+}, new TraceableExecutorService(beanFactory, executorService,
+        // 'calculateTax' explicitly names the span - this param is optional
+        "calculateTax"));
+
+
+
+ + + + + +
+ + +Sleuth does not work with parallelStream() out of the box. +If you want to have the tracing information propagated through the stream, you have to use the approach with supplyAsync(...), as shown earlier. +
+
+
+

If there are beans that implement the Executor interface that you would like +to exclude from span creation, you can use the spring.sleuth.async.ignored-beans +property where you can provide a list of bean names.

+
+
+
Customization of Executors
+
+

Sometimes, you need to set up a custom instance of the AsyncExecutor. +The following example shows how to set up such a custom Executor:

+
+
+
+
@Configuration
+@EnableAutoConfiguration
+@EnableAsync
+// add the infrastructure role to ensure that the bean gets auto-proxied
+@Role(BeanDefinition.ROLE_INFRASTRUCTURE)
+static class CustomExecutorConfig extends AsyncConfigurerSupport {
+
+    @Autowired
+    BeanFactory beanFactory;
+
+    @Override
+    public Executor getAsyncExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        // CUSTOMIZE HERE
+        executor.setCorePoolSize(7);
+        executor.setMaxPoolSize(42);
+        executor.setQueueCapacity(11);
+        executor.setThreadNamePrefix("MyExecutor-");
+        // DON'T FORGET TO INITIALIZE
+        executor.initialize();
+        return new LazyTraceExecutor(this.beanFactory, executor);
+    }
+
+}
+
+
+
+ + + + + +
+ + +To ensure that your configuration gets post processed, remember +to add the @Role(BeanDefinition.ROLE_INFRASTRUCTURE) on your +@Configuration class +
+
+
+
+
+
+

14.10. Messaging

+
+

Features from this section can be disabled by setting the spring.sleuth.messaging.enabled property with value equal to false.

+
+
+

14.10.1. Spring Integration and Spring Cloud Stream

+
+

Spring Cloud Sleuth integrates with Spring Integration. +It creates spans for publish and subscribe events. +To disable Spring Integration instrumentation, set spring.sleuth.integration.enabled to false.

+
+
+

You can provide the spring.sleuth.integration.patterns pattern to explicitly provide the names of channels that you want to include for tracing. +By default, all channels but hystrixStreamOutput channel are included.

+
+
+ + + + + +
+ + +When using the Executor to build a Spring Integration IntegrationFlow, you must use the untraced version of the Executor. +Decorating the Spring Integration Executor Channel with TraceableExecutorService causes the spans to be improperly closed. +
+
+
+

If you want to customize the way tracing context is read from and written to message headers, +it’s enough for you to register beans of types:

+
+
+
    +
  • +

    Propagation.Setter<MessageHeaderAccessor, String> - for writing headers to the message

    +
    • +
  • +

    Propagation.Getter<MessageHeaderAccessor, String> - for reading headers from the message

    +
    • +
+
+
+
+

14.10.2. Spring RabbitMq

+
+

We instrument the RabbitTemplate so that tracing headers get injected +into the message.

+
+
+

To block this feature, set spring.sleuth.messaging.rabbit.enabled to false.

+
+
+
+

14.10.3. Spring Kafka

+
+

We instrument the Spring Kafka’s ProducerFactory and ConsumerFactory +so that tracing headers get injected into the created Spring Kafka’s +Producer and Consumer.

+
+
+

To block this feature, set spring.sleuth.messaging.kafka.enabled to false.

+
+
+
+

14.10.4. Spring Kafka Streams

+
+

We instrument the KafkaStreams KafkaClientSupplier so that tracing headers +get injected into the Producer and Consumer`s. A `KafkaStreamsTracing bean +allows for further instrumentation through additional TransformerSupplier and +ProcessorSupplier methods.

+
+
+

To block this feature, set spring.sleuth.messaging.kafka.streams.enabled to false.

+
+
+
+

14.10.5. Spring JMS

+
+

We instrument the JmsTemplate so that tracing headers get injected +into the message. We also support @JmsListener annotated methods on the consumer side.

+
+
+

To block this feature, set spring.sleuth.messaging.jms.enabled to false.

+
+
+ + + + + +
+ + +We don’t support baggage propagation for JMS +
+
+
+
+

14.10.6. Spring Cloud AWS Messaging SQS

+
+

We instrument @SqsListener which is provided by org.springframework.cloud:spring-cloud-aws-messaging +so that tracing headers get extracted from the message and a trace gets put into the context.

+
+
+

To block this feature, set spring.sleuth.messaging.sqs.enabled to false.

+
+
+
+
+

14.11. Redis

+
+

We set tracing property to Lettcue ClientResources instance to enable Brave tracing built in Lettuce . +To disable Redis support, set the spring.sleuth.redis.enabled property to false.

+
+
+
+

14.12. Quartz

+
+

We instrument quartz jobs by adding Job/Trigger listeners to the Quartz Scheduler.

+
+
+

To turn off this feature, set the spring.sleuth.quartz.enabled property to false.

+
+
+
+

14.13. Project Reactor

+
+

For projects depending on Project Reactor such as Spring Cloud Gateway, we suggest turning the spring.sleuth.reactor.decorate-on-each option to false. That way an increased performance gain should be observed in comparison to the standard instrumentation mechanism. What this option does is it will wrap decorate onLast operator instead of onEach which will result in creation of far fewer objects. The downside of this is that when Project Reactor will change threads, the trace propagation will continue without issues, however anything relying on the ThreadLocal such as e.g. MDC entries can be buggy.

+
+
+
+
+
+

15. Configuration properties

+
+
+

To see the list of all Sleuth related configuration properties please check the Appendix page.

+
+
+
+
+

16. Running examples

+
+
+

You can see the running examples deployed in the Pivotal Web Services. +Check them out at the following links:

+
+
+ +
+
+
+
+ + + + + + + \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/css/spring.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/css/spring.css new file mode 100644 index 00000000..ca64edd5 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/css/spring.css @@ -0,0 +1 @@ +@import url("https://fonts.googleapis.com/css?family=Open+Sans:400,700&display=swap");/*! normalize.css v2.1.2 | MIT License | git.io/normalize */article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html,body{font-size:100%}html{font-family:'Open Sans', sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}*,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body{background:white;color:#000;padding:0;margin:0;font-size:16px;font-family:'Open Sans', sans-serif;font-weight:normal;font-style:normal;line-height:1.6em;position:relative;cursor:auto}a:hover{cursor:pointer}img,object,embed{max-width:100%;height:auto}object,embed{height:100%}img{-ms-interpolation-mode:bicubic}#map_canvas img,#map_canvas embed,#map_canvas object,.map_canvas img,.map_canvas embed,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}.antialiased{-webkit-font-smoothing:antialiased}img{display:inline-block;vertical-align:middle}textarea{height:auto;min-height:50px}select{width:100%}object,svg{display:inline-block;vertical-align:middle}.center{margin-left:auto;margin-right:auto}.spread,.stretch{width:100%}p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{line-height:1.6}.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#0b0a0a;font-weight:bold;margin-top:0;margin-bottom:0.8em}div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}a{color:#086dc3;line-height:inherit;text-decoration:none}a:hover,a:focus{color:#086dc3;text-decoration:underline}a img{border:none}p{font-family:inherit;font-weight:normal;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}p aside{font-size:0.875em;line-height:1.35;font-style:italic}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:Montserrat, sans-serif;font-weight:400;font-style:normal;color:#000;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:0.5em;line-height:1.0125em}h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#867c74;line-height:0}h1{font-size:2.125em}h2{font-size:1.6875em}h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}h4{font-size:1.125em}h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #dce6e6;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic;line-height:inherit}strong,b{font-weight:bold;line-height:inherit}small{font-size:60%;line-height:inherit}code{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-weight:normal;color:#3d3d3c;word-break:break-word}a:not(pre)>code{border:1px solid #086dc3;color:#086dc3}ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}ul,ol{margin-left:1.5em}ul.no-bullet,ol.no-bullet{margin-left:1.5em}ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}ul.no-bullet{list-style:none}ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}dl dt{margin-bottom:0.3125em;font-weight:bold}dl dd{margin-bottom:1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#000;border-bottom:1px dotted #dddddd;cursor:help}abbr{text-transform:none}blockquote{margin:0 0 1.25em;padding:0.5625em 1.25em 0 1.1875em;border-left:1px solid #dddddd}blockquote cite{display:block;font-size:0.9375em;color:rgba(0,0,0,0.6)}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,0.6)}blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,0.85)}.vcard{display:inline-block;margin:0 0 1.25em 0;border:1px solid #dddddd;padding:0.625em 0.75em}.vcard li{margin:0;display:block}.vcard .fn{font-weight:bold;font-size:0.9375em}.vevent .summary{font-weight:bold}.vevent abbr{cursor:auto;text-decoration:none;font-weight:bold;border:none;padding:0 0.0625em}#tocbot{padding:0 0 0.5rem 0;line-height:1.5rem;padding-left:10px}.mobile-toc{padding:0 0 1rem 0;line-height:1.5rem}.mobile-toc li a{display:block;padding:.3rem 0}#tocbot ol li{list-style:none;padding:0;margin:0}#tocbot ol{margin:0;padding:0}#tocbot ol ol{padding-left:0.6rem}#tocbot .toc-link{display:block;padding-top:.6rem;padding-bottom:.6rem;outline:none;border-radius:4px;font-size:15px;transition:all .15s}#tocbot .toc-link:hover{background:#ebf2f2;color:#06c;text-decoration:none}table{background:white;margin-bottom:1.25em;border:solid 1px #d4dfdf;border-spacing:0}table thead,table tfoot{background:#ebf2f2;font-weight:bold}table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:0.5em 0.625em 0.625em;font-size:inherit;color:#000;text-align:left}table tr th,table tr td{padding:0.5625em 0.625em;font-size:inherit;color:#000}table tr.even,table tr.alt,table tr:nth-child(even){background:#f5f9f9}table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}body{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;tab-size:4}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-0.05em}.clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}.clearfix:after,.float-group:after{clear:both}*:not(pre)>code{white-space:nowrap;background-color:#fff;border:1px solid #e1e1e8;color:#009;padding:2px 6px;font-size:.875rem;font-family:Monaco, Menlo, Consolas, "Courier New", monospace}pre,pre>code{line-height:1.85;color:rgba(0,0,0,0.9);font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-weight:normal;text-rendering:optimizeSpeed;word-break:normal}pre{overflow:auto}em em{font-style:normal}strong strong{font-weight:normal}.keyseq{color:#6b625c}kbd{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;display:inline-block;color:#000;font-size:0.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 0.1em white inset;box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 0.1em white inset;margin:0 0.15em;padding:0.2em 0.5em;vertical-align:middle;position:relative;top:-0.1em;white-space:nowrap}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menuseq,.menu{color:#191715}b.button:before,b.button:after{position:relative;top:-1px;font-weight:normal}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}p a>code:hover{color:rgba(0,0,0,0.9)}#toc{border-bottom:1px solid #dce6e6;padding-bottom:0.5em}#toc>ul{margin-left:0.125em}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0.5em 0}#toc ul{list-style-type:none}#toc li{line-height:1.3334}#toc a{text-decoration:none}#toc a:active{text-decoration:underline}#toctitle{color:#0b0a0a;font-size:1.2em;display:none}body.toc2{padding-top:80px;text-rendering:optimizeLegibility}#content #toc{border-style:solid;border-width:1px;border-color:#dce6e6;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;-webkit-border-radius:4px;border-radius:4px}#content #toc>:first-child{margin-top:0}#content #toc>:last-child{margin-bottom:0}#footer{padding-bottom:2rem}#footer #footer-text{padding:2rem 0;border-top:1px solid #efefed}#footer-text{color:rgba(0,0,0,0.6);line-height:1.44}.sect1{padding-bottom:0.625em}.sect1+.sect1{border-top:1px solid #efefed}#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;margin-top:0.1rem;display:block;visibility:hidden;text-align:center;font-weight:normal;color:rgba(0,0,0,0.2)}#content h1>a.anchor:hover,h2>a.anchor:hover,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4>a.anchor:hover,h5>a.anchor:hover,h6>a.anchor:hover{color:#097dff;text-decoration:none}#content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\0023";font-size:0.85em;display:block;padding-top:0.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#000;text-decoration:none}#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#262321}.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:'Open Sans', sans-serif;font-size:1rem}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0;padding:0.6rem 0}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}.admonitionblock>table td.icon{text-align:center;vertical-align:top;padding-top:0.8em;width:80px}.admonitionblock>table td.icon img{max-width:initial}.admonitionblock>table td.icon .title{font-weight:bold;font-family:Montserrat, sans-serif;text-transform:uppercase}.admonitionblock>table td.content{padding-left:0em;padding-right:1.25em;border-left:1px solid #dce6e6}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:0;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#f1f1f1;border-radius:4px}.exampleblock>.content>:first-child{margin-top:0}.exampleblock>.content>:last-child{margin-bottom:0}.sidebarblock{border-style:solid;border-width:0;border-color:#dce6e6;margin-bottom:1.25em;padding:1.25em;background:#ebf2f2;border-radius:4px;overflow:scroll}.sidebarblock>:first-child{margin-top:0}.sidebarblock>:last-child{margin-bottom:0}.sidebarblock>.content>.title{color:#0b0a0a;margin-top:0;text-align:center}.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}.literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#fff;border:1px solid #d9d9d9;border-radius:4px}.sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#fff;border:1px solid #d9d9d9;color:#222}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class],.listingblock pre:not(.highlight){padding:1em 1.5rem;font-size:0.8125em}.literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto}.literalblock.output pre{color:whitesmoke;background-color:rgba(0,0,0,0.9)}.listingblock{white-space:nowrap}.listingblock pre.highlightjs>code{padding:1em 1.5rem;border-radius:4px}.listingblock>.content{position:relative}.listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:0.8em;font-weight:bold;top:0.425rem;right:0.5rem;line-height:1;text-transform:uppercase;color:#999}.listingblock code[data-lang]:before{display:block}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:0.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #dce6e6}pre.pygments .lineno{display:block;margin-right:.25em}table.pyhltable .linenodiv{background:none !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:block;text-align:left;padding-left:20px}.quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,0.85);line-height:1.75;letter-spacing:0}.quoteblock blockquote{margin:0;padding:0;border:0;position:relative}.quoteblock blockquote:before{content:"\201c";font-size:2.75em;font-weight:bold;line-height:0.6em;margin-left:0em;margin-right:1rem;margin-top:0.8rem;color:rgba(0,0,0,0.1);position:absolute;top:0;left:-30px}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-right:0.5ex}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:0.5em 0;border-left:3px solid rgba(0,0,0,0.6)}.quoteblock .quoteblock blockquote{padding:0 0 0 0.75em}.quoteblock .quoteblock blockquote:before{display:none}.verseblock{margin:0 1em 1.25em 0;background-color:#f1f1f1;padding:1rem 1.4rem;border-radius:4px}.verseblock pre{font-family:Monaco, Menlo, Consolas, "Courier New", monospace;font-size:0.9rem;color:rgba(0,0,0,0.85);font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:0.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:0.9375em;line-height:1.45;font-style:italic}.quoteblock .attribution br,.verseblock .attribution br{display:none}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-0.025em;color:rgba(0,0,0,0.6)}.quoteblock.abstract{margin:0 0 1.25em 0;display:block}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}table.tableblock{max-width:100%;border-collapse:separate;overflow-x:scroll}table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}table.tableblock,th.tableblock,td.tableblock{border:0 solid #d4dfdf}table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}th.halign-left,td.halign-left{text-align:left}th.halign-right,td.halign-right{text-align:right}th.halign-center,td.halign-center{text-align:center}th.valign-top,td.valign-top{vertical-align:top}th.valign-bottom,td.valign-bottom{vertical-align:bottom}th.valign-middle,td.valign-middle{vertical-align:middle}table thead th,table tfoot th{font-weight:bold}tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#34302d;font-weight:bold}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:0.625em}ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}ul.unstyled,ol.unnumbered,ul.checklist{margin-left:0.625em}ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1em;font-size:0.85em}ul.checklist li>p:first-child>input[type="checkbox"]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 auto 0.625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}ul.inline>li>*{display:block}.unstyled dl dt{font-weight:normal;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.hdlist>table,.colist>table{border:0;background:none}.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 0.625em}td.hdlist1{font-weight:bold;padding-bottom:1.25em}.literalblock+.colist,.listingblock+.colist{margin-top:-0.5em}.colist>table tr>td:first-of-type{padding:0 0.75em;line-height:1}.colist>table tr>td:first-of-type img{max-width:initial}.colist>table tr>td:last-of-type{padding:0.25em 0}.colist>table tr>td{white-space:pre-wrap}.thumb,.th{line-height:0;display:inline-block;border:solid 4px white;-webkit-box-shadow:0 0 0 1px #dddddd;box-shadow:0 0 0 1px #dddddd}.imageblock.left,.imageblock[style*="float: left"]{margin:0.25em 0.625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:0.25em 0 1.25em 0.625em}.imageblock>.title{margin-bottom:0}.imageblock.thumb,.imageblock.th{border-width:6px}.imageblock.thumb>.title,.imageblock.th>.title{padding:0 0.125em}.image.left,.image.right{margin-top:0.25em;margin-bottom:0.25em;display:inline-block;line-height:0}.image.left{margin-right:0.625em}.image.right{margin-left:0.625em}a.image{text-decoration:none;display:inline-block}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:0.875em;position:static;vertical-align:super}sup.footnote a,sup.footnoteref a{text-decoration:none}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:0.75em;padding-bottom:0.75em;margin-bottom:0.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-0.25em 0 0.75em 0;border-width:1px 0 0 0}#footnotes .footnote{padding:0 0.375em 0 0.225em;line-height:1.3334;font-size:0.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:0.2em}#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-0.625em;margin-bottom:0;padding:0.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:black}.black-background{background-color:black}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#f5f9f9}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;cursor:default}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#3f6a22}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";color:#0077b9}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#d88400}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value]{display:inline-block;color:#000 !important;background-color:#ffe157;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:0.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:bold}.conum[data-value] *{color:#fff !important}.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:0;color:#000 !important;background-color:#ffe157;font-size:12px}b.conum *{color:inherit !important}.conum:not([data-value]):empty{display:none}.admonitionblock{background-color:#ecf1e8;padding:0.8em 0;margin:30px 0;width:auto;border-radius:4px;overflow-x:auto}.admonitionblock.important{border-left:0px solid #e20000;background-color:#f9ebeb}.admonitionblock.warning{border-left:0px solid #d88400;background-color:#fff9e4}.admonitionblock.tip{border-left:0px solid #0077b9;background-color:#e9f1f6}.admonitionblock.caution{border-left:0px solid #e20000;background-color:#f9ebeb}.admonitionblock .exampleblock>.content{border:0 none;background-color:#fff}#toc a:hover{text-decoration:underline}.admonitionblock>table{margin-bottom:0}.admonitionblock>table td.content{border-left:none}@media print{#tocbot a.toc-link.node-name--H4{display:none}}.is-collapsible{max-height:1000px;overflow:hidden;transition:all 200ms ease-in-out}.is-collapsed{max-height:0}#index-link{display:none}ul li>p>a>code{color:#086dc3}ul li>p>a:hover>code{color:#086dc3}#content .listingblock .switch{border-style:none;display:inline-block;position:relative;bottom:0;margin-bottom:4px}#content .listingblock .switch--item:not(:first-child){border:2px solid #000}#content .listingblock .switch--item{padding:6px 12px;background-color:#fff;color:#000;display:inline-block;cursor:pointer;border:2px solid #000;margin-right:2px;border-radius:0}#content .listingblock .switch--item:hover{color:#086dc3}#content .listingblock .switch--item.selected{background-color:#000;color:#fff;border-color:#000}#content .listingblock .switch--item.selected:hover{color:#fff}#content .listingblock pre.highlightjs{padding:0}div.back-action,#toc.toc2 div.back-action{padding:0.8rem 0 0 5px}div.back-action a,#toc.toc2 div.back-action a{position:relative;display:inline-block;padding:0.6rem 1.2rem;padding-left:35px}div.back-action a span,#toc.toc2 div.back-action a span{position:absolute;left:5px;top:5px;display:block;color:#333;height:26px;width:26px;border-radius:13px}div.back-action a i,#toc.toc2 div.back-action a i{position:absolute;top:10px;left:5px}div.back-action a:hover span,#toc.toc2 div.back-action a:hover span{color:#000}#tocbot.desktop-toc{padding:.5rem}#header-spring{position:absolute;text-rendering:optimizeLegibility;top:0;left:0;right:0;height:80px;margin:0 1rem;padding:0 1rem;border-bottom:1px solid #dce6e6}#header-spring h1{margin:0;padding:0;font-size:22px;text-align:left;line-height:76px;padding-left:0.6rem}#header-spring h1 svg{width:240px}#header-spring h1 svg .st0{fill:#6bb536}#header-spring h1 svg .st2{fill:#444}body.book #header-spring{position:relative;top:auto;left:auto;right:auto;margin:0}body.book #header>h1:only-child{border:0 none;padding-bottom:1.2rem;font-size:1.8rem}body.book #header,body.book #content,body.book #footnotes,body.book #footer{margin:0 auto}body.toc2 #header-spring{position:absolute;left:0;right:0;top:0}body.toc2 #header>h1:only-child{font-size:2.2rem}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{margin:0 auto}body.toc2 #content{padding-top:2rem}#header,#content,#footnotes,#footer{width:100%;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:0.9375em;padding-right:0.9375em}#header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}#header:after,#content:after,#footnotes:after,#footer:after{clear:both}#content{margin-top:1.25em}#content:before{content:none}#header{position:relative}#header>h1:first-child{margin-top:2.55rem;margin-bottom:0.5em;margin-bottom:0.7em;font-size:2rem}#header>h1:first-child+#toc{margin-top:8px;border-top:0 none}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ebf2f2;padding-bottom:8px}#header .details{line-height:1.45;color:#222;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap;background-color:#ebf2f2;padding:2rem 2.5rem}#header .details span:first-child{margin-left:-0.125em}#header .details span.email a{color:rgba(0,0,0,0.85)}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,0.85)}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:rgba(0,0,0,0.85);border-bottom:1px solid #ebf2f2;padding-bottom:8px;margin-top:0;padding-top:1.5rem;margin-bottom:1.25rem}h1{font-size:2.2rem}h1,h2,h3,h4,h5,h6{font-weight:bold;font-family:Montserrat, Arial, Helvetica, sans-serif}h1:focus,h2:focus,h3:focus,h4:focus,h5:focus,h6:focus{box-shadow:none;outline:none}h2,h3,h4,h5,h6{padding:.8rem 0 .4rem}h1{font-size:1.75em}h2{font-size:1.6rem}h3{font-size:1.5rem}h4{font-size:1.4rem}h5{font-size:1.3rem}h6{font-size:1.2rem}pre.highlight{padding:20px;border:1px solid #d9d9d9;overflow-x:scroll;color:#222}pre.highlight code{color:#222}pre.highlight a,#toc.toc2 a{color:#000}pre.highlight ul.sectlevel1,#toc.toc2 ul.sectlevel1{padding-left:0.2rem}pre.highlight ul.sectlevel1 li,#toc.toc2 ul.sectlevel1 li{line-height:1.4rem}::selection{background-color:#d1ff79}.literalblock pre::selection,.listingblock pre[class="highlight"]::selection,.highlight::selection,pre::selection,.highlight code::selection,.highlight code span::selection{background:rgba(0,0,0,0.2) !important}body.book #header{margin-bottom:2rem}body.toc2 #header{margin-bottom:0}.desktop-toc{display:none}.admonitionblock td.icon{display:none}.admonitionblock>table td.content{padding-left:1.25em}@media only screen and (min-width: 768px){#toctitle{font-size:1.375em}.sect1{padding-bottom:1.25em}.mobile-toc{display:none}.desktop-toc{display:block}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:0.90625em}.admonitionblock td.icon{display:table-cell}.admonitionblock>table td.content{padding-left:0}#header{position:relative;min-height:98px;padding-right:210px}#header::after{position:absolute;right:0;top:0;display:block;content:'';height:98px;width:203px;z-index:-1;background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAmIAAAEmCAIAAABOFWtWAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ODRBOEI2NUE1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6ODRBOEI2NUI1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo4NEE4QjY1ODUwQjUxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo4NEE4QjY1OTUwQjUxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PooJeGcAAB/mSURBVHja7N15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");background-repeat:no-repeat;background-size:203px 98px}body.toc2{padding-right:0}body.toc2 #toc.toc2{position:absolute;margin-top:0 !important;width:15em;top:0;border-top-width:0 !important;border-bottom-width:0 !important;margin-left:-15.9375em;z-index:1000;padding:0 1em 1.25em 0em;overflow:auto}body.toc2 #toc.toc2 #toctitle{margin-top:0;margin-bottom:0.8rem;font-size:1.2em}body.toc2 #toc.toc2>ul{font-size:0.9em;margin-bottom:0}body.toc2 #toc.toc2 ul ul{margin-left:0;padding-left:1em}body.toc2 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:0.5em;margin-bottom:0.5em}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{padding-left:15.9375em;max-width:none}body.book #header-spring h1{max-width:1400px;margin:0 auto}body.book #header,body.book #content,body.book #footnotes,body.book #footer{max-width:1400px}body.is-position-fixed #toc.toc2{position:fixed;height:100%}h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}h1{font-size:1.75em}h2{font-size:1.6em}h3,#toctitle,.sidebarblock>.content>.title{font-size:1.5em}h4{font-size:1.4em}h5{font-size:1.2em}h6{font-size:1.2em}#tocbot a.toc-link.node-name--H1{font-style:italic}#tocbot ol{margin:0;padding:0}#tocbot ol li{list-style:none;padding:0 0;margin:0;display:block}#tocbot{z-index:999}#tocbot .toc-link{position:relative;display:block;z-index:999;padding:.4rem .6rem}#tocbot a.is-active-link{padding-right:3px;background:black;color:white}}@media only screen and (min-width: 768px){#tocbot>ul.toc-list{margin-bottom:0.5em;margin-left:0.125em}#tocbot ul.sectlevel0,#tocbot a.toc-link.node-name--H1+ul{padding-left:0}#tocbot a.toc-link{height:100%}.is-collapsible{max-height:3000px;overflow:hidden}.is-collapsed{max-height:0}}@media only screen and (min-width: 768px){body.toc2 #header,body.toc2 #content,body.toc2 #footer{background-repeat:repeat-y;background-position:14em 0;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAMAAAAoyzS7AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyhpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQwIDc5LjE2MDQ1MSwgMjAxNy8wNS8wNi0wMTowODoyMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTggKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6RDE0NUNENzNGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6RDE0NUNENzRGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpEMTQ1Q0Q3MUYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpEMTQ1Q0Q3MkYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjmGxxYAAAAGUExURd3d2AAAAJlCnKAAAAAMSURBVHjaYmAACDAAAAIAAU9tWeEAAAAASUVORK5CYII=);background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6NDMyRDZERkQ1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6NDMyRDZERkU1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGQjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkRGQzUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjdyLKIAAAAPSURBVHjaYnj16RNAgAEABZgCz/xXiToAAAAASUVORK5CYII=");background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ODRBOEI2NTI1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6ODRBOEI2NTM1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGRjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkUwMDUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/Pul87iAAAAAPSURBVHjaYrj17BlAgAEABUQCpxgONc4AAAAASUVORK5CYII=")}}@media only screen and (min-width: 1280px){body.toc2{padding-right:0}body.toc2 #toc.toc2{width:25em;left:auto;margin-left:-26.9375em}body.toc2 #toc.toc2 #toctitle{font-size:1.375em}body.toc2 #toc.toc2>ul{font-size:0.95em}body.toc2 #toc.toc2 ul ul{padding-left:1.25em}body.toc2 body.toc2.toc-right{padding-left:0;padding-right:20em}body.toc2 #header,body.toc2 #content,body.toc2 #footnotes,body.toc2 #footer{padding-left:26.9375em;max-width:2000px}body.toc2 #header-spring h1{margin:0 auto;max-width:2000px}.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:0.8125em}body.toc2 #header,body.toc2 #content,body.toc2 #footer{background-repeat:repeat-y;background-position:24em 0;background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAMAAAAoyzS7AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyhpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQwIDc5LjE2MDQ1MSwgMjAxNy8wNS8wNi0wMTowODoyMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTggKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6RDE0NUNENzNGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6RDE0NUNENzRGMTVGMTFFODk5RjI5ODk3QURGRjcxMkEiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpEMTQ1Q0Q3MUYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpEMTQ1Q0Q3MkYxNUYxMUU4OTlGMjk4OTdBREZGNzEyQSIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjmGxxYAAAAGUExURd3d2AAAAJlCnKAAAAAMSURBVHjaYmAACDAAAAIAAU9tWeEAAAAASUVORK5CYII=);background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6NDMyRDZERkQ1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6NDMyRDZERkU1MEE4MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGQjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkRGQzUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PjdyLKIAAAAPSURBVHjaYnj16RNAgAEABZgCz/xXiToAAAAASUVORK5CYII=");background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyVpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMTQ4IDc5LjE2NDAzNiwgMjAxOS8wOC8xMy0wMTowNjo1NyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ODRBOEI2NTI1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6ODRBOEI2NTM1MEI1MTFFQTlCNTJBOEQwQTM2ODZEQjgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo0MzJENkRGRjUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo0MzJENkUwMDUwQTgxMUVBOUI1MkE4RDBBMzY4NkRCOCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/Pul87iAAAAAPSURBVHjaYrj17BlAgAEABUQCpxgONc4AAAAASUVORK5CYII=")}#header{min-height:150px;padding-right:310px}#header::after{height:147px;width:305px;background-size:305px 147px}} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/favicon.ico b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/favicon.ico new file mode 100644 index 00000000..1a4956e6 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/favicon.ico differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/.gitkeep b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/.gitkeep new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/.gitkeep @@ -0,0 +1 @@ + diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/kibana.png b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/kibana.png new file mode 100644 index 00000000..571e7afe Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/kibana.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-dependencies.png b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-dependencies.png new file mode 100644 index 00000000..ae09dafe Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-dependencies.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-trace-screenshot.png b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-trace-screenshot.png new file mode 100644 index 00000000..be65504c Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-trace-screenshot.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-trace.png b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-trace.png new file mode 100644 index 00000000..4ccf4547 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-trace.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-traces.png b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-traces.png new file mode 100644 index 00000000..ab7db620 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-error-traces.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-trace-screenshot.png b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-trace-screenshot.png new file mode 100644 index 00000000..4e133364 Binary files /dev/null and b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/images/zipkin-trace-screenshot.png differ diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/highlight.min.js b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/highlight.min.js new file mode 100644 index 00000000..dcbbb4c7 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/highlight.min.js @@ -0,0 +1,2 @@ +/*! highlight.js v9.13.1 | BSD3 License | git.io/hljslicense */ +!function(e){var n="object"==typeof window&&window||"object"==typeof self&&self;"undefined"!=typeof exports?e(exports):n&&(n.hljs=e({}),"function"==typeof define&&define.amd&&define([],function(){return n.hljs}))}(function(e){function n(e){return e.replace(/&/g,"&").replace(//g,">")}function t(e){return e.nodeName.toLowerCase()}function r(e,n){var t=e&&e.exec(n);return t&&0===t.index}function a(e){return k.test(e)}function i(e){var n,t,r,i,o=e.className+" ";if(o+=e.parentNode?e.parentNode.className:"",t=M.exec(o))return w(t[1])?t[1]:"no-highlight";for(o=o.split(/\s+/),n=0,r=o.length;r>n;n++)if(i=o[n],a(i)||w(i))return i}function o(e){var n,t={},r=Array.prototype.slice.call(arguments,1);for(n in e)t[n]=e[n];return r.forEach(function(e){for(n in e)t[n]=e[n]}),t}function c(e){var n=[];return function r(e,a){for(var i=e.firstChild;i;i=i.nextSibling)3===i.nodeType?a+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:a,node:i}),a=r(i,a),t(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:a,node:i}));return a}(e,0),n}function u(e,r,a){function i(){return e.length&&r.length?e[0].offset!==r[0].offset?e[0].offset"}function c(e){l+=""}function u(e){("start"===e.event?o:c)(e.node)}for(var s=0,l="",f=[];e.length||r.length;){var g=i();if(l+=n(a.substring(s,g[0].offset)),s=g[0].offset,g===e){f.reverse().forEach(c);do u(g.splice(0,1)[0]),g=i();while(g===e&&g.length&&g[0].offset===s);f.reverse().forEach(o)}else"start"===g[0].event?f.push(g[0].node):f.pop(),u(g.splice(0,1)[0])}return l+n(a.substr(s))}function s(e){return e.v&&!e.cached_variants&&(e.cached_variants=e.v.map(function(n){return o(e,{v:null},n)})),e.cached_variants||e.eW&&[o(e)]||[e]}function l(e){function n(e){return e&&e.source||e}function t(t,r){return new RegExp(n(t),"m"+(e.cI?"i":"")+(r?"g":""))}function r(a,i){if(!a.compiled){if(a.compiled=!0,a.k=a.k||a.bK,a.k){var o={},c=function(n,t){e.cI&&(t=t.toLowerCase()),t.split(" ").forEach(function(e){var t=e.split("|");o[t[0]]=[n,t[1]?Number(t[1]):1]})};"string"==typeof a.k?c("keyword",a.k):B(a.k).forEach(function(e){c(e,a.k[e])}),a.k=o}a.lR=t(a.l||/\w+/,!0),i&&(a.bK&&(a.b="\\b("+a.bK.split(" ").join("|")+")\\b"),a.b||(a.b=/\B|\b/),a.bR=t(a.b),a.endSameAsBegin&&(a.e=a.b),a.e||a.eW||(a.e=/\B|\b/),a.e&&(a.eR=t(a.e)),a.tE=n(a.e)||"",a.eW&&i.tE&&(a.tE+=(a.e?"|":"")+i.tE)),a.i&&(a.iR=t(a.i)),null==a.r&&(a.r=1),a.c||(a.c=[]),a.c=Array.prototype.concat.apply([],a.c.map(function(e){return s("self"===e?a:e)})),a.c.forEach(function(e){r(e,a)}),a.starts&&r(a.starts,i);var u=a.c.map(function(e){return e.bK?"\\.?("+e.b+")\\.?":e.b}).concat([a.tE,a.i]).map(n).filter(Boolean);a.t=u.length?t(u.join("|"),!0):{exec:function(){return null}}}}r(e)}function f(e,t,a,i){function o(e){return new RegExp(e.replace(/[-\/\\^$*+?.()|[\]{}]/g,"\\$&"),"m")}function c(e,n){var t,a;for(t=0,a=n.c.length;a>t;t++)if(r(n.c[t].bR,e))return n.c[t].endSameAsBegin&&(n.c[t].eR=o(n.c[t].bR.exec(e)[0])),n.c[t]}function u(e,n){if(r(e.eR,n)){for(;e.endsParent&&e.parent;)e=e.parent;return e}return e.eW?u(e.parent,n):void 0}function s(e,n){return!a&&r(n.iR,e)}function p(e,n){var t=R.cI?n[0].toLowerCase():n[0];return e.k.hasOwnProperty(t)&&e.k[t]}function d(e,n,t,r){var a=r?"":j.classPrefix,i='',i+n+o}function h(){var e,t,r,a;if(!E.k)return n(k);for(a="",t=0,E.lR.lastIndex=0,r=E.lR.exec(k);r;)a+=n(k.substring(t,r.index)),e=p(E,r),e?(M+=e[1],a+=d(e[0],n(r[0]))):a+=n(r[0]),t=E.lR.lastIndex,r=E.lR.exec(k);return a+n(k.substr(t))}function b(){var e="string"==typeof E.sL;if(e&&!L[E.sL])return n(k);var t=e?f(E.sL,k,!0,B[E.sL]):g(k,E.sL.length?E.sL:void 0);return E.r>0&&(M+=t.r),e&&(B[E.sL]=t.top),d(t.language,t.value,!1,!0)}function v(){y+=null!=E.sL?b():h(),k=""}function m(e){y+=e.cN?d(e.cN,"",!0):"",E=Object.create(e,{parent:{value:E}})}function N(e,n){if(k+=e,null==n)return v(),0;var t=c(n,E);if(t)return t.skip?k+=n:(t.eB&&(k+=n),v(),t.rB||t.eB||(k=n)),m(t,n),t.rB?0:n.length;var r=u(E,n);if(r){var a=E;a.skip?k+=n:(a.rE||a.eE||(k+=n),v(),a.eE&&(k=n));do E.cN&&(y+=I),E.skip||E.sL||(M+=E.r),E=E.parent;while(E!==r.parent);return r.starts&&(r.endSameAsBegin&&(r.starts.eR=r.eR),m(r.starts,"")),a.rE?0:n.length}if(s(n,E))throw new Error('Illegal lexeme "'+n+'" for mode "'+(E.cN||"")+'"');return k+=n,n.length||1}var R=w(e);if(!R)throw new Error('Unknown language: "'+e+'"');l(R);var x,E=i||R,B={},y="";for(x=E;x!==R;x=x.parent)x.cN&&(y=d(x.cN,"",!0)+y);var k="",M=0;try{for(var C,A,S=0;;){if(E.t.lastIndex=S,C=E.t.exec(t),!C)break;A=N(t.substring(S,C.index),C[0]),S=C.index+A}for(N(t.substr(S)),x=E;x.parent;x=x.parent)x.cN&&(y+=I);return{r:M,value:y,language:e,top:E}}catch(O){if(O.message&&-1!==O.message.indexOf("Illegal"))return{r:0,value:n(t)};throw O}}function g(e,t){t=t||j.languages||B(L);var r={r:0,value:n(e)},a=r;return t.filter(w).filter(x).forEach(function(n){var t=f(n,e,!1);t.language=n,t.r>a.r&&(a=t),t.r>r.r&&(a=r,r=t)}),a.language&&(r.second_best=a),r}function p(e){return j.tabReplace||j.useBR?e.replace(C,function(e,n){return j.useBR&&"\n"===e?"
":j.tabReplace?n.replace(/\t/g,j.tabReplace):""}):e}function d(e,n,t){var r=n?y[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),-1===e.indexOf(r)&&a.push(r),a.join(" ").trim()}function h(e){var n,t,r,o,s,l=i(e);a(l)||(j.useBR?(n=document.createElementNS("http://www.w3.org/1999/xhtml","div"),n.innerHTML=e.innerHTML.replace(/\n/g,"").replace(//g,"\n")):n=e,s=n.textContent,r=l?f(l,s,!0):g(s),t=c(n),t.length&&(o=document.createElementNS("http://www.w3.org/1999/xhtml","div"),o.innerHTML=r.value,r.value=u(t,c(o),s)),r.value=p(r.value),e.innerHTML=r.value,e.className=d(e.className,l,r.language),e.result={language:r.language,re:r.r},r.second_best&&(e.second_best={language:r.second_best.language,re:r.second_best.r}))}function b(e){j=o(j,e)}function v(){if(!v.called){v.called=!0;var e=document.querySelectorAll("pre code");E.forEach.call(e,h)}}function m(){addEventListener("DOMContentLoaded",v,!1),addEventListener("load",v,!1)}function N(n,t){var r=L[n]=t(e);r.aliases&&r.aliases.forEach(function(e){y[e]=n})}function R(){return B(L)}function w(e){return e=(e||"").toLowerCase(),L[e]||L[y[e]]}function x(e){var n=w(e);return n&&!n.disableAutodetect}var E=[],B=Object.keys,L={},y={},k=/^(no-?highlight|plain|text)$/i,M=/\blang(?:uage)?-([\w-]+)\b/i,C=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,I="",j={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0};return e.highlight=f,e.highlightAuto=g,e.fixMarkup=p,e.highlightBlock=h,e.configure=b,e.initHighlighting=v,e.initHighlightingOnLoad=m,e.registerLanguage=N,e.listLanguages=R,e.getLanguage=w,e.autoDetection=x,e.inherit=o,e.IR="[a-zA-Z]\\w*",e.UIR="[a-zA-Z_]\\w*",e.NR="\\b\\d+(\\.\\d+)?",e.CNR="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",e.BNR="\\b(0b[01]+)",e.RSR="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",e.BE={b:"\\\\[\\s\\S]",r:0},e.ASM={cN:"string",b:"'",e:"'",i:"\\n",c:[e.BE]},e.QSM={cN:"string",b:'"',e:'"',i:"\\n",c:[e.BE]},e.PWM={b:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/},e.C=function(n,t,r){var a=e.inherit({cN:"comment",b:n,e:t,c:[]},r||{});return a.c.push(e.PWM),a.c.push({cN:"doctag",b:"(?:TODO|FIXME|NOTE|BUG|XXX):",r:0}),a},e.CLCM=e.C("//","$"),e.CBCM=e.C("/\\*","\\*/"),e.HCM=e.C("#","$"),e.NM={cN:"number",b:e.NR,r:0},e.CNM={cN:"number",b:e.CNR,r:0},e.BNM={cN:"number",b:e.BNR,r:0},e.CSSNM={cN:"number",b:e.NR+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",r:0},e.RM={cN:"regexp",b:/\//,e:/\/[gimuy]*/,i:/\n/,c:[e.BE,{b:/\[/,e:/\]/,r:0,c:[e.BE]}]},e.TM={cN:"title",b:e.IR,r:0},e.UTM={cN:"title",b:e.UIR,r:0},e.METHOD_GUARD={b:"\\.\\s*"+e.UIR,r:0},e});hljs.registerLanguage("bash",function(e){var t={cN:"variable",v:[{b:/\$[\w\d#@][\w\d_]*/},{b:/\$\{(.*?)}/}]},s={cN:"string",b:/"/,e:/"/,c:[e.BE,t,{cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]}]},a={cN:"string",b:/'/,e:/'/};return{aliases:["sh","zsh"],l:/\b-?[a-z\._]+\b/,k:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},c:[{cN:"meta",b:/^#![^\n]+sh\s*$/,r:10},{cN:"function",b:/\w[\w\d_]*\s*\(\s*\)\s*\{/,rB:!0,c:[e.inherit(e.TM,{b:/\w[\w\d_]*/})],r:0},e.HCM,s,a,t]}});hljs.registerLanguage("dockerfile",function(e){return{aliases:["docker"],cI:!0,k:"from maintainer expose env arg user onbuild stopsignal",c:[e.HCM,e.ASM,e.QSM,e.NM,{bK:"run cmd entrypoint volume add copy workdir label healthcheck shell",starts:{e:/[^\\]\n/,sL:"bash"}}],i:")?[^\s\(]+(\s+[^\s\(]+)\s*=/,r:5,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"type",b://,k:"reified",r:0},{cN:"params",b:/\(/,e:/\)/,endsParent:!0,k:t,r:0,c:[{b:/:/,e:/[=,\/]/,eW:!0,c:[{cN:"type",b:e.UIR},e.CLCM,e.CBCM],r:0},e.CLCM,e.CBCM,s,l,c,e.CNM]},e.CBCM]},{cN:"class",bK:"class interface trait",e:/[:\{(]|$/,eE:!0,i:"extends implements",c:[{bK:"public protected internal private constructor"},e.UTM,{cN:"type",b://,eB:!0,eE:!0,r:0},{cN:"type",b:/[,:]\s*/,e:/[<\(,]|$/,eB:!0,rE:!0},s,l]},c,{cN:"meta",b:"^#!/usr/bin/env",e:"$",i:"\n"},o]}});hljs.registerLanguage("java",function(e){var a="[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*",t=a+"(<"+a+"(\\s*,\\s*"+a+")*>)?",r="false synchronized int abstract float private char boolean var static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports do",s="\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",c={cN:"number",b:s,r:0};return{aliases:["jsp"],k:r,i:/<\/|#/,c:[e.C("/\\*\\*","\\*/",{r:0,c:[{b:/\w+@/,r:0},{cN:"doctag",b:"@[A-Za-z]+"}]}),e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"new throw return else",r:0},{cN:"function",b:"("+t+"\\s+)+"+e.UIR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:r,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,k:r,r:0,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},c,{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("xml",function(s){var e="[A-Za-z0-9\\._:-]+",t={eW:!0,i:/`]+/}]}]}]};return{aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist"],cI:!0,c:[{cN:"meta",b:"",r:10,c:[{b:"\\[",e:"\\]"}]},s.C("",{r:10}),{b:"<\\!\\[CDATA\\[",e:"\\]\\]>",r:10},{cN:"meta",b:/<\?xml/,e:/\?>/,r:10},{b:/<\?(php)?/,e:/\?>/,sL:"php",c:[{b:"/\\*",e:"\\*/",skip:!0},{b:'b"',e:'"',skip:!0},{b:"b'",e:"'",skip:!0},s.inherit(s.ASM,{i:null,cN:null,c:null,skip:!0}),s.inherit(s.QSM,{i:null,cN:null,c:null,skip:!0})]},{cN:"tag",b:"|$)",e:">",k:{name:"style"},c:[t],starts:{e:"",rE:!0,sL:["css","xml"]}},{cN:"tag",b:"|$)",e:">",k:{name:"script"},c:[t],starts:{e:"",rE:!0,sL:["actionscript","javascript","handlebars","xml"]}},{cN:"tag",b:"",c:[{cN:"name",b:/[^\/><\s]+/,r:0},t]}]}});hljs.registerLanguage("properties",function(r){var t="[ \\t\\f]*",e="[ \\t\\f]+",s="("+t+"[:=]"+t+"|"+e+")",n="([^\\\\\\W:= \\t\\f\\n]|\\\\.)+",a="([^\\\\:= \\t\\f\\n]|\\\\.)+",c={e:s,r:0,starts:{cN:"string",e:/$/,r:0,c:[{b:"\\\\\\n"}]}};return{cI:!0,i:/\S/,c:[r.C("^\\s*[!#]","$"),{b:n+s,rB:!0,c:[{cN:"attr",b:n,endsParent:!0,r:0}],starts:c},{b:a+s,rB:!0,r:0,c:[{cN:"meta",b:a,endsParent:!0,r:0}],starts:c},{cN:"attr",r:0,b:a+t+"$"}]}});hljs.registerLanguage("diff",function(e){return{aliases:["patch"],c:[{cN:"meta",r:10,v:[{b:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{b:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{b:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{cN:"comment",v:[{b:/Index: /,e:/$/},{b:/={3,}/,e:/$/},{b:/^\-{3}/,e:/$/},{b:/^\*{3} /,e:/$/},{b:/^\+{3}/,e:/$/},{b:/\*{5}/,e:/\*{5}$/}]},{cN:"addition",b:"^\\+",e:"$"},{cN:"deletion",b:"^\\-",e:"$"},{cN:"addition",b:"^\\!",e:"$"}]}});hljs.registerLanguage("shell",function(s){return{aliases:["console"],c:[{cN:"meta",b:"^\\s{0,3}[\\w\\d\\[\\]()@-]*[>%$#]",starts:{e:"$",sL:"bash"}}]}});hljs.registerLanguage("asciidoc",function(e){return{aliases:["adoc"],c:[e.C("^/{4,}\\n","\\n/{4,}$",{r:10}),e.C("^//","$",{r:0}),{cN:"title",b:"^\\.\\w.*$"},{b:"^[=\\*]{4,}\\n",e:"\\n^[=\\*]{4,}$",r:10},{cN:"section",r:10,v:[{b:"^(={1,5}) .+?( \\1)?$"},{b:"^[^\\[\\]\\n]+?\\n[=\\-~\\^\\+]{2,}$"}]},{cN:"meta",b:"^:.+?:",e:"\\s",eE:!0,r:10},{cN:"meta",b:"^\\[.+?\\]$",r:0},{cN:"quote",b:"^_{4,}\\n",e:"\\n_{4,}$",r:10},{cN:"code",b:"^[\\-\\.]{4,}\\n",e:"\\n[\\-\\.]{4,}$",r:10},{b:"^\\+{4,}\\n",e:"\\n\\+{4,}$",c:[{b:"<",e:">",sL:"xml",r:0}],r:10},{cN:"bullet",b:"^(\\*+|\\-+|\\.+|[^\\n]+?::)\\s+"},{cN:"symbol",b:"^(NOTE|TIP|IMPORTANT|WARNING|CAUTION):\\s+",r:10},{cN:"strong",b:"\\B\\*(?![\\*\\s])",e:"(\\n{2}|\\*)",c:[{b:"\\\\*\\w",r:0}]},{cN:"emphasis",b:"\\B'(?!['\\s])",e:"(\\n{2}|')",c:[{b:"\\\\'\\w",r:0}],r:0},{cN:"emphasis",b:"_(?![_\\s])",e:"(\\n{2}|_)",r:0},{cN:"string",v:[{b:"``.+?''"},{b:"`.+?'"}]},{cN:"code",b:"(`.+?`|\\+.+?\\+)",r:0},{cN:"code",b:"^[ \\t]",e:"$",r:0},{b:"^'{3,}[ \\t]*$",r:10},{b:"(link:)?(http|https|ftp|file|irc|image:?):\\S+\\[.*?\\]",rB:!0,c:[{b:"(link|image:?):",r:0},{cN:"link",b:"\\w",e:"[^\\[]+",r:0},{cN:"string",b:"\\[",e:"\\]",eB:!0,eE:!0,r:0}],r:10}]}});hljs.registerLanguage("aspectj",function(e){var t="false synchronized int abstract float private char boolean static null if const for true while long throw strictfp finally protected import native final return void enum else extends implements break transient new catch instanceof byte super volatile case assert short package default double public try this switch continue throws privileged aspectOf adviceexecution proceed cflowbelow cflow initialization preinitialization staticinitialization withincode target within execution getWithinTypeName handler thisJoinPoint thisJoinPointStaticPart thisEnclosingJoinPointStaticPart declare parents warning error soft precedence thisAspectInstance",i="get set args call";return{k:t,i:/<\/|#/,c:[e.C("/\\*\\*","\\*/",{r:0,c:[{b:/\w+@/,r:0},{cN:"doctag",b:"@[A-Za-z]+"}]}),e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"aspect",e:/[{;=]/,eE:!0,i:/[:;"\[\]]/,c:[{bK:"extends implements pertypewithin perthis pertarget percflowbelow percflow issingleton"},e.UTM,{b:/\([^\)]*/,e:/[)]+/,k:t+" "+i,eE:!1}]},{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,r:0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"pointcut after before around throwing returning",e:/[)]/,eE:!1,i:/["\[\]]/,c:[{b:e.UIR+"\\s*\\(",rB:!0,c:[e.UTM]}]},{b:/[:]/,rB:!0,e:/[{;]/,r:0,eE:!1,k:t,i:/["\[\]]/,c:[{b:e.UIR+"\\s*\\(",k:t+" "+i,r:0},e.QSM]},{bK:"new throw",r:0},{cN:"function",b:/\w+ +\w+(\.)?\w+\s*\([^\)]*\)\s*((throws)[\w\s,]+)?[\{;]/,rB:!0,e:/[{;=]/,k:t,eE:!0,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,r:0,k:t,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},e.CNM,{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("gradle",function(e){return{cI:!0,k:{keyword:"task project allprojects subprojects artifacts buildscript configurations dependencies repositories sourceSets description delete from into include exclude source classpath destinationDir includes options sourceCompatibility targetCompatibility group flatDir doLast doFirst flatten todir fromdir ant def abstract break case catch continue default do else extends final finally for if implements instanceof native new private protected public return static switch synchronized throw throws transient try volatile while strictfp package import false null super this true antlrtask checkstyle codenarc copy boolean byte char class double float int interface long short void compile runTime file fileTree abs any append asList asWritable call collect compareTo count div dump each eachByte eachFile eachLine every find findAll flatten getAt getErr getIn getOut getText grep immutable inject inspect intersect invokeMethods isCase join leftShift minus multiply newInputStream newOutputStream newPrintWriter newReader newWriter next plus pop power previous print println push putAt read readBytes readLines reverse reverseEach round size sort splitEachLine step subMap times toInteger toList tokenize upto waitForOrKill withPrintWriter withReader withStream withWriter withWriterAppend write writeLine"},c:[e.CLCM,e.CBCM,e.ASM,e.QSM,e.NM,e.RM]}});hljs.registerLanguage("json",function(e){var i={literal:"true false null"},n=[e.QSM,e.CNM],r={e:",",eW:!0,eE:!0,c:n,k:i},t={b:"{",e:"}",c:[{cN:"attr",b:/"/,e:/"/,c:[e.BE],i:"\\n"},e.inherit(r,{b:/:/})],i:"\\S"},c={b:"\\[",e:"\\]",c:[e.inherit(r)],i:"\\S"};return n.splice(n.length,0,t,c),{c:n,k:i,i:"\\S"}});hljs.registerLanguage("sql",function(e){var t=e.C("--","$");return{cI:!0,i:/[<>{}*]/,c:[{bK:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment with",e:/;/,eW:!0,l:/[\w\.]+/,k:{keyword:"as abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias allocate allow alter always analyze ancillary and any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force foreign form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notnull notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second section securefile security seed segment select self sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unnest unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null unknown",built_in:"array bigint binary bit blob bool boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text time timestamp varchar varying void"},c:[{cN:"string",b:"'",e:"'",c:[e.BE,{b:"''"}]},{cN:"string",b:'"',e:'"',c:[e.BE,{b:'""'}]},{cN:"string",b:"`",e:"`",c:[e.BE]},e.CNM,e.CBCM,t,e.HCM]},e.CBCM,t,e.HCM]}});hljs.registerLanguage("go",function(e){var t={keyword:"break default func interface select case map struct chan else goto package switch const fallthrough if range type continue for import return var go defer bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune",literal:"true false iota nil",built_in:"append cap close complex copy imag len make new panic print println real recover delete"};return{aliases:["golang"],k:t,i:"",rB:!0,e:"\\s*=>",c:[{cN:"params",v:[{b:r},{b:/\(\s*\)/},{b:/\(/,e:/\)/,eB:!0,eE:!0,k:t,c:s}]}]},{b://,sL:"xml",c:[{b:/<\w+\s*\/>/,skip:!0},{b:/<\w+/,e:/(\/\w+|\w+\/)>/,skip:!0,c:[{b:/<\w+\s*\/>/,skip:!0},"self"]}]}],r:0},{cN:"function",bK:"function",e:/\{/,eE:!0,c:[e.inherit(e.TM,{b:r}),{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,c:s}],i:/\[|%/},{b:/\$[(.]/},e.METHOD_GUARD,{cN:"class",bK:"class",e:/[{;=]/,eE:!0,i:/[:"\[\]]/,c:[{bK:"extends"},e.UTM]},{bK:"constructor",e:/\{/,eE:!0}],i:/#(?!!)/}}); \ No newline at end of file diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/a11y-dark.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/a11y-dark.min.css new file mode 100644 index 00000000..b93b742a --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/a11y-dark.min.css @@ -0,0 +1,99 @@ +/* a11y-dark theme */ +/* Based on the Tomorrow Night Eighties theme: https://github.com/isagalaev/highlight.js/blob/master/src/styles/tomorrow-night-eighties.css */ +/* @author: ericwbailey */ + +/* Comment */ +.hljs-comment, +.hljs-quote { + color: #d4d0ab; +} + +/* Red */ +.hljs-variable, +.hljs-template-variable, +.hljs-tag, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class, +.hljs-regexp, +.hljs-deletion { + color: #ffa07a; +} + +/* Orange */ +.hljs-number, +.hljs-built_in, +.hljs-builtin-name, +.hljs-literal, +.hljs-type, +.hljs-params, +.hljs-meta, +.hljs-link { + color: #f5ab35; +} + +/* Yellow */ +.hljs-attribute { + color: #ffd700; +} + +/* Green */ +.hljs-string, +.hljs-symbol, +.hljs-bullet, +.hljs-addition { + color: #abe338; +} + +/* Blue */ +.hljs-title, +.hljs-section { + color: #00e0e0; +} + +/* Purple */ +.hljs-keyword, +.hljs-selector-tag { + color: #dcc6e0; +} + +.hljs { + display: block; + overflow-x: auto; + background: #2b2b2b; + color: #f8f8f2; + padding: 0.5em; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +@media screen and (-ms-high-contrast: active) { + .hljs-addition, + .hljs-attribute, + .hljs-built_in, + .hljs-builtin-name, + .hljs-bullet, + .hljs-comment, + .hljs-link, + .hljs-literal, + .hljs-meta, + .hljs-number, + .hljs-params, + .hljs-string, + .hljs-symbol, + .hljs-type, + .hljs-quote { + color: highlight; + } + + .hljs-keyword, + .hljs-selector-tag { + font-weight: bold; + } +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/an-old-hope.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/an-old-hope.min.css new file mode 100644 index 00000000..a6d56f4b --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/an-old-hope.min.css @@ -0,0 +1,89 @@ +/* + +An Old Hope – Star Wars Syntax (c) Gustavo Costa +Original theme - Ocean Dark Theme – by https://github.com/gavsiu +Based on Jesse Leite's Atom syntax theme 'An Old Hope' – https://github.com/JesseLeite/an-old-hope-syntax-atom + +*/ + +/* Death Star Comment */ +.hljs-comment, +.hljs-quote +{ + color: #B6B18B; +} + +/* Darth Vader */ +.hljs-variable, +.hljs-template-variable, +.hljs-tag, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class, +.hljs-regexp, +.hljs-deletion +{ + color: #EB3C54; +} + +/* Threepio */ +.hljs-number, +.hljs-built_in, +.hljs-builtin-name, +.hljs-literal, +.hljs-type, +.hljs-params, +.hljs-meta, +.hljs-link +{ + color: #E7CE56; +} + +/* Luke Skywalker */ +.hljs-attribute +{ + color: #EE7C2B; +} + +/* Obi Wan Kenobi */ +.hljs-string, +.hljs-symbol, +.hljs-bullet, +.hljs-addition +{ + color: #4FB4D7; +} + +/* Yoda */ +.hljs-title, +.hljs-section +{ + color: #78BB65; +} + +/* Mace Windu */ +.hljs-keyword, +.hljs-selector-tag +{ + color: #B45EA4; +} + +/* Millenium Falcon */ +.hljs +{ + display: block; + overflow-x: auto; + background: #1C1D21; + color: #c0c5ce; + padding: 0.5em; +} + +.hljs-emphasis +{ + font-style: italic; +} + +.hljs-strong +{ + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-dark-reasonable.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-dark-reasonable.min.css new file mode 100644 index 00000000..fd41c996 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-dark-reasonable.min.css @@ -0,0 +1,77 @@ +/* + +Atom One Dark With support for ReasonML by Gidi Morris, based off work by Daniel Gamage + +Original One Dark Syntax theme from https://github.com/atom/one-dark-syntax + +*/ +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + line-height: 1.3em; + color: #abb2bf; + background: #282c34; + border-radius: 5px; +} +.hljs-keyword, .hljs-operator { + color: #F92672; +} +.hljs-pattern-match { + color: #F92672; +} +.hljs-pattern-match .hljs-constructor { + color: #61aeee; +} +.hljs-function { + color: #61aeee; +} +.hljs-function .hljs-params { + color: #A6E22E; +} +.hljs-function .hljs-params .hljs-typing { + color: #FD971F; +} +.hljs-module-access .hljs-module { + color: #7e57c2; +} +.hljs-constructor { + color: #e2b93d; +} +.hljs-constructor .hljs-string { + color: #9CCC65; +} +.hljs-comment, .hljs-quote { + color: #b18eb1; + font-style: italic; +} +.hljs-doctag, .hljs-formula { + color: #c678dd; +} +.hljs-section, .hljs-name, .hljs-selector-tag, .hljs-deletion, .hljs-subst { + color: #e06c75; +} +.hljs-literal { + color: #56b6c2; +} +.hljs-string, .hljs-regexp, .hljs-addition, .hljs-attribute, .hljs-meta-string { + color: #98c379; +} +.hljs-built_in, .hljs-class .hljs-title { + color: #e6c07b; +} +.hljs-attr, .hljs-variable, .hljs-template-variable, .hljs-type, .hljs-selector-class, .hljs-selector-attr, .hljs-selector-pseudo, .hljs-number { + color: #d19a66; +} +.hljs-symbol, .hljs-bullet, .hljs-link, .hljs-meta, .hljs-selector-id, .hljs-title { + color: #61aeee; +} +.hljs-emphasis { + font-style: italic; +} +.hljs-strong { + font-weight: bold; +} +.hljs-link { + text-decoration: underline; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-dark.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-dark.min.css new file mode 100644 index 00000000..1616aafe --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-dark.min.css @@ -0,0 +1,96 @@ +/* + +Atom One Dark by Daniel Gamage +Original One Dark Syntax theme from https://github.com/atom/one-dark-syntax + +base: #282c34 +mono-1: #abb2bf +mono-2: #818896 +mono-3: #5c6370 +hue-1: #56b6c2 +hue-2: #61aeee +hue-3: #c678dd +hue-4: #98c379 +hue-5: #e06c75 +hue-5-2: #be5046 +hue-6: #d19a66 +hue-6-2: #e6c07b + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + color: #abb2bf; + background: #282c34; +} + +.hljs-comment, +.hljs-quote { + color: #5c6370; + font-style: italic; +} + +.hljs-doctag, +.hljs-keyword, +.hljs-formula { + color: #c678dd; +} + +.hljs-section, +.hljs-name, +.hljs-selector-tag, +.hljs-deletion, +.hljs-subst { + color: #e06c75; +} + +.hljs-literal { + color: #56b6c2; +} + +.hljs-string, +.hljs-regexp, +.hljs-addition, +.hljs-attribute, +.hljs-meta-string { + color: #98c379; +} + +.hljs-built_in, +.hljs-class .hljs-title { + color: #e6c07b; +} + +.hljs-attr, +.hljs-variable, +.hljs-template-variable, +.hljs-type, +.hljs-selector-class, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-number { + color: #d19a66; +} + +.hljs-symbol, +.hljs-bullet, +.hljs-link, +.hljs-meta, +.hljs-selector-id, +.hljs-title { + color: #61aeee; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-link { + text-decoration: underline; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-light.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-light.min.css new file mode 100644 index 00000000..d5bd1d2a --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/atom-one-light.min.css @@ -0,0 +1,96 @@ +/* + +Atom One Light by Daniel Gamage +Original One Light Syntax theme from https://github.com/atom/one-light-syntax + +base: #fafafa +mono-1: #383a42 +mono-2: #686b77 +mono-3: #a0a1a7 +hue-1: #0184bb +hue-2: #4078f2 +hue-3: #a626a4 +hue-4: #50a14f +hue-5: #e45649 +hue-5-2: #c91243 +hue-6: #986801 +hue-6-2: #c18401 + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + color: #383a42; + background: #fafafa; +} + +.hljs-comment, +.hljs-quote { + color: #a0a1a7; + font-style: italic; +} + +.hljs-doctag, +.hljs-keyword, +.hljs-formula { + color: #a626a4; +} + +.hljs-section, +.hljs-name, +.hljs-selector-tag, +.hljs-deletion, +.hljs-subst { + color: #e45649; +} + +.hljs-literal { + color: #0184bb; +} + +.hljs-string, +.hljs-regexp, +.hljs-addition, +.hljs-attribute, +.hljs-meta-string { + color: #50a14f; +} + +.hljs-built_in, +.hljs-class .hljs-title { + color: #c18401; +} + +.hljs-attr, +.hljs-variable, +.hljs-template-variable, +.hljs-type, +.hljs-selector-class, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-number { + color: #986801; +} + +.hljs-symbol, +.hljs-bullet, +.hljs-link, +.hljs-meta, +.hljs-selector-id, +.hljs-title { + color: #4078f2; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-link { + text-decoration: underline; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/dracula.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/dracula.min.css new file mode 100644 index 00000000..578f0b40 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/dracula.min.css @@ -0,0 +1,76 @@ +/* + +Dracula Theme v1.2.0 + +https://github.com/zenorocha/dracula-theme + +Copyright 2015, All rights reserved + +Code licensed under the MIT license +https://zenorocha.mit-license.org/ + +@author Éverton Ribeiro +@author Zeno Rocha + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #282a36; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-section, +.hljs-link { + color: #8be9fd; +} + +.hljs-function .hljs-keyword { + color: #ff79c6; +} + +.hljs, +.hljs-subst { + color: #f8f8f2; +} + +.hljs-string, +.hljs-title, +.hljs-name, +.hljs-type, +.hljs-attribute, +.hljs-symbol, +.hljs-bullet, +.hljs-addition, +.hljs-variable, +.hljs-template-tag, +.hljs-template-variable { + color: #f1fa8c; +} + +.hljs-comment, +.hljs-quote, +.hljs-deletion, +.hljs-meta { + color: #6272a4; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-title, +.hljs-section, +.hljs-doctag, +.hljs-type, +.hljs-name, +.hljs-strong { + font-weight: bold; +} + +.hljs-emphasis { + font-style: italic; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/github.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/github.min.css new file mode 100644 index 00000000..791932b8 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/github.min.css @@ -0,0 +1,99 @@ +/* + +github.com style (c) Vasily Polovnyov + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + color: #333; + background: #f8f8f8; +} + +.hljs-comment, +.hljs-quote { + color: #998; + font-style: italic; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-subst { + color: #333; + font-weight: bold; +} + +.hljs-number, +.hljs-literal, +.hljs-variable, +.hljs-template-variable, +.hljs-tag .hljs-attr { + color: #008080; +} + +.hljs-string, +.hljs-doctag { + color: #d14; +} + +.hljs-title, +.hljs-section, +.hljs-selector-id { + color: #900; + font-weight: bold; +} + +.hljs-subst { + font-weight: normal; +} + +.hljs-type, +.hljs-class .hljs-title { + color: #458; + font-weight: bold; +} + +.hljs-tag, +.hljs-name, +.hljs-attribute { + color: #000080; + font-weight: normal; +} + +.hljs-regexp, +.hljs-link { + color: #009926; +} + +.hljs-symbol, +.hljs-bullet { + color: #990073; +} + +.hljs-built_in, +.hljs-builtin-name { + color: #0086b3; +} + +.hljs-meta { + color: #999; + font-weight: bold; +} + +.hljs-deletion { + background: #fdd; +} + +.hljs-addition { + background: #dfd; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/monokai-sublime.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/monokai-sublime.min.css new file mode 100644 index 00000000..ed52c92e --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/monokai-sublime.min.css @@ -0,0 +1,83 @@ +/* + +Monokai Sublime style. Derived from Monokai by noformnocontent https://nn.mit-license.org/ + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #23241f; +} + +.hljs, +.hljs-tag, +.hljs-subst { + color: #f8f8f2; +} + +.hljs-strong, +.hljs-emphasis { + color: #a8a8a2; +} + +.hljs-bullet, +.hljs-quote, +.hljs-number, +.hljs-regexp, +.hljs-literal, +.hljs-link { + color: #ae81ff; +} + +.hljs-code, +.hljs-title, +.hljs-section, +.hljs-selector-class { + color: #a6e22e; +} + +.hljs-strong { + font-weight: bold; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-name, +.hljs-attr { + color: #f92672; +} + +.hljs-symbol, +.hljs-attribute { + color: #66d9ef; +} + +.hljs-params, +.hljs-class .hljs-title { + color: #f8f8f2; +} + +.hljs-string, +.hljs-type, +.hljs-built_in, +.hljs-builtin-name, +.hljs-selector-id, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-addition, +.hljs-variable, +.hljs-template-variable { + color: #e6db74; +} + +.hljs-comment, +.hljs-deletion, +.hljs-meta { + color: #75715e; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/monokai.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/monokai.min.css new file mode 100644 index 00000000..a5735585 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/monokai.min.css @@ -0,0 +1,70 @@ +/* +Monokai style - ported by Luigi Maselli - https://grigio.org +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #272822; color: #ddd; +} + +.hljs-tag, +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-strong, +.hljs-name { + color: #f92672; +} + +.hljs-code { + color: #66d9ef; +} + +.hljs-class .hljs-title { + color: white; +} + +.hljs-attribute, +.hljs-symbol, +.hljs-regexp, +.hljs-link { + color: #bf79db; +} + +.hljs-string, +.hljs-bullet, +.hljs-subst, +.hljs-title, +.hljs-section, +.hljs-emphasis, +.hljs-type, +.hljs-built_in, +.hljs-builtin-name, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-addition, +.hljs-variable, +.hljs-template-tag, +.hljs-template-variable { + color: #a6e22e; +} + +.hljs-comment, +.hljs-quote, +.hljs-deletion, +.hljs-meta { + color: #75715e; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-doctag, +.hljs-title, +.hljs-section, +.hljs-type, +.hljs-selector-id { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/solarized-light.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/solarized-light.min.css new file mode 100644 index 00000000..fdcfcc72 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/solarized-light.min.css @@ -0,0 +1,84 @@ +/* + +Orginal Style from ethanschoonover.com/solarized (c) Jeremy Hull + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #fdf6e3; + color: #657b83; +} + +.hljs-comment, +.hljs-quote { + color: #93a1a1; +} + +/* Solarized Green */ +.hljs-keyword, +.hljs-selector-tag, +.hljs-addition { + color: #859900; +} + +/* Solarized Cyan */ +.hljs-number, +.hljs-string, +.hljs-meta .hljs-meta-string, +.hljs-literal, +.hljs-doctag, +.hljs-regexp { + color: #2aa198; +} + +/* Solarized Blue */ +.hljs-title, +.hljs-section, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class { + color: #268bd2; +} + +/* Solarized Yellow */ +.hljs-attribute, +.hljs-attr, +.hljs-variable, +.hljs-template-variable, +.hljs-class .hljs-title, +.hljs-type { + color: #b58900; +} + +/* Solarized Orange */ +.hljs-symbol, +.hljs-bullet, +.hljs-subst, +.hljs-meta, +.hljs-meta .hljs-keyword, +.hljs-selector-attr, +.hljs-selector-pseudo, +.hljs-link { + color: #cb4b16; +} + +/* Solarized Red */ +.hljs-built_in, +.hljs-deletion { + color: #dc322f; +} + +.hljs-formula { + background: #eee8d5; +} + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/zenburn.min.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/zenburn.min.css new file mode 100644 index 00000000..07be5020 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/highlight/styles/zenburn.min.css @@ -0,0 +1,80 @@ +/* + +Zenburn style from voldmar.ru (c) Vladimir Epifanov +based on dark.css by Ivan Sagalaev + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #3f3f3f; + color: #dcdcdc; +} + +.hljs-keyword, +.hljs-selector-tag, +.hljs-tag { + color: #e3ceab; +} + +.hljs-template-tag { + color: #dcdcdc; +} + +.hljs-number { + color: #8cd0d3; +} + +.hljs-variable, +.hljs-template-variable, +.hljs-attribute { + color: #efdcbc; +} + +.hljs-literal { + color: #efefaf; +} + +.hljs-subst { + color: #8f8f8f; +} + +.hljs-title, +.hljs-name, +.hljs-selector-id, +.hljs-selector-class, +.hljs-section, +.hljs-type { + color: #efef8f; +} + +.hljs-symbol, +.hljs-bullet, +.hljs-link { + color: #dca3a3; +} + +.hljs-deletion, +.hljs-string, +.hljs-built_in, +.hljs-builtin-name { + color: #cc9393; +} + +.hljs-addition, +.hljs-comment, +.hljs-quote, +.hljs-meta { + color: #7f9f7f; +} + + +.hljs-emphasis { + font-style: italic; +} + +.hljs-strong { + font-weight: bold; +} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/toc.js b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/toc.js new file mode 100644 index 00000000..0b6fcd65 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/toc.js @@ -0,0 +1,80 @@ +var toctitle = document.getElementById('toctitle'); +var path = window.location.pathname; +if (toctitle != null) { + var oldtoc = toctitle.nextElementSibling; + var newtoc = document.createElement('div'); + newtoc.setAttribute('id', 'tocbot'); + newtoc.setAttribute('class', 'js-toc desktop-toc'); + oldtoc.setAttribute('class', 'mobile-toc'); + oldtoc.parentNode.appendChild(newtoc); + tocbot.init({ + contentSelector: '#content', + headingSelector: 'h1, h2, h3, h4, h5', + positionFixedSelector: 'body', + fixedSidebarOffset: 90, + smoothScroll: false + }); + if (!path.endsWith("index.html") && !path.endsWith("/")) { + var link = document.createElement("a"); + if (document.getElementById('index-link')) { + indexLinkElement = document.querySelector('#index-link > p > a'); + linkHref = indexLinkElement.getAttribute("href"); + link.setAttribute("href", linkHref); + } else { + link.setAttribute("href", "index.html"); + } + link.innerHTML = " Back to index"; + var block = document.createElement("div"); + block.setAttribute('class', 'back-action'); + block.appendChild(link); + var toc = document.getElementById('toc'); + var next = document.getElementById('toctitle').nextElementSibling; + toc.insertBefore(block, next); + } +} + +var headerHtml = '
\n' + + '

\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '\n' + + '

\n' + + '
'; + +var header = document.createElement("div"); +header.innerHTML = headerHtml; +document.body.insertBefore(header, document.body.firstChild); diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/tocbot/tocbot.css b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/tocbot/tocbot.css new file mode 100644 index 00000000..0632de23 --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/tocbot/tocbot.css @@ -0,0 +1 @@ +.toc{overflow-y:auto}.toc>.toc-list{overflow:hidden;position:relative}.toc>.toc-list li{list-style:none}.toc-list{margin:0;padding-left:10px}a.toc-link{color:currentColor;height:100%}.is-collapsible{max-height:1000px;overflow:hidden;transition:all 300ms ease-in-out}.is-collapsed{max-height:0}.is-position-fixed{position:fixed !important;top:0}.is-active-link{font-weight:700}.toc-link::before{background-color:#EEE;content:' ';display:inline-block;height:inherit;left:0;margin-top:-1px;position:absolute;width:2px}.is-active-link::before{background-color:#54BC4B} diff --git a/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/tocbot/tocbot.min.js b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/tocbot/tocbot.min.js new file mode 100644 index 00000000..943d8fdb --- /dev/null +++ b/spring-cloud-sleuth/3.0.0.M1/reference/htmlsingle/js/tocbot/tocbot.min.js @@ -0,0 +1 @@ +!function(e){function t(o){if(n[o])return n[o].exports;var l=n[o]={i:o,l:!1,exports:{}};return e[o].call(l.exports,l,l.exports,t),l.l=!0,l.exports}var n={};t.m=e,t.c=n,t.d=function(e,n,o){t.o(e,n)||Object.defineProperty(e,n,{configurable:!1,enumerable:!0,get:o})},t.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(n,"a",n),n},t.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},t.p="",t(t.s=0)}([function(e,t,n){(function(o){var l,i,s;!function(n,o){i=[],l=o(n),void 0!==(s="function"==typeof l?l.apply(t,i):l)&&(e.exports=s)}(void 0!==o?o:this.window||this.global,function(e){"use strict";function t(){for(var e={},t=0;te.fixedSidebarOffset?-1===n.className.indexOf(e.positionFixedClass)&&(n.className+=h+e.positionFixedClass):n.className=n.className.split(h+e.positionFixedClass).join("")}function s(t){var n=document.documentElement.scrollTop||f.scrollTop;e.positionFixedSelector&&i();var o,l=t;if(m&&null!==document.querySelector(e.tocSelector)&&l.length>0){d.call(l,function(t,i){if(t.offsetTop>n+e.headingsOffset+10){return o=l[0===i?i:i-1],!0}if(i===l.length-1)return o=l[l.length-1],!0});var s=document.querySelector(e.tocSelector).querySelectorAll("."+e.linkClass);u.call(s,function(t){t.className=t.className.split(h+e.activeLinkClass).join("")});var c=document.querySelector(e.tocSelector).querySelectorAll("."+e.listItemClass);u.call(c,function(t){t.className=t.className.split(h+e.activeListItemClass).join("")});var a=document.querySelector(e.tocSelector).querySelector("."+e.linkClass+".node-name--"+o.nodeName+'[href="#'+o.id+'"]');-1===a.className.indexOf(e.activeLinkClass)&&(a.className+=h+e.activeLinkClass);var p=a.parentNode;p&&-1===p.className.indexOf(e.activeListItemClass)&&(p.className+=h+e.activeListItemClass);var C=document.querySelector(e.tocSelector).querySelectorAll("."+e.listClass+"."+e.collapsibleClass);u.call(C,function(t){-1===t.className.indexOf(e.isCollapsedClass)&&(t.className+=h+e.isCollapsedClass)}),a.nextSibling&&-1!==a.nextSibling.className.indexOf(e.isCollapsedClass)&&(a.nextSibling.className=a.nextSibling.className.split(h+e.isCollapsedClass).join("")),r(a.parentNode.parentNode)}}function r(t){return-1!==t.className.indexOf(e.collapsibleClass)&&-1!==t.className.indexOf(e.isCollapsedClass)?(t.className=t.className.split(h+e.isCollapsedClass).join(""),r(t.parentNode.parentNode)):t}function c(t){var n=t.target||t.srcElement;"string"==typeof n.className&&-1!==n.className.indexOf(e.linkClass)&&(m=!1)}function a(){m=!0}var u=[].forEach,d=[].some,f=document.body,m=!0,h=" ";return{enableTocAnimation:a,disableTocAnimation:c,render:n,updateToc:s}}},function(e,t){e.exports=function(e){function t(e){return e[e.length-1]}function n(e){return+e.nodeName.split("H").join("")}function o(t){var o={id:t.id,children:[],nodeName:t.nodeName,headingLevel:n(t),textContent:t.textContent.trim()};return e.includeHtml&&(o.childNodes=t.childNodes),o}function l(l,i){for(var s=o(l),r=n(l),c=i,a=t(c),u=a?a.headingLevel:0,d=r-u;d>0;)a=t(c),a&&void 0!==a.children&&(c=a.children),d--;return r>=e.collapseDepth&&(s.isCollapsed=!0),c.push(s),c}function i(t,n){var o=n;e.ignoreSelector&&(o=n.split(",").map(function(t){return t.trim()+":not("+e.ignoreSelector+")"}));try{return document.querySelector(t).querySelectorAll(o)}catch(e){return console.warn("Element not found: "+t),null}}function s(e){return r.call(e,function(e,t){return l(o(t),e.nest),e},{nest:[]})}var r=[].reduce;return{nestHeadingsArray:s,selectHeadings:i}}},function(e,t){function n(e){function t(e){return"a"===e.tagName.toLowerCase()&&(e.hash.length>0||"#"===e.href.charAt(e.href.length-1))&&(n(e.href)===s||n(e.href)+"#"===s)}function n(e){return e.slice(0,e.lastIndexOf("#"))}function l(e){var t=document.getElementById(e.substring(1));t&&(/^(?:a|select|input|button|textarea)$/i.test(t.tagName)||(t.tabIndex=-1),t.focus())}!function(){document.documentElement.style}();var i=e.duration,s=location.hash?n(location.href):location.href;!function(){function n(n){!t(n.target)||n.target.className.indexOf("no-smooth-scroll")>-1||"#"===n.target.href.charAt(n.target.href.length-2)&&"!"===n.target.href.charAt(n.target.href.length-1)||-1===n.target.className.indexOf(e.linkClass)||o(n.target.hash,{duration:i,callback:function(){l(n.target.hash)}})}document.body.addEventListener("click",n,!1)}()}function o(e,t){function n(e){s=e-i,window.scrollTo(0,c.easing(s,r,u,d)),s + + + + + + + + + + + + + + DEBUG + + + ${CONSOLE_LOG_PATTERN} + utf8 + + + + + + ${LOG_FILE} + + ${LOG_FILE}.%d{yyyy-MM-dd}.gz + 7 + + + ${CONSOLE_LOG_PATTERN} + utf8 + + + + + ${LOG_FILE}.json + + ${LOG_FILE}.json.%d{yyyy-MM-dd}.gz + 7 + + + + + UTC + + + + { + "timestamp": "@timestamp", + "severity": "%level", + "service": "${springAppName:-}", + "trace": "%X{traceId:-}", + "span": "%X{spanId:-}", + "pid": "${PID:-}", + "thread": "%thread", + "class": "%logger{40}", + "rest": "%message" + } + + + + + + + + + + + +