レイヤーレス インストゥルメンテーション

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. 次の環境変数は、Lambdaモニタリングが機能するために必要ではありませんが、Lambda関数を分散トレースに含める場合は必要です。分散トレースを有効にするには、AWSコンソールで次の環境変数を設定します。

   • NEW_RELIC_ACCOUNT_ID。アカウントID 。
   • NEW_RELIC_TRUSTED_ACCOUNT_KEY。これはあなたのアカウント IDでもあります。 アカウントが子アカウントの場合、これはルート/親アカウントのアカウント ID です。

6. オプションで、ロギングを構成するには、 Goエージェントロギングを参照してください。

7. 少なくとも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をモニターするように設計されています。スパン、エラーイベント、トランザクションイベント、エラートレースを生成し、ディストリビューティッド（分散）トレーシングをサポートします。

  ヒント

  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. 以下の AWSコンソール環境変数は、Lambda関数をディストリビューティッド（分散）トレーシングに含める場合は必要です。これが推奨されます。

   • NEW_RELIC_ACCOUNT_ID。アカウントID 。
   • NEW_RELIC_PRIMARY_APPLICATION_ID。これはあなたのアカウントIDでもあります。
   • NEW_RELIC_TRUSTED_ACCOUNT_KEY。これはあなたのアカウントIDでもあります。アカウントが子アカウントの場合、これはルート/親アカウントのアカウントIDである必要があります。

8. オプション：Lambdaコンソールで、次の環境変数を追加してデバッグログを有効にします： NEW_RELIC_DEBUGはtrueです。

9. 少なくとも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. AWSコンソールで、以下の環境変数を設定します。

   • NEW_RELIC_NO_CONFIG_FILE。構成ファイルを使用しない場合は、 trueに設定します。
   • NEW_RELIC_APP_NAME：アプリケーション名。
   • NEW_RELIC_ACCOUNT_ID。アカウントID 。
   • NEW_RELIC_TRUSTED_ACCOUNT_KEY。これはあなたのアカウントIDでもあります。アカウントが子アカウントの場合、これはルート/親アカウントのアカウントIDである必要があります。

7. オプション: AWS 外部のローカル環境でエージェントをサーバーレスモードで実行するには、環境変数NEW_RELIC_SERVERLESS_MODE_ENABLEDをtrueに設定します。 (これを AWS Lambda 環境で実行すると、エージェントは自動的にサーバーレス モードで実行されます。 AWS で実行している場合は、この変数を使用しないでください。

8. オプション：サーバーレスモードでのロギングを有効にするには、環境変数を次のように設定します。

   • NEW_RELIC_LOG_ENABLEDをtrueに設定します。
   • CloudWatchに出力するにはNEW_RELIC_LOGをstdoutに設定するか、書き込み可能なファイルの場所に設定します。
   • NEW_RELIC_LOG_LEVEL はデフォルトでinfoに設定されており、Lambda で関数ログを送信する場合にのみ使用されます。 他のログレベルを参照してください。

9. オプション: Lambda 関数が ES モジュールを使用している場合は、環境変数 NEW_RELIC_USE_ESM を trueに設定します。ES モジュールを使用する場合は、関数に async/await または Promise を使用する必要があることに注意してください。コールバックベースの関数はサポートされていません。

10. インストゥルメンテーションを完了するには、次のいずれかの手順に従ってテレメトリーデータを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. AWSコンソールで、以下の環境変数を設定します。

   • NEW_RELIC_SERVERLESS_MODE_ENABLED。に設定 true

8. 次の環境変数はLambdaをモニターする機能には不要ですが、Lambda機能をディストリビューティッド（分散）トレーシングに含める場合は必要です。ディストリビューティッド（分散）トレーシングを有効にするには、AWSコンソールで以下の環境変数を設定します。

   • NEW_RELIC_DISTRIBUTED_TRACING_ENABLED。 trueに設定します。
   • NEW_RELIC_ACCOUNT_ID。アカウントID 。
   • NEW_RELIC_TRUSTED_ACCOUNT_KEY。これはあなたのアカウントIDでもあります。アカウントが子アカウントの場合、これはルート/親アカウントのアカウントIDである必要があります。

9. オプション：ログを設定するには、AWSコンソールでNEW_RELIC_LOGおよびNEW_RELIC_LOG_LEVEL環境変数を使用します。

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

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

New RelicにはレイヤーレスRubyインストゥルメンテーション メソッドがありません。 レイヤーを使用している場合は、 コンテナー化されていない Lambda 関数の計画に関するドキュメントを参照してください。

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

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

1. NewRelic.agent nuget パッケージをAWS Lambdaプロジェクトに追加します。 詳細については、インストレーション ガイドをご覧ください。
2. 必要な環境変数をプロジェクトに追加します。 エージェントは New Relic に直接接続したりデータを送信したりしないため、 NEW_RELIC_LICENSE_KEY必要ありません。
3. オプションの環境変数を設定します。

• NEW_RELIC_APP_NAME

4. プロジェクトを AWS Lambda アカウントに公開します。
5. New Relic Lambda Extension またはnewrelic-log-ingestionラムダのいずれかを構成します。
6. オプション: ログ記録を設定するには、AWS コンソールでNEWRELIC_LOG_CONSOLEおよびNEWRELIC_LOG_LEVEL環境変数を使用します。
7. Lambda を少なくとも 1 回呼び出してエラーをチェックし、データが New Relic UI に表示されることを確認します。