Upgrade to APM experience

You can upgrade your existing Lambda functions to the new unified monitoring experience with minimal effort. This transition allows you to monitor your Lambda functions with enhanced observability capabilities of New Relic. You can instrument all your existing Lambda functions in bulk, or you can choose to upgrade them one at a time. The upgrade process is non-intrusive and does not require any code changes to your existing functions.

Prerequisites

• Your Lambda functions is already instrumented in New Relic.
• Your Lambda functions are running on either python, nodejs, ruby, go, or .NET runtime. To view the list of supported versions of these runtimes, refer to compatibility and requirements docs.
• Your Lambda functions should be non-containerized functions.

Instrumentation methods

You can upgrade your existing Lambda functions using one of the following methods:

• New Relic UI
• Update using CLIs

New Relic UI

You can upgrade your existing Lambda functions using the New Relic UI.

To upgrade your existing Lambda functions from New Relic platform, follow these steps:

1. Go to one.newrelic.com > All capabilities > Serverless Functions > select your Lambda function entity.
2. On the Summary page, click Instrument for APM.
3. On the Lambda Function for APM page, provide the API key then click Continue.
4. By default, current Lambda entity is selected for upgrade. You can also select other Lambda functions to upgrade. Click Generate New Relic CLI command.
5. Copy the command and run it in your terminal or in your AWS terminal. The command will install the New Relic Lambda layer on your selected functions.
6. Click Continue to test the installation. The test will check whether the New Relic Lambda layer is installed correctly and whether the function is sending data to New Relic.
7. If the test is successful, you will see a success message. To view your Lambda function in the New Relic APM interface, click See your data in APM.

Update using CLIs

$
pip3 install --upgrade newrelic-lambda

$
newrelic-lambda layers install --nr-account-id YOUR_NR_ACCOUNT_ID --function my-function --upgrade --apm

Update existing Lambda alerts and dashboards

After upgrading your Lambda functions to APM + Serverless Convergence, you must update the NRQL queries in your dashboards to ensure accurate monitoring. The upgrade changes the metric paths for your Lambda data.

While alert conditions tied to Lambda function entities update automatically to use data from APM & Services entities, you must manually review your dashboard widgets. Update any NRQL queries in your dashboards that use the old metrics. For more information, see manage dashboard.

Find and use data

After you instrument your AWS Lambda functions, you can find and use the data in the New Relic APM interface. The data is organized into several key areas, each providing different insights into the performance and health of your Lambda functions.

In the APM interface, you can explore various aspects of your Lambda functions including distributed tracing, service maps, transactions, and error analysis, and many more. Each of these areas provides detailed insights into the performance, latency, and error rates of your Lambda functions, allowing you to quickly identify and resolve issues.

To view your Lambda functions in the New Relic APM interface:

1. Go to https://one.newrelic.com > APM & Services.
2. Set the search criteria as isLambdaFunction = true.
3. From the displayed list, select your Lambda Function to view the data.

Rollback

If you need to revert your Lambda functions back to the previous serverless monitoring experience, you can do so by setting the NEW_RELIC_APM_LAMBDA_MODE environment variable to false.

Related articles