This package provides tracing to Java & Scala applications for the collection of distributed tracing and performance metrics in Epsagon.


Open source repository

This is an open-source project which can be found at our GitHub repository.


To install Epsagon on AWS Lambda function:

  <version>{Epsagon version}</version>

The version will be in the format n.n.n, latest maven-central version is specified at the top as a badge.

For any other environment, download the tracer using curl:

curl -o epsagon-opentracing-agent-1.0.49.jar



The simplest way to get started is to run your Java command with the following environment variable:

export EPSAGON_TOKEN=epsagon-token
export EPSAGON_SERVICE_NAME=app-name-stage
java -javaagent:.path_to_epsagon_agent -jar your jar file

For example:

export EPSAGON_TOKEN=your-token
export EPSAGON_SERVICE_NAME=spring-prod
java -javaagent:./epsagon-opentracing-agent-1.0.49.jar -jar app.jar

You can see the list of auto-tracing supported frameworks

Ignore Endpoints

You can ignore certain incoming requests by specifying endpoints:

export EPSAGON_IGNORED_ENDPOINTS=healthcheck, health


The following frameworks are supported by Epsagon:

FrameworkSupported VersionAuto-tracing Supported
AWS LambdaAllNo
Spring BootAllYes
Kafka Clients>=


Epsagon provides out-of-the-box instrumentation (tracing) for many popular frameworks and libraries.

LibrarySupported Version
Apache HttpClient>=4.0
Apache HttpAsyncClient>=4.0


Advanced options can be configured as a parameter to the init() method or as environment variables.

ParameterEnvironment VariableTypeDefaultDescription
EPSAGON_TOKENString-Epsagon account token
EPSAGON_SERVICE_NAMEStringEpsagon ApplicationApplication name that will be set for traces
EPSAGON_COLLECTOR_ENDPOINTString-The address of the trace collector to send trace to
EPSAGON_IGNORED_ENDPOINTSArray-List of endpoints to ignore from tracing (for example /healthcheck)
-EPSAGON_REPORTER_LOG_SPANSBooleanTrueA flag to disable Epsagon trace sending (if set to False

To Enable debug prints for troubleshooting add "-Depsagon.slf4j.simpleLogger.defaultLogLevel=info" to the java command

Did this page help you?