skywalking-java/docs/en/setup
Louis Tsui 72f07b812a Add Light4j plugin (#3323)
* Add Light4J 1.6.x plug-in

* Add unit test for Light4J plug-in

* Add missing id to server-starter

* Remove mentions of version 1.6.x

Some local testing showed that the plugin successfully generated traces for a light4j project built with light-codegen v2.x. Therefore, there is no need for a separate plugin for v2.x and no distinction needs to be made with light4j v1.6.x.

* Update supported light4j versions

* Use ContextSnapshot to maintain trace

In a typical Light4j project, the ExceptionHandler#handleRequest is the asynchronous execution point. The flow is ExceptionHandler#handleRequest -> HttpServerExchange#dispatch -> ... -> ExceptionHandler#handleRequest. This means that handleRequest is being intercepted twice and each time a LocalSpan is created. Without handling thread propagation, the trace segment gets split up.

By saving a ContextSnapshot into the enhanced object (ExceptionHandler), we can determine if it is necessary to continue the segment.

* Update logic for span creation in trace

By default, the Light4J plugin now overrides the Undertow plugin's entry span with its own. This new entry span is created just before execution of the ExceptionHandler#handleRequest in the I/O thread. The entry span is generated here because it is considered the starting point of the Light4J handler chain.

There is now also the option to enable detailed span creation when tracing requests through Light4J. These local spans mark which middleware and business handlers are involved with handling the HTTP request to a Light4J service.

* Update skywalking version

* Update light4j version

* Fix LightInstrumentation javadoc

* Remove import violating checkstyle

This import was added from the link reference in the javadoc. The javadoc has now been changed to just reference the method name.

* Move light4j agent config property

* Sync UI
2019-09-18 21:43:17 +08:00
..
backend Add TTL E2E test (#3437) 2019-09-09 22:06:57 -07:00
envoy Update ALS setup doc as istio 1.3 released (#3470) 2019-09-13 09:17:15 +08:00
istio Add istio bypass adaptor setup document back (#3376) 2019-09-01 09:19:58 +08:00
service-agent/java-agent Add Light4j plugin (#3323) 2019-09-18 21:43:17 +08:00
README.md Update README.md (#2920) 2019-06-21 15:36:28 +08:00

README.md

Setup

Setup based on which kind of probes are you going to use. If you don't understand, please read Concepts and Designs first.

Important: Please choose the timezone on UI, make it matches the timezone of your OAP backend servers.

Download official releases

Language agents in Service

  • Java agent. Introduce how to install java agent to your service, without change any codes.

The following agents and SDKs are compatible with the SkyWalking's formats and protocols, but maintained by the 3rd-party. You could go to their project repositories to find out the releases and how to use them.

Service Mesh

Proxy

Setup backend

Follow backend and UI setup document to understand and config the backend for different scenarios, and open advanced features.

Changes log

Backend, UI and Java agent changes are available here.