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 like com.yourcompany.YourHandler::handlerMethod)
  • EPSAGON_TOKEN - Epsagon's token, can be found at the Dashboard
  • EPSAGON_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