JarCasting 
Epsagon Instrumentation for Java
This package provides tracing to Java applications for the collection of distributed tracing and performance metrics in Epsagon.
Getting The Packages
Maven
For Maven projects, use:
<dependency>
<groupId>com.epsagon</groupId>
<artifactId>epsagon</artifactId>
<version>{Epsagon version}</version>
</dependency>
The version will be in the format n.n.n, latest maven-central version is specified at the top as a badge.
Gradle
For Gradle projects, first add the nuiton repository:
repositories {
...
maven {
url 'http://maven.nuiton.org/release/'
}
}
Then, configure epsagon as a dependency:
compile "com.epsagon:epsagon:${epsagon_version}"
The version will be in the format n.n.n, latest maven-central version is specified at the top as a badge.
Getting Started
Quick Start
The easiest way to get started is as following:
- set the entry point to your Lambdas as
com.epsagon.EpsagonRequestHandler - set the following environment variables:
EPSAGON_ENTRY_POINT- The real entry point to your code, the one you had previously configured (should be something likecom.yourcompany.YourHandler::handlerMethod)EPSAGON_TOKEN- Epsagon's token, can be found at the DashboardEPSAGON_APP_NAME- A name for the application of this function, optional.
And that's it! Your function is ready for invocation.
Alternative (No Environment Variables)
If you do not want to configure environment variables, please use this alternative:
First, create a simple class that extends com.epsagon.EpsagonRequestHandler like so:
import com.epsagon.EpsagonRequestHandler;
public class EpsagonWrapper extends EpsagonRequestHandler {
static {
try {
init("com.yourcompany.YourHandler::yourHandlerMethod")
.setToken("<your token>")
.setAppName("<your application name>");
} catch (Exception e) {
System.out.println(e);
}
}
}
The class should have a static initializer that calls the EpsagonRequestHandler.init() method, and gives it your Lambda's actual entry point as a parameter. The return value of this method is an EpsagonConfiguration object. Configure your token and application name using this object, like the example shows.
Finally, set this class as the entry point of your Lambda (instead of your original handler). This class will automatically load your original handler and execute it.
Copyright
Provided under the MIT license. See LICENSE for details.
Copyright 2020, Epsagon
