---
updatedAt: 2025-08-25T12:34:50.000Z
agentTools:
  projectIndex: https://lumigo.readme.io/llms.txt
---

# AWS Lambda in Java

## Overview

The `io.lumigo:java-tracer` package is Lumigo's Java agent for distributed tracing and performance monitoring on AWS Lambda. It allows you to pursue automated metric gathering through Lambda Layers, automated metric gathering and instrumentation.

Supported Runtimes: Java 8, Java 11, Java 17, Java 21

### Add the Lumigo Tracer to your application

Add the Lumigo Java tracer dependencies to your application configuration using the following code:

```xml
<repositories>
    <repository>
        <id>lumigo</id>
        <url>https://raw.githubusercontent.com/lumigo-io/java-tracer/master/local-repository/</url>        
    </repository>
</repositories>


<dependency>
  <groupId>io.lumigo</groupId>
  <artifactId>java-tracer</artifactId>
  <version>{version}</version>
</dependency>

<dependency>
  <groupId>io.lumigo</groupId>
  <artifactId>lumigo-agent</artifactId>
  <version>{version}</version>
</dependency>
```

### Wrap the code

With the package installed, simply implement a supplier with your code included, as the following example demonstrates:

```java
class MyFunction implements RequestHandler<INPUT, OUTPUT> {
  
  static{
    LumigoConfiguration.builder().build().init();
  }
  
  @Override
    public OUTPUT handleRequest(INPUT event, Context context) {
    Supplier<OUTPUT> supplier = () -> {
      //Your lambda code
      // return <result of type OUTPUT>;
    };
    
    return LumigoRequestExecutor.execute(event, context, supplier);
  }
}
```

### Connect Your Lumigo Account

Set your Lumigo token as the `LUMIGO_TRACER_TOKEN` environment variable of your Lambda function; refer to the [Using AWS Lambda environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) documentation for more information. Your Lumigo token is available in `Settings -> Tracing -> Manual tracing`, see the [Lumigo Tokens](https://docs.lumigo.io/docs/tracing-tokens-and-updates-1#/) documentation.

We advise you to use the most secure available to you to store secrets such as your `LUMIGO_TRACER_TOKEN`; refer to AWS Lambda's [Securing environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) documentation for guidance on keeping the values of your Lambda environment variables secure.

### Additional steps for Java 11 and above

Set the environment variable `JAVA_TOOL_OPTIONS` to your Lambda functions as follows:

```shell
export JAVA_TOOL_OPTIONS='-Djdk.attach.allowAttachSelf=true'
```