SDKベースのインストゥルメンテーション

Go-language Lambdaをインストゥルメントするには、以下の手順に従います。

1. Goエージェントパッケージをダウンロードして、関数と同じディレクトリに配置します。

   1. 次のコマンドを実行してエージェントをインストールします。

      bash

      コピー

      $
      go get -u github.com/newrelic/go-agent/v3/newrelic

   2. 次のコマンドを実行して、 nrlambda統合をインストールします。

      bash

      コピー

      $
      go get -u github.com/newrelic/go-agent/v3/integrations/nrlambda

2. あなたのLambdaコードで、私たちのコンポーネントをインポートし、アプリケーションを作成し、Lambdaの起動方法を更新してください。インストゥルメンテーションの例をご覧ください。

   • エクステンション・レポ
   • エージェントのレポを見る

3. 必要に応じて、 RecordCustomEvent APIを使用して、Lambda呼び出しに関連付けられるカスタムイベントを追加します。例えば：

   func handler(ctx context.Context) {
     if txn := newrelic.FromContext(ctx); nil != txn {
       txn.Application().RecordCustomEvent("MyEvent", map[string]interface{}{
         "zip": "zap",
       })
     }
     fmt.Println("hello world!")
   }

   コピー

4. Lambda関数を構築して圧縮し、AWSにアップロードします。

   圧縮とアップロートについての推奨

   Lambdaの圧縮とアップロードについての推奨は、次のとおりです。

   1. Linuxで実行するためのバイナリをビルドします。これにより、 mainというバイナリファイルが生成されます。次を使用できます。

      bash

      コピー

      $
      GOOS=linux go build -o main

   2. 次のものを使用して、バイナリをデプロイメントパッケージに圧縮します。

      bash

      コピー

      $
      zip deployment.zip main

   3. AWSLambdaコンソールまたはAWSCLIのいずれかを使用してzipファイルをAWSにアップロードします。ハンドラーにmainという名前を付けます（バイナリビルド中に指定された名前と一致させるため）。

5. ディストリビューティッド（分散）トレーシングを有効にして環境変数を設定するには、 環境変数のドキュメントを参照してください。

6. 少なくとも1回Lambdaを呼び出します。これにより、CloudWatchロググループが作成されます。次のステップではこのグループが必要です。

   ラッパーはLambda実行についてのデータを収集し、JSONメッセージを生成し、CloudWatchログにログ記録します。次に、CloudWatchを設定してそのログをNew Relicに送信します。

JavaでのAWS Lambdaのモニタリングでは、APM Javaエージェントは使用しません。代わりに、次の2つのOpenTracing依存関係を使用します。

• AWS Lambda OpenTracing Java SDK：AWS Lambda RequestHandlerおよびRequestStreamHandlerのOpenTracingインストゥルメンテーション。

• 当社のAWS Lambda OpenTracing Tracer：OpenTracing Tracerの実装は、AWS Lambdaをモニターするように設計されています。スパン、エラーイベント、トランザクションイベント、エラートレースを生成し、ディストリビューティッド（分散）トレーシングをサポートします。

  重要

  New Relic AWS Lamdba OpenTracing Java SDK ライブラリのバージョン 3.0.0 では、AWS 依存関係のバージョンが変更されました。現在、次の依存関係が使用されています。

  • com.amazonaws:aws-lambda-java-core:1.2.3 （以前のバージョン：1.1.0）

  • com.amazonaws:aws-lambda-java-events:3.15.0 （以前のバージョン：2.2.7）

  • software.amazon.awssdk:s3:2.31.43 (com.amazonaws:AWS-java-sdk-s3:1.12.771 を置き換えます)

  • software.amazon.awssdk:s3-event-notifications:2.31.43 (com.amazonaws:AWS-java-sdk-s3:1.12.771 を置き換えます)

    New Relic AWS Lamdba OpenTracing Java SDK を利用する関数では、上記で説明したように、基盤となる AWS ライブラリと同じバージョン (またはそれ以上のバージョン) を利用することをお勧めします。アップグレードできない関数は、このライブラリのバージョン 2.2.0 のままにしておく必要があります。

  ヒント

  Supported OpenTracing Versions

  • OpenTracing 0.31.0：

    • Lambda Tracer：com.newrelic.opentracing:newrelic-java-lambda:1.1.1
    • Lambda SDK：com.newrelic.opentracing:java-aws-lambda:1.0.0

  • OpenTracing 0.32.0, 0.33.0：

    • Lambda トレーサー: com.newrelic.opentracing:newrelic-java-lambda:2.2.3
    • Lambda SDK: com.newrelic.opentracing:java- AWS Lambda :2.1.1

  Java Lambdaをインストゥルメントするには、以下の手順に従います。

