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

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のサーバーレスアプリケーションモデル（SAM）は、CloudFormationテンプレートの一種であり、機能を依存するリソースに関連づけたり、アプリケーション全体のライフサイクルを管理したりすることを容易にします。私たちはLambdaのサンプル関数のほとんどにSAMとCloudFormationを使用しており、他の多くのツールはCloudFormationテンプレートの上に構築され、抽象化の追加レイヤーを提供しています。

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

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

1. New Relic Lambda レイヤーをインストールします。以下は、 Node.js Lambda関数の単純な CloudFormation テンプレートの例です。

   AWSTemplateFormatVersion: '2010-09-09'
   Transform: AWS::Serverless-2016-10-31
   Description: And 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という名前のファイルがあります。

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タグを追加します。

上記の方法よりもエラーが発生しやすく、手間がかかりますが、AWS LambdaコンソールからNew Relicを使用するようにLambda関数の設定を手動で変更することができます。Node.jsの場合、 Python、Ruby、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 。
  • RequestStreamHandlerWrapper 実装: 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関数を計装するにはソースコードを変更する必要があることに注意してください。 設定変更だけでは十分ではありません。