The Datadog AWS Lambda X-Ray integration is only supported on commercial AWS accounts. Without a commercial Lambda account, the Datadog AWS Lambda X-Ray integration is not supported on the Datadog for Government site.
Overview
AWS X-Ray lets developers trace distributed applications built using AWS products. This integration provides traces for Lambda functions in the Serverless
function detail page. For more information, see Serverless monitoring
.
Setup
Installation
First, enable the AWS integration
and ensure the following permissions are present in the policy document of your Datadog integration role:
xray:BatchGetTraces,
xray:GetTraceSummaries
The GetTraceSummaries
permission is used to get the list of recent traces. BatchGetTraces
actually returns the full traces themselves.
Then, enable the X-Ray integration
within Datadog.
If you are using a Customer Master Key (CMK)
to encrypt traces, add the kms:Decrypt
method to your policy where the Resource is the CMK used for X-Ray.
Note: Enabling the AWS X-Ray integration increases the amount of Indexed Spans which can impact your bill.
Enabling AWS X-Ray for your functions
- Follow instructions from AWS to enable X-Ray tracing on your Lambda functions
and API Gateways
.
- To get the most out of the AWS X-Ray integration, also install the X-Ray SDK
in your Lambda function.
Enrich X-Ray traces with Datadog
Datadog can enrich X-Ray traces with spans and metadata generated by the Datadog APM client, and merge
them into a single Datadog trace for the same Lambda invocation.
- Install Datadog serverless monitoring
on your Lambda functions.
- Set the environment variable
DD_MERGE_XRAY_TRACES
to true
on your Lambda functions.
Data Collected
The AWS X-Ray integration pulls in trace data from AWS, and does not collect any metrics or logs.