1. プロジェクトのbuild.gradleファイルに、OpenTracing AWS Lambda トレーサーと AWS Lambda OpenTracing SDK の依存関係を含めます。

   dependencies {
       compile("com.newrelic.opentracing:java-aws-lambda:2.1.1")
       compile("com.newrelic.opentracing:newrelic-java-lambda:2.2.3")
       compile("io.opentracing:opentracing-util:0.33.0")
   }

   コピー

2. JavaLambdaの例に示すようにAWSLambda RequestHandlerインターフェースを実装し、 doHandleRequestメソッドをオーバーライドします。

3. doHandleRequestメソッドで、 LambdaTracing.instrument(...) APIを呼び出してルートスパンを作成し、ラムダ関数の実行をトレースします。これは、ラムダ関数のビジネスロジックを定義する場所でもあります。

4. Java Lambdaの例に示すように、 LambdaTracer.INSTANCEをOpenTracingグローバルトレーサーとして登録します。

5. ZIPデプロイメントパッケージを作成し、AWS Lambdaにアップロードします。または、その他の方法でディプロイします。

6. AWS Lambdaコンソールで、ハンドラーを設定します。 Java Lambdaの例では、ハンドラーはcom.handler.example.MyLambdaHandler::handleRequestになります。 handleRequestが想定されているため、 com.handler.example.MyLambdaHandlerを使用することもできます。

7. ディストリビューティッド（分散）トレーシングを有効にして環境変数を設定するには、 環境変数のドキュメントを参照してください。

8. 少なくとも1回Lambdaを呼び出します。これにより、CloudWatchロググループが作成されます。次のステップではこのグループが必要です。

   ラッパーはLambda実行についてのデータを収集し、JSONメッセージを生成し、CloudWatchログにログ記録します。次に、CloudWatchを設定してそのログをNew Relicに送信します。

   以下のような、一般的な使用例を示す完全なプロジェクトのAWS Lambdaディストリビューティッド（分散）トレーシングの例を参照してください。

• Lambda関数間のディストリビューティッド（分散）トレーシング
• 手作業でのスパン作成（別名カスタムインストゥルメンテーション）
• 外部コールのトレース
• カスタムアトリビュート（別名タグ）のスパンへの追加

Node.js Lambdaをインストゥルメントするには：

1. Node.jsエージェントパッケージをダウンロードして関数と同じディレクトリに配置し、エージェントが依存関係としてnode_modulesディレクトリにインストールされていることを確認します。ノードパッケージマネージャーを使用します。

   bash

   コピー

   $
   npm install newrelic --save

2. Lambda コードでは、ファイルの先頭にエージェント モジュールを要求し、ハンドラー関数を newrelic setLambdaHandlerでラップします。 例えば：

   • CommonJS のサンプルコード:

   const newrelic = require('newrelic');
   
   // Other module loads go under the require statement above
   
   module.exports.handler = newrelic.setLambdaHandler((event, context, callback) => {
     // This is your handler function code
     console.log('Lambda executed');
     callback();
   });

   コピー
   • ES モジュールのサンプルコード:

   import newrelic from 'newrelic';
      // Other module loads go under the require statement above
   
      export const handler = newrelic.setLambdaHandler((event, context, callback) => {
      // This is your handler function code
      console.log('Lambda executed');
      callback();
    });

   コピー

3. オプション： recordCustomEvent APIを使用してLambdaにカスタムイベントを追加することもできます。例えば：

   • CommonJS のサンプルコード:

   module.exports.handler = newrelic.setLambdaHandler((event, context, callback) => {
     newrelic.recordCustomEvent('MyEventType', { foo: 'bar' });
     console.log('Lambda executed');
     callback();
   });

   コピー
   • ES モジュールのサンプルコード:

   export const lambdaHandler = newrelic.setLambdaHandler((event, context, callback) => {
   newrelic.recordCustomEvent('MyEventType', { foo: 'bar' });
   console.log('Lambda executed');
   callback();
   });

   コピー

