このページでは、必須およびオプションの環境変数(HTTP プロキシサポートを含む)と、AWS 管理コンソールで変数を入力する方法について説明します。

サーバレストレーサのサポート

Java のバージョン

Java サーバレストレーサは Java 8 をサポートしています。

Node.jsバージョン

Node.js サーバレストレーサは、Node.js 10.x、12.x、および 14.x をサポートしています。

Pythonバージョン

Python サーバレストレーサは、Python 3.6、3.7、および 3.8 をサポートしています。

環境変数の設定

AWS Lambda の Serverless APM をインストゥルメント化するには、次の表に記載されている環境変数を設定する必要があります。AWS 管理コンソールで、すべての該当する情報をキーと値のペアの環境変数として入力します

環境変数を変更すると、既存のインスタンスは、前の値を使用して実行を完了します。すべての新しい要求は、更新された値で実行されます。 

環境変数

説明

デフォルト必須値の例
APPDYNAMICS_ACCOUNT_NAMEAWS Lambda 関数で使用されているコントローラに関連付けられているアカウント名。

<AppDynamics_account_name>

ありcustomer1
APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEYコントローラのアクセスキー。「エージェントとコントローラの接続」を参照してください。<AppDynamics_account_key>はいAB1a2b3c4$123
APPDYNAMICS_APPLICATION_NAMEトレーサがインストゥルメント化されているアプリケーションの名前。<Your_app_name>対応testApp
APPDYNAMICS_CONTROLLER_HOSTAWS Lambda 関数で使用されているコントローラに関連付けられているホスト。http:// または https:// を含めないでください<Controller_host_name>あり<accountname>.saas.appdynamics.com
APPDYNAMICS_CONTROLLER_PORT

コントローラに関連付けられているポート。  


443いいえ8080
APPDYNAMICS_DISABLE_AGENT

サーバレストレーサを無効にし、すべてのサーバレス アプリケーション モニタリングを停止します。

許容値は true および false です。


falseなしtrue
APPDYNAMICS_ENABLE_EUM

AWS Lambda 関数のエンドユーザーモニタリングを有効にするために、Node.js サーバーレストレーサによって使用されます。EUM を有効にするには true に、EUM を無効にするには false に設定します。

詳細については、Node.js サーバレストレーサとエンドユーザモニタリングの統合を参照してください。

falseなしtrue
APPDYNAMICS_EUM_AJAXtrue に設定すると、EUM データは常に Ajax 形式で返されます。たとえば、ADRUM_0, ADRUM_1 などです。falseなしtrue
APPDYNAMICS_HTTP_TIMEOUT_MSトレーサがデータをダウンストリームに送信するための HTTP タイムアウト(ミリ秒)。2000いいえ3000
APPDYNAMICS_LOG_LEVEL

トレーサのログレベル。許容値は DEBUGINFOWARNERROR、および FATAL です。

INFOいいえINFO
APPDYNAMICS_SERVERLESS_API_ENDPOINT

報告先のトレーサの AppDynamics エンドポイント。次の AWS リージョンでは、サーバレス API エンドポイントを使用できます。シドニー、フランクフルト、オレゴン。

<https://your-endpoint-name-api.saas.appdynamics.com/>対応
APPDYNAMICS_TIER_NAME

AWS Lambda 関数の名前。

<Your_tier_name>

デフォルトでは、AWS Lambda 関数の名前が使用されます。

なしserverlessTestTier

HTTP プロキシのサポート

HTTP プロキシサポートを有効にするには、AWS 管理コンソールで次の変数を定義します。

環境変数説明値の例
APPDYNAMICS_HTTP_PROXY_HOSTプロキシのパブリックアクセス可能なホスト名。myproxy.example.com
APPDYNAMICS_HTTP_PROXY_PORTプロキシが実行されているポート。8080
APPDYNAMICS_HTTP_PROXY_SERVER_CERTIFICATEプロキシサーバの証明書への相対パス。プロキシサーバがプロキシを信頼する AWS Lambda 関数の自己署名証明書で実行されている場合に必要。プロキシサーバを信頼するようにランタイム環境を設定している場合はこの変数は必要ありません。resources/proxy-cert.pem

さらに、プロキシサーバの基本認証のクレデンシャルを追加することもできます。AWS 管理コンソールに次の変数を追加します。

環境変数説明値の例

APPDYNAMICS_HTTP_PROXY_USER

基本認証に関連付けられているユーザ名。user1

APPDYNAMICS_HTTP_PROXY_PASSWORD

プロキシサーバの基本認証パスワードへの相対パス。AWS Lambda 関数を信頼するためにプロキシサーバのパスワードが必要です。password123

APPDYNAMICS_HTTP_PROXY_PASSWORD_FILE

プロキシサーバの基本認証パスワードファイルへのプレーンテキストファイル。プロキシサーバのパスワードファイルを含むように展開パッケージを更新します。AWS Lambda 関数を信頼するためにプロキシサーバのパスワードが必要です。resources/proxy-password.txt

基本ログイン情報を追加する場合は、APPDYNAMICS_HTTP_PROXY_PASSWORD または APPDYNAMICS_HTTP_PROXY_PASSWORD_FILE を含める必要があります。両方を含めた場合、トレーサは APPDYNAMICS_HTTP_PROXY_PASSWORD_FILE を渡すだけです。

AWS コンソールでの環境変数の追加

AWS 管理コンソールを使用して環境変数を追加する場合:

  1. AWS 管理コンソールにサインインします。
  2. [AWS Services] に移動して [Lambda] を開きます。
  3. AWS Lambda 関数を選択します。 
  4. [Environment variables] に移動して、関数のキーと値のペアの環境変数を入力します。
  5. Save をクリックします。

次の図は、必要なすべての環境変数の例を示しています

Environment Variables (AWS Management Console)

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