lumigo-cdk2-alpha - npm Package Compare versions

Comparing version 0.0.3 to 0.0.4

package.json

@@ -5,3 +5,3 @@ {
     "type": "git",
-    "url": "https://github.com/michelem/lumigo-cdk-constructs.git"
+    "url": "https://github.com/lumigo-io/lumigo-cdk-constructs.git"
   },
@@ -76,3 +76,3 @@ "scripts": {
   "license": "Apache-2.0",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "jest": {
@@ -79,0 +79,0 @@ "testMatch": [

README.md

@@ -198,2 +198,44 @@ # Lumigo CDK Integrations
 
+### W3C TraceContext propagation in AWS Lambda
+
+To be able to trace scenarios in which a Lambda function sends HTTP requests to an application instrumented with OpenTelemetry, like those using the [Lumigo OpenTelemetry Distro for JS](https://github.com/lumigo-io/opentelemetry-js-distro) and [Lumigo OpenTelemetry Distro for Python](https://github.com/lumigo-io/opentelemetry-python-distro) or other OpenTelemetry SDKs, the Lumigo Node.js and Python tracers can optionally add [W3C TraceContext](https://www.w3.org/TR/trace-context/) HTTP headers to outgoing requests.
+
+Aty the tracer level, the support of W3C TraceContext is currently opt-in via the `LUMIGO_PROPAGATE_W3C=true` environment variable.
+But the Lumigo CDK integration can apply it to all your Lambda functions:
+
+```typescript
+import { Lumigo } from 'lumigo-cdk2-alpha';
+import { App, SecretValue } from 'aws-cdk-lib';
+
+const app = new App();
+
+// Add here stacks and constructs
+
+new Lumigo({lumigoToken:SecretValue.secretsManager('LumigoToken')}).traceEverything(app, {
+    lambdaEnableW3CTraceContext: true, // <--- This parameter set to true activates the W3C TraceContext propagation for all supported Lambda functions
+});
+
+app.synth();
+```
+
+Activating W3C TraceContext support is also supported on a function-by-function basis:
+
+```typescript
+export class MyNodejsLambdaStack extends Stack {
+  constructor(scope: Construct, id: string, props: LumigoStackProps) {
+    super(scope, id, props);
+
+    const handler = new Function(this, 'MyLambda', {
+      code: new InlineCode('foo'),
+      handler: 'index.handler',
+      runtime: Runtime.NODEJS_14_X,
+    });
+
+    props.lumigo.traceLambda(handler, {
+      enableW3CTraceContext: true,  // <--- This parameter set to true activates the W3C TraceCntext propagation for this Lambda function.
+    });
+  }
+}
+```
+
 ## Supported Constructs
@@ -200,0 +242,0 @@

No alert changes

Improved metrics

Total package byte prevSize

156242

increased by1.18%

Number of lines in readme file

247

increased by20.49%

No dependency changes