com.datadoghq.datadog_lambda_java

Class DDLambda

java.lang.Object

com.datadoghq.datadog_lambda_java.DDLambda

public class DDLambda
extends java.lang.Object

The DDLambda instrumenter is used for getting information about your Lambda into Datadog.

Constructor Summary

Constructors

Constructor and Description
DDLambda(com.amazonaws.services.lambda.runtime.events.APIGatewayProxyRequestEvent req, com.amazonaws.services.lambda.runtime.Context cxt) Create a trace-enabled DDLambda instrumenter given an APIGatewayProxyRequestEvent and a Lambda context
DDLambda(com.amazonaws.services.lambda.runtime.events.APIGatewayV2ProxyRequestEvent req, com.amazonaws.services.lambda.runtime.Context cxt) Create a trace-enabled DDLambda instrumenter given an APIGatewayV2ProxyEventRequest and a Lambda context
DDLambda(com.amazonaws.services.lambda.runtime.Context cxt) Create a new DDLambda instrumenter given some Lambda context
DDLambda(Headerable req, com.amazonaws.services.lambda.runtime.Context cxt) Create a trace-enabled DDLambda instrumenter given a custom request object.

Method Summary

Modifier and Type	Method and Description
org.apache.http.client.methods.HttpUriRequest	addTraceHeaders(org.apache.http.client.methods.HttpUriRequest httpRequest) Adds Datadog trace header to an org.apache.http.client.methods.HttpUriRequest, so you can trace downstream HTTP requests.
okhttp3.Request	addTraceHeaders(okhttp3.Request request) Adds Datadog trace header to an OKHttp3 request, so you can trace downstream HTTP requests.
java.net.URLConnection	addTraceHeaders(java.net.URLConnection urlConnection) Adds Datadog trace headers to a java.net.URLConnection, so you can trace downstream HTTP requests.
void	error(com.amazonaws.services.lambda.runtime.Context cxt) error increments the aws.lambda.enhanced.error metric in Datadog.
org.apache.http.client.methods.HttpGet	makeHttpGet(java.lang.String url) Creates an Apache HttpGet instrumented with Datadog trace headers.
okhttp3.Request.Builder	makeRequestBuilder() Create an OKHttp3 request builder with Datadog headers already added.
java.net.URLConnection	makeUrlConnection(java.net.URL url) openConnection calls openConnection on the provided URL, adds the Datadog trace headers, and then returns the resulting URLConnection.
void	metric(java.lang.String name, double value, java.util.Map<java.lang.String,java.lang.Object> tags) metric allows the user to record their own custom metric that will be sent to Datadog.
void	metric(java.lang.String name, double value, java.util.Map<java.lang.String,java.lang.Object> tags, java.util.Date date) metric allows the user to record their own custom metric that will be sent to Datadog.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DDLambda

public DDLambda(com.amazonaws.services.lambda.runtime.Context cxt)

Create a new DDLambda instrumenter given some Lambda context

Parameters:

cxt - Enhanced Metrics pulls information from the Lambda context.

DDLambda

public DDLambda(com.amazonaws.services.lambda.runtime.events.APIGatewayProxyRequestEvent req,
                com.amazonaws.services.lambda.runtime.Context cxt)

Create a trace-enabled DDLambda instrumenter given an APIGatewayProxyRequestEvent and a Lambda context

Parameters:

req - Your Datadog trace headers are pulled from the request and sent to XRay for consumption by the Datadog Xray Crawler

cxt - Enhanced Metrics pulls information from the Lambda context.

DDLambda

public DDLambda(com.amazonaws.services.lambda.runtime.events.APIGatewayV2ProxyRequestEvent req,
                com.amazonaws.services.lambda.runtime.Context cxt)

Create a trace-enabled DDLambda instrumenter given an APIGatewayV2ProxyEventRequest and a Lambda context

Parameters:

req - Your Datadog trace headers are pulled from the request and sent to XRay for consumption by the Datadog Xray Crawler

cxt - Enhanced Metrics pulls information from the Lambda context.

DDLambda

public DDLambda(Headerable req,
                com.amazonaws.services.lambda.runtime.Context cxt)

Create a trace-enabled DDLambda instrumenter given a custom request object. Please note that your custom request object MUST implement Headerable.

Parameters:

req - A custom request object that implements Headerable. Datadog trace headers are pulled from this request object.

cxt - Enhanced Metrics pulls information from the Lambda context.

Method Detail

metric

public void metric(java.lang.String name,
                   double value,
                   java.util.Map<java.lang.String,java.lang.Object> tags)

metric allows the user to record their own custom metric that will be sent to Datadog.

Parameters:

name - The metric's name

value - The metric's value

tags - A map of tags to be assigned to the metric

metric

public void metric(java.lang.String name,
                   double value,
                   java.util.Map<java.lang.String,java.lang.Object> tags,
                   java.util.Date date)

metric allows the user to record their own custom metric that will be sent to Datadog. also allows user to set his/her own date.

Parameters:

name - The metric's name

value - The metric's value

tags - A map of tags to be assigned to the metric

date - The date under which the metric value will appear in datadog

error

public void error(com.amazonaws.services.lambda.runtime.Context cxt)

error increments the aws.lambda.enhanced.error metric in Datadog.

Parameters:

cxt - The AWS Context provided to your handler

makeUrlConnection

public java.net.URLConnection makeUrlConnection(java.net.URL url)
                                         throws java.io.IOException

openConnection calls openConnection on the provided URL, adds the Datadog trace headers, and then returns the resulting URLConnection. This duplicates the usual workflow with a java.net.URLConnection

Parameters:

url - the URL to which you want to open a connection.

Returns:

a newly opened URLConnection with Datadog trace headers.

Throws:

java.io.IOException

addTraceHeaders

public java.net.URLConnection addTraceHeaders(java.net.URLConnection urlConnection)

Adds Datadog trace headers to a java.net.URLConnection, so you can trace downstream HTTP requests.

Parameters:

urlConnection - the URLConnection that will have the trace headers added to it.

Returns:

Returns a mutated URLConnection with the new trace headers.

makeHttpGet

public org.apache.http.client.methods.HttpGet makeHttpGet(java.lang.String url)

Creates an Apache HttpGet instrumented with Datadog trace headers. Please note, this does not _execute_ the HttpGet, it merely creates a default HttpGet with headers added.

Parameters:

url - The URL that will eventually be gotten.

Returns:

Returns an HttpGet for the provided URL, instrumented with Datadog trace headers.

addTraceHeaders

public org.apache.http.client.methods.HttpUriRequest addTraceHeaders(org.apache.http.client.methods.HttpUriRequest httpRequest)

Adds Datadog trace header to an org.apache.http.client.methods.HttpUriRequest, so you can trace downstream HTTP requests.

Parameters:

httpRequest - the HttpUriRequest that will have the trace headers added to it.

Returns:

Returns a mutated HttpUriRequest with the new trace headers.

makeRequestBuilder

public okhttp3.Request.Builder makeRequestBuilder()

Create an OKHttp3 request builder with Datadog headers already added.

Returns:

Returns an OKHttp3 Request Builder with Datadog trace headers already added.

addTraceHeaders

public okhttp3.Request addTraceHeaders(okhttp3.Request request)

Adds Datadog trace header to an OKHttp3 request, so you can trace downstream HTTP requests.

Parameters:

request - The OKHttp3 Request that will have the trace headers added to it.

Returns:

Returns a mutated OKHttp3 Request with the new trace headers.