Lambda 監視のためのレイヤーレス インストゥルメンテーション

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でもあります。アカウントが子アカウントの場合、これはroot/親アカウントのアカウント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コードで、ファイルの先頭にエージェントモジュールを要求し、ハンドラー関数をラップします。例えば：

   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();
   });

   コピー

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

   module.exports.handler = 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 環境で実行すると、エージェントは自動的にサーバーレス モードで実行されます。 Do not use this variable if you're running in 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. 少なくとも1回Lambdaを呼び出します。これにより、CloudWatchロググループが作成されます。次のステップではこのグループが必要です。

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

    Lambdaで関数ログを送信する 方法の詳細を読む。

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

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

   bash

   コピー

   $
   pip install -t . newrelic

   重要

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

2. Lambda コードで、Python エージェント モジュールをインポートし、New Relic デコレーターを使用してハンドラー関数を装飾します。 The New Relic package must be imported first in your code.次に例を示します。

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

   コピー

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

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

   コピー

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

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

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

6. AWSコンソールで、以下の環境変数を設定します。

   • NEW_RELIC_SERVERLESS_MODE_ENABLED。に設定 true

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

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

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

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

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