Lambda X-Ray Tracing Disabled
lambda-tracing-disabled
What this rule checks
Detects Lambda functions without active X-Ray tracing, reducing observability into latency and errors.
How to fix it
- 1Set TracingConfig.Mode to Active on the function
- 2Grant the function the AWSXRayDaemonWriteAccess managed policy
import * as lambda from 'aws-cdk-lib/aws-lambda';
new lambda.Function(this, 'Fn', {
runtime: lambda.Runtime.NODEJS_20_X,
handler: 'index.handler',
code: lambda.Code.fromInline('exports.handler = async () => {};'),
});import * as lambda from 'aws-cdk-lib/aws-lambda';
new lambda.Function(this, 'Fn', {
runtime: lambda.Runtime.NODEJS_20_X,
handler: 'index.handler',
code: lambda.Code.fromInline('exports.handler = async () => {};'),
tracing: lambda.Tracing.ACTIVE,
});CDK Insights pinpoints the exact file and line in your CDK source for every finding, so you can jump straight to the fix.
Affected resource types
AWS::Lambda::FunctionIntentional? Suppress this finding
Sometimes a flag is deliberate — a genuinely public endpoint, say. You can dismiss lambda-tracing-disabled and the reason is kept in the report, not silently hidden.
In .cdk-insights.json:
{
"ignoreRules": [
{ "id": "lambda-tracing-disabled", "reason": "Why this is intentional" }
]
}Or inline in your CDK code:
Validations.of(scope).acknowledge({
id: 'cdk-insights::lambda-tracing-disabled',
reason: 'Why this is intentional',
});Use the rule ID lambda-tracing-disabled shown above — not the CDK-* ID from SARIF / GitHub code scanning. To dismiss every finding on one construct instead, use ignorePaths. Suppression docs →
Catch this in your stack
$ npx cdk-insights scanCDK Insights runs this and 118+ other rules locally against your synthesised CDK app — free, no account, your code never leaves your machine.