Package com.appoptics.awslambda.handler

Enables AppOptics instrumentation for java functions in AWS Lambda.

See: Description

Interface Summary

Interface	Description
CheckedHandler<R,E extends Throwable>
CheckedProcedure<E extends Throwable>
Handler<R>
Procedure
TracedRequestHandler<I,O>	Implement this interface instead of RequestHandler to trace your function Provide implementation of TracedRequestHandler.doHandleRequest(Object, Context) instead of RequestHandler.handleRequest(Object, Context) For example:
TracedRequestStreamHandler	Implement this interface instead of RequestStreamHandler to trace your function Provide implementation of doHandleRequest(InputStream, OutputStream, Context) instead of RequestStreamHandler.handleRequest(InputStream, OutputStream, Context) For example:

Class Summary

Class	Description
HandlerInstrumentor	Wrap the existing code logic with method instrument or instrumentChecked

Package com.appoptics.awslambda.handler Description

Enables AppOptics instrumentation for java functions in AWS Lambda.

There are 2 ways to enable our instrumentation:

Use Request Handler interface

If your function has already implemented com.amazonaws.services.lambda.runtime.RequestHandler or com.amazonaws.services.lambda.runtime.RequestStreamHandler

1. Add the dependency com.appoptics.agent.java:appoptics-aws-lambda to your project
2. Implement TracedRequestHandler/TracedRequestStreamHandler instead of com.amazonaws.services.lambda.runtime.RequestHandler/com.amazonaws.services.lambda.runtime.RequestStreamHandler
3. Rename the method handleRequest to doHandleRequest
4. Redeploy the AWS Lambda function

For example:

 import com.appoptics.awslambda.handler.TracedRequestHandler;

 public class MyHandler implements TracedRequestHandler<APIGatewayV2ProxyRequestEvent, APIGatewayV2ProxyResponseEvent> { //replaced RequestHandler with TracedRequestHandler
     public APIGatewayV2ProxyResponseEvent doHandleRequest(APIGatewayV2ProxyRequestEvent input, Context context) { //renamed from handleRequest
 		   //...
     }
 }
 
 

Use our Instrumentor

Wrap your existing code logic with our instrumentor method

1. Add the dependency com.appoptics.agent.java:appoptics-aws-lambda to your project
2. Wrap the existing code logic with method instrument or instrumentChecked of HandlerInstrumentor
3. Redeploy the AWS Lambda function

For example:

 import com.appoptics.awslambda.handler.HandlerInstrumentor;

 public class MyHandler {
     public Output myMethod(Input input, Context context) throws IOException { //method signature unchanged
 	       return HandlerInstrumentor.instrumentChecked(input, context, getClass(), () -> {
 		       // original code logic that might throw IOException...
         }
     }
 }