4. Lambda関数とNode.jsエージェントフォルダを一緒に圧縮します。要件および推奨：

   • New Relicエージェントフォルダに入っていないNew Relicファイルは、含める必要はありません。
   • Lambda関数のファイル名がたとえばlambda_function.nodeの場合、zipファイルにlambda_function.zipという名前を付けることをお勧めします。 tarballは使用しないでください。
   • Lambdaと関連モジュールはすべて、zipファイルのルートディレクトリにある必要があります。つまり、ファイルを含むファイルを圧縮するとうまくいきません。

5. 圧縮したファイルを、AWS Lambdaアカウントにアップロードします。

6. ディストリビューティッド（分散）トレーシングを有効にして環境変数を設定するには、 環境変数のドキュメントを参照してください。

7. インストゥルメンテーションを完了するには、次のいずれかの手順に従ってテレメトリーデータをNew Relicに送信します。

   • New Relic Lambda Extension layerを使用します。 最新の（NewRelicLambdaExtension）レイヤーarnを取得できます。 AWS CLI を使用してレイヤーをインストールするか、手動で Lambda に追加することができます。
   bash

   コピー

   $
   aws lambda update-function-configuration --function-name <your-lambda-function-name> --layers arn:aws:lambda:<aws-region>:451483290750:layer:NewRelicLambdaExtension:<version>

• newrelic-log-ingestion使用してください。 詳細な手順については、 CloudWatch フォールバックを参照してください。

Python Lambdaをインストゥルメントするには：

1. Python エージェントと Python ラムダ ラッパー パッケージの両方をダウンロードし、関数コードと同じディレクトリに配置します。 これを行うには、pip を使用します。

   bash

   コピー

   $
   pip install -t . newrelic newrelic-lambda

   重要

   Homebrewを使用している場合、次のエラーが発生する可能性があります： DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both 。詳細については、 HomebrewGitHubの投稿を参照してください。

2. Lambda コードで、Python エージェント モジュールと Python ラムダ ラッパー モジュールの両方をインポートします。

3. New Relic デコレータを使用してハンドラー関数を装飾します。 まず、コードに New Relic パッケージをインポートする必要があります。 次に例を示します。

   import newrelic.agent
   from newrelic_lambda.lambda_handler import lambda_handler
   
   newrelic.agent.initialize()
   
   @lambda_handler()
   def handler(event, context):
     ...

   コピー

4. オプション： record_custom_event APIを使用してLambdaにカスタムイベントを追加することもできます。次に例を示します。

   @lambda_handler()
   def handler(event, context):
     newrelic.agent.record_custom_event('CustomEvent', {'foo': 'bar'})
     ...

   コピー

5. 次のガイドラインを使用して、 lambda_function.py フォルダとnewrelic/フォルダを一緒に圧縮します。

   • newrelic/フォルダー外のNewRelicファイルを含める必要はありません。
   • Lambda関数のファイル名がたとえばlambda_function.pyの場合、zipファイルにlambda_function.zipという名前を付けます。 tarballは使用しないでください。
   • Lambdaと関連モジュールはすべて、zipファイルのルートディレクトリにある必要があります。つまり、ファイルを含むファイルを圧縮するとうまくいきません。

6. 圧縮したファイルを、AWS Lambdaアカウントにアップロードします。

7. ディストリビューティッド（分散）トレーシングを有効にして環境変数を設定するには、 環境変数のドキュメントを参照してください。

8. 少なくとも1回Lambdaを呼び出します。これにより、CloudWatchロググループが作成されます。次のステップではこのグループが必要です。

   New Relicデコレーターは、Lambda実行についてのデータを収集し、JSONメッセージを生成し、CloudWatchログに記録します。次に、CloudWatchを設定してそのログをNew Relicに送信します。

ほとんどの場合、.NET エージェントはAWS Lambda 関数を自動的に計算し、「サーバーレス モード」に切り替えて、 New Relicやその他の機能へのデータの直接送信を無効にします。 New Relic にデータを送信するには、New Relic Lambda Extension またはnewrelic-log-ingestionラムダ メソッドを使用する必要があります。

.NET Lambda をセットアップするには:

1. NewRelic.agent nuget パッケージをAWS Lambdaプロジェクトに追加します。 詳細については、インストレーション ガイドをご覧ください。
2. ディストリビューティッド（分散）トレーシングを有効にして環境変数を設定するには、 環境変数のドキュメントを参照してください。
3. プロジェクトを AWS Lambda アカウントに公開します。
4. New Relic Lambda Extension またはnewrelic-log-ingestionラムダのいずれかを構成します。
5. Lambda を少なくとも 1 回呼び出してエラーをチェックし、データが New Relic UI に表示されることを確認します。