Getting Started

This article explains how you can easily integrate TracEE into your projects.

The TracEE framework is used to create and pass the TracEE Propagated Invocation Context (short: TPIC) information - which for example consists of invocation and session ids - throughout your applications system environment.

TracEE uses the MDC ( Mapped Diagnostic Context ) of your applications underlying log framework to store the TPIC during the invocation processing in your components. It uses the popular log abstraction slf4j and therefore can be used with most of the popular java logging frameworks like logback, log4j2, log4j and jboss-logging.

You normally only need to configure slf4j to use your preferred logging framework.

Step 2 : Provide Bindings

TracEE offers technology related binding artifacts which handle the generation or propagation of the TPIC information at the borders of your application or its components - this includes sending, receiving and returning of TPIC information to or from other components.

At the moment TracEE provides bindings for a lot of popular Java (EE) frameworks like Servlets, JAX-WS, JAX-RS, JMS, Spring, Apache CXF.

Integration of TracEE binding artifacts highly depend on their related frameworks, therefore there is no common way for integrating those bindings into applications. Please take a look at the bindings tab for further information about how to integrate TracEE bindings for specific frameworks.

Overview on all maven artefacts

You can find all tracee modules and their recent version in the maven central repository.

License

This project is released under the revised BSD License.

Social Links

Imprint

Web-Template based on SOLID by Carlos Alvarez and remixed according to the Creative Commons Attribution 3.0 License.