階層化されたインストゥルメンテーション

newrelic-lambda CLI クイックスタートを使用して Lambda 関数を計算できます。

New Relicインストゥルメンテーション レイヤーをインストールまたはアップグレードするには、次のコマンドを実行します。

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

このコマンドは、Lambdaのリージョンとランタイムに合わせて、利用可能な最新のレイヤーを自動的に見つけます。

このコマンドは、 New Relicインストゥルメントを迅速に開始する方法を提供し、 CI/CDパイプラインに簡単に統合できます。 ただし、既存の Lambda 関数リソースが変更されるため、更新されたコードを再デプロイすると、インストゥルメンテーションが誤って削除される可能性があります。 継続的な監視を確実に行うには、各インストーラの後にコマンドを再実行するか、可能であれば、 New Relicレイヤーと設定をインストーラ プロセスに直接組み込みます。

CLIはバッチで多くの関数を操作できることに注意してください。 --function all 、 --function installed 、または--function not-installedを使用して、リージョン内のすべての関数を操作するか、既存のNewRelicインストルメンテーションの有無にかかわらず関数のみを操作します。

AWS's Serverless Application Model, or SAM, is a variant of CloudFormation templates that simplifies relating functions to the resources they depend on, and managing the lifecycle of an entire application. We use SAM and CloudFormation for most of our Lambda example functions, and many other tools are built on top of CloudFormation templates, providing an additional layer of abstraction.

CloudFormation は、 AWSリソースのプロビジョニングと管理を簡素化するAWSサービスです。 YAML または JSON テンプレートでリソースの望ましい状態を定義することにより、CloudFormation は基盤となるAPIコールを自動的に処理し、必要に応じてリソースを作成、更新、または削除します。 この宣言型アプローチにより、インフラストラクチャ管理が自動化され、一貫性と再現性が確保されます。

New RelicでLambda関数を監視するには:

1. Install the New Relic Lambda layer. Below are examples for Node.js and Java agent Lambda functions.

   Node.js example:

   AWSTemplateFormatVersion: '2010-09-09'
   Transform: AWS::Serverless-2016-10-31
   Description: An example of a simple instrumented Node.js Lambda
   
   Resources:
     NewRelicExample:
       Type: AWS::Serverless::Function
       Properties:
         # In this example, we're using the SAM CLI to package and deploy our lambda. SAM will transform this value during the publish step.
         CodeUri: newrelic-example-node/
         # The handler for your function needs to be the one provided by the instrumentation layer, below.
         Handler: newrelic-lambda-wrapper.handler
         Runtime: nodejs22.x
         Environment:
           Variables:
             # For the instrumentation handler to invoke your real handler, we need this value
             NEW_RELIC_LAMBDA_HANDLER: YOUR_PATH_TO_INITIAL_LAMBDA_HANDLER
             # Distributed tracing needs your account ID, and your trusted account ID
             NEW_RELIC_ACCOUNT_ID: YOUR_ACCOUNT_ID_HERE
             # If your New Relic account has a parent account, this value should be that account ID. Otherwise, just
             # your account id.
             NEW_RELIC_TRUSTED_ACCOUNT_KEY: YOUR_PARENT_ACCOUNT_ID_HERE
             NEW_RELIC_APM_LAMBDA_MODE: 'true'
         Tags:
         # This tag is to enable APM mode.
           NR.Apm.Lambda.Mode: true
         Layers:
           # This layer includes the New Relic Lambda extension, a sidecar process that sends telemetry,
           # as well as the New Relic agent for Node.js, and a handler wrapper that makes integration easy.
           - !Sub arn:${AWS::Partition}:lambda:${AWS::Region}:451483290750:layer:NewRelicNodeJS16X:103
         Policies:
           # This policy allows the lambda to know the value of the New Relic license key. We need this so
           # that we can send telemetry back to New Relic
           - AWSSecretsManagerGetSecretValuePolicy:
               SecretArn: !ImportValue NewRelicLicenseKeySecret-NewRelic-LicenseKeySecretARN

   コピー

   通常、関数とそのリソースを記述するtemplate.yamlという名前のファイルがあります。

   Java agent example (slim layer, recommended):

   重要

   The Java agent layer requires Java 17 or later. Java 11 and older runtimes are not supported.

   AWSTemplateFormatVersion: '2010-09-09'
   Transform: AWS::Serverless-2016-10-31
   Description: An example of a simple instrumented Java Lambda using the New Relic slim layer
   
   Resources:
     NewRelicJavaExample:
       Type: AWS::Serverless::Function
       Properties:
         CodeUri: my-java-function/
         # Set the handler to the New Relic Java HandlerWrapper.
         # Use handleRequest for RequestHandler implementations,
         # or handleStreamsRequest for RequestStreamHandler implementations.
         Handler: com.newrelic.java.HandlerWrapper::handleRequest
         Runtime: java17
         Environment:
           Variables:
             # Required: points AWS Lambda to the New Relic Java agent wrapper in the layer.
             AWS_LAMBDA_EXEC_WRAPPER: /opt/newrelic-java-handler
             # Required: your New Relic ingest license key.
             NEW_RELIC_LICENSE_KEY: YOUR_NEW_RELIC_LICENSE_KEY
             # Required: your New Relic account ID (or parent account ID if applicable).
             NEW_RELIC_TRUSTED_ACCOUNT_KEY: YOUR_ACCOUNT_ID_HERE
         Layers:
           # Slim layer (recommended): only aws-lambda-java-core instrumentation enabled.
           # Replace us-east-1 with your AWS region. Layer version increments with each release.
           # For the latest versions, see https://layers.newrelic-external.com
           # x86_64: arn:aws:lambda:us-east-1:451483290750:layer:NewRelicAgentJava-slim:1
           # ARM64:  arn:aws:lambda:us-east-1:451483290750:layer:NewRelicAgentJavaARM64-slim:1
           - arn:aws:lambda:us-east-1:451483290750:layer:NewRelicAgentJava-slim:1

   コピー

   Two layer variants are available for Java. Use the slim layer unless you need full auto-instrumentation:

   • Slim layer (recommended): Only instruments RequestHandler / RequestStreamHandler. Lower cold start overhead.
   • Full layer: All auto-instrumentation modules enabled. Higher cold start overhead.

   See Java serverless AWS Lambda performance monitoring for details on the two variants.

