このページでは、実行時にサーバレストレーサを挿入するための推奨方法である AppDynamics AWS Lambda Extension for Serverless APM の使用方法について説明します。このオプションを使用して、Node.js または Python アプリケーションにレイヤを動的に追加します。

限定可用性リリースの免責事項

このドキュメントに現在記載されている機能は、限定リリースの一部として利用できます。AppDynamics は、一般提供の開始(および一般提供の中止)の前であれば、いつでも機能を変更する権利を留保します。購入に関する決定は、現在一般的に利用可能な機能と製品に基づいて行う必要があります。

はじめる前に

AWS Lambda 向けサーバレス APM に登録し、環境変数を設定すると、インストゥルメンテーションを開始できます。セットアップが次の要件を満たしていることを確認します。

  • 既存の AWS Lambda 関数が Node.js バージョン 10.x 以降または Python 3.6 以降で作成されている
  • AWS Lambda 向けアクティブサーバレス APM のサブスクリプション
  • AppDynamics SaaS コントローラバージョン 4.5.11 以降
  • サポートされる AWS リージョン:eu-central-1、eu-north-1、eu-west-1、eu-west-2、eu-west-3、ap-northeast-1、ap-northeast-2、ap-south-1、ap-southeast-1、ap-southeast-2、ca-central-1、sa-east-1、us-east-1、us-east-2、us-west-1、us-west-2

AWS Lambda レイヤを使用して実行時にサーバレストレーサを挿入する

Node.js または Python サーバレストレーサをインストールするには、AppDynamics AWS Lambda Extension for Serverless APM を実装するレイヤを使用するように Lambda 関数を構成します。

AWS Lambda Extension を関数に追加する

Amazon から AppDynamics レイヤをプルするには、AWS Management Console UI または AWS CLI を使用して、Lambda に Amazon Resource Number(ARN)を追加します。

  1. AWS Lambda Extension を関数に追加する
  2. 環境変数の設定

AWS UI を使用した Lambda 関数のインストゥルメント化

  1. AWS Management Console コンソールで、[Compute > Lambda] を選択します。
  2. [AWS Lambda] 画面から、インストゥルメント化するラムダを選択します。 
  3. [Layers] を選択します。
  4. クリック Add a layer.
  5. [Choose a layer] で、[Specify an ARN. ] を選択します。
  6. [Specify an ARN, ] で、AWS レイヤ情報を入力します。

    arn:aws:lambda:us-west-2:338050622354:layer:appdynamics-lambda-extension:6
    BASH

    ARN リージョンは、ラムダが展開されている AWS リージョンに基づいて変更されます。たとえば、ラムダが Europe (Frankfurt) eu-central-1 の場合、次を使用します。

    arn:aws:lambda:eu-central-1:338050622354:layer:appdynamics-lambda-extension:6
    BASH
  7. クリック Add.

  8. レイヤがラムダに追加されたことを確認するには、[Layers] をクリックします。[Layers] の下に、[appdynamics-lambda-extension] が表示されます。

  9. 環境変数の設定」を参照してください。

AWS CLI を使用した Lambda 関数のインストゥルメント化

AWS CLI を使用して Amazon から AppDynamics レイヤをプルするには、次の手順を実行します。

  1. レイヤを使用するための関数の設定」を参照してください。
  2. 環境変数の設定」を参照してください。

環境変数の設定

AWS Lambda へのトレーサの挿入を完了するには、プログラミング言語とバージョンに応じて環境変数を構成します。

Node 10.x、Node 12.x、および Python 3.8

環境変数 AWS_LAMBDA_EXEC_WRAPPER を値 /opt/appdynamics-extension-script: で追加します。

AWS_LAMBDA_EXEC_WRAPPER = /opt/appdynamics-extension-script
BASH

Python 3.6 および Python 3.7 の場合

環境変数 APPDYNAMICS_PYTHON_AUTOINSTRUMENT を値を true: に設定して追加します。

APPDYNAMICS_PYTHON_AUTOINSTRUMENT = true
BASH

サーバレス トレーサ インストゥルメンテーションの確認

サーバレス トレーサ インストゥルメンテーションの確認」を参照してください。

これらのマニュアルで使用されている Amazon Web サービス、AWS ロゴ、AWS、およびその他の AWS マークは、米国およびその他の国における Amazon.com, Inc. またはその関連会社の商標です。