Epsagon Documentation

Welcome to the Epsagon Documentation. You'll find comprehensive guides and documentation to help you start working with our product as quickly as possible. Let's jump right in!

Get Started

AWS Lambda

Installing the library

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, the 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, the latest maven-central version is specified at the top as a badge.

Using the library

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.

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("<epsagon=token>")
                    .setAppName("<app-name-stage>");
        } 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.

Updated 22 days ago


AWS Lambda


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.