2. 必要な環境変数を設定します。

3. 更新された設定を使用してLambda関数をデプロイします。

Serverless フレームワークは、サーバーレス アプリケーション向けの人気のある開発およびデプロイメント ツールです。 これは AWS 向けに Node.js で記述されており、主に CloudFormation テンプレート上の高レベルの抽象化として機能します。 Node、Python、Ruby、Java、.NET 関数に適しています。

New RelicサーバーServerlessワーク アプリケーションの計装を簡素化するServerlessフレームワーク プラグインを提供します。

前提条件:

• Serverlessフレームワークを利用した既存のアプリケーション。

• New Relic アカウント ID

• New RelicパーソナルAPIキー

  New Relicを使用してServerlessフレームワーク アプリケーションをインストールして設定するには:

1. npmを使用する場合は、次のコマンドを実行します。

   bash

   コピー

   $
   npm install --save-dev serverless-newrelic-lambda-layers

   または、 yarnを使用する場合は、次のコマンドを実行します。

   bash

   コピー

   $
   yarn add --dev serverless-newrelic-lambda-layers

2. serverless.yamlファイルを開き、次の設定を追加します。

   1. serverless-newrelic-lambda-layers pluginsリストに追加します。

   2. カスタム セクションに次のNew Relic設定を追加します。

      plugins:
        - serverless-newrelic-lambda-layers
      custom:
        newRelic:
          accountId: your-new-relic-account-id-here
          apiKey: your-new-relic-personal-api-key-here
          linkedAccount: your-new-relic-integration-account-name-here
          apm: true

      コピー

   3. プロバイダー セクションに次のNR.Apm.Lambda.Mode: trueタグを追加します。

      provider:
        tags:
          NR.Apm.Lambda.Mode: true

      コピー

3. 必要な環境変数を設定します。

4. 更新された設定を使用してLambda関数をデプロイします。

AWSクラウド開発キット ( AWS CDK) は、クラウド リソースをコードで定義し、 AWS CloudFormation を通じてプロビジョニングするためのフレームワークです。

AWS CDK で New Relic を使用するには、次の手順に従います。

1. New Relic Lambda レイヤーをインストールします。以下は、 New Relicインストゥルメントと言われたNode.js Lambda関数をデプロイする基本的な CDK アプリの例です。

   import * as cdk from 'aws-cdk-lib';
   import { Construct } from 'constructs';
   import * as lambda from 'aws-cdk-lib/aws-lambda';
   
   export class NewRelicExampleCdkStack extends cdk.Stack {
     constructor(scope: Construct, id: string, props?: cdk.StackProps) {
       super(scope, id, props);
       // Add latest New Relic Lambda layer ARN from https://layers.newrelic-external.com
       const NewReliclayerArn = 'arn:aws:lambda:us-east-1:451483290750:layer:NewRelicNodeJS22X:38';
       const myFunction = new lambda.Function(this, "NewRelicExampleLambda", {
         runtime: lambda.Runtime.NODEJS_20_X,
         // Update functions handler to point to the New Relic Lambda wrapper
         handler: "newrelic-lambda-wrapper.handler",
         code: lambda.Code.fromAsset('lib/lambda-runtime-code'),
         layers: [lambda.LayerVersion.fromLayerVersionArn(this, 'NewRelicLayer', NewReliclayerArn)],
         environment: {
           // Set the NEW_RELIC_LAMBDA_HANDLER environment variable to the path of your initial handler.
           NEW_RELIC_LAMBDA_HANDLER: 'index.handler',
           NEW_RELIC_APM_LAMBDA_MODE: 'true'
         },
       });
       // Add the New Relic APM Lambda Mode tag
       cdk.Tags.of(myFunction).add('NR.Apm.Lambda.Mode', 'true');
     }
   }

   コピー

