Update Lambda tracer version

❗️

Note

AWS is rolling out an update that may cause transactions in Lumigo to appear incorrectly when using old versions of the Lumigo Node.js tracers.

To keep Transactions in Lumigo correct and accurate, please update the Lumigo tracer on your Node.js Lambda functions to version 1.101.2 or above.

Can't find the answer you are looking for? Read these FAQs or contact us.

Lumigo's tracers constantly improve and unlock new abilities with each version. Some new features may require a newer tracer version, therefore you should periodically ensure you're up to date to get the latest and greatest Lumigo features.

There are several ways to update the Lumigo's tracers:

• Update with the Lumigo UI
• Update with AWS Tags
• Update with Serverless Framework
• Update using AWS CDK 2
• Manually inserting a tracer dependency

The latest version numbers for each language are available on the release pages: Python, Node.js, .NET, Go, Java. If you want to receive alerts on new releases, sign up for notifications on .

To determine the tracer version you're currently using go to the Functions, and hover over the Traced toggle to view the tracer version of the function.

Alternatively, you can leverage the "Add layer" flow in the AWS console to verify the current layer ARN you have in your function. The "Description" section mentions the tracer version (in this example v1.1.209)

To update the Lumigo traces to the latest version, un-trace and re-trace the function or functions.

📘

Note

Only functions that have been auto-trace can be updated via the UI. If there are additional functions that have been manually traced, please follow the instructions in the next sections.

Batch update

• Login to the platform.
• Go to the 'Functions' page.
• In the functions table, check all functions you would like to update.
• Click on 'Untrace' (the button will appear on the top-left part of the Functions table)
• Ensure the same functions are checked, and click on the 'Auto trace' button

Single function update

To update a single function, use the toggle button on the right side of the functions table. Toggle auto-tracing off, then toggle it on again.

When auto tracing with AWS tags:

• Remove or set the lumigo:auto-trace tag to false for all the relevant functions.
• Wait 15-20 minutes for changes to propagate. (The relevant function will be displayed as not traced in the Lumigo interface)
• Re-add/set the lumigo:auto-trace tag to true.
• Wait 15-20 minutes for the changes to propagate. (The relevant function will be displayed as traced in the Lumigo interface)

Note: When using the Lumigo interface or AWS tags, the latest tracer version will be installed, unless a specific version was explicitly set by the user beforehand, under Settings>Tracing menu.

When auto tracing with Serverless Framework

• Initiate a function deployment. The latest tracer version will be effective immediately.

When applying manual tracing

• Initiate a function deployment. The latest tracer version will be effective immediately.
• Note: if you added the lumigo_tracer package dependency with a specific version set (the dependency looks like lumigo_tracer==<version>), then update the version number to the latest and initiate the deployment.

When the Lumigo CDK Constructs, you need to:

• Update the version of the @lumigo/cdk-constructs-v2 package in your CDK repository, as we release a new version of @lumigo/cdk-constructs-v2 every time a Lambda tracer is updated, using the latest version by default
• Trigger an update of your CDK application using your cdk deploy workflow.