2. 必要な環境変数を設定します。

3. 更新された設定を使用してLambda関数をデプロイします。

Terraform は、コード ツールとしての一般的なインフラストラクチャとして人気の高いツールです。 AWS リソースの管理に使用できます。 Terraform スクリプトを使用して インストゥルメントされた Lambda 関数のデプロイの 例をいくつか 紹介します。New Relic

New Relic Terraform プロバイダーを使用して、 AWSインテグレーションをセットアップできます。 プロバイダーをセットアップしたら、必要な環境変数を設定し、 Lambda関数にNR.Apm.Lambda.Mode: trueタグを追加します。

While it's more error-prone and labor-intensive than the approaches above, you can manually alter the configuration of a Lambda function to use New Relic from the AWS Lambda Console, for Node.js, Python, Ruby, and Java.

New Relicランタイムに LambdaRuby を実装する方法の例を次に示します。

1. AWS ウェブコンソールのLambdaサービスセクションに移動します。 そこから、 New Relicに接続する Lambda関数 を見つけます。

2. デフォルトのCode [コード]タブで、 Layers [レイヤー]セクションまで下にスクロールし、 Add a layer [レイヤーの追加]ボタンをクリックします。

3. Create layer [レイヤーの作成]ボタンをクリックします。

4. Choose a layer [レイヤーの選択]に移動し、 Specify an ARN [ARN の指定]オプションを選択します。

5. New Relicのレイヤーリストに移動し、ドロップダウンリストを使用して、Lambda 関数がホストされているAWSリージョンを選択します。 そこから、Lambda 関数のRubyバージョンとアーキテクチャに一致する ARN を見つけます。 オプションは X86 と ARM64 の 2 つあります。 Copy to clipboard [クリップボードにコピー]ボタンを使用するか、ARN 文字列を手動でコピーします。

6. AWS コンソールフォームのSpecify an ARN [ARN の指定]セクションで、New Relic Lambda レイヤーの ARN を貼り付けます。

7. AWSコンソールフォームで、 Add [追加]ボタンをクリックして、Lambda 関数にレイヤーを追加します。

8. Lambda関数のページで、デフォルトのCode [コード]タブを選択した状態で、Runtime settings [ランタイム設定]セクションまで下にスクロールし、Edit [編集]ボタンをクリックします。

9. 既存のHandler [ハンドラー]値の安全なコピーを作成します。 後の手順で必要になります。

10. Handler[ハンドラー]の値をnewrelic_lambda_wrapper.handlerに変更し、 Save [保存]をクリックします。

11. Lambda関数のページのConfiguration [設定]タブに切り替えます。

12. Environment variables [環境変数] サブタブを選択し、要件に基づいてEnvironment variables [環境変数]を定義します。

13. 実行ロールを変更して、 New Relicシークレットにアクセスできるようにします。

    • NEW_RELIC_LICENSE_KEYという名前のシークレットの ARN を見つけます。

    • 関数の実行ロールに、以下のコードのような新しいインライン ポリシーを追加します。 SECRET_ARNを上記で見つけた値に置き換えます。

      "Statement": [
        {
          "Action": [
            "secretsmanager:GetSecretValue"
          ],
          "Resource": "SECRET_ARN",
          "Effect": "Allow"
        }
      ]

      コピー

      ヒント

      New Relicレイヤーは、 New Relic Rubyエージェントを自動的に配信し、Lambda 関数の呼び出し前にRuby require を介してロードされます。 競合を避けるため、Ruby エージェントのコピーを他の場所に含めないでください。 エージェントの存在を活用するために、関数内で必要なNew Relic RubyエージェントAPI呼び出しを自由に実行してください。

14. AWSマネジメント コンソールの Configuration [設定] タブで、 Lambda関数にNR.Apm.Lambda.Mode: trueタグを追加します。

15. 更新された設定を使用してLambda関数をデプロイします。

    Java、Python、Node.js、および .Net ランタイムは、 Rubyと同じインストゥルメンテーション フローに従いますが、ハンドラーがいくつか異なります。 関数のコンソールで新しくアタッチされたレイヤーを指すように関数のハンドラーを更新する方法は次のとおりです。

• Javaです。

  • RequestHandler 実装: com.newrelic.java.HandlerWrapper::handleRequest 。
  • RequestStreamHandler 実装: com.newrelic.java.HandlerWrapper::handleStreamsRequest 。

• Python: newrelic_lambda_wrapper.handler (アンダースコア)。

• ノードです。

  • CommonJS: newrelic-lambda-wrapper.handler (ハイフン)。
  • ESM: /opt/nodejs/node_modules/newrelic-esm-lambda-wrapper/index.handler (ハイフン)。

• .Net の場合、ハンドラーを設定する必要はありません。

  Go の場合、Lambda関数を計装するにはソースコードを変更する必要があることに注意してください。 設定変更だけでは十分ではありません。