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

環境変数の設定

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

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

環境変数
説明
必須値の例
APPDYNAMICS_ACCOUNT_NAMEAWS Lambda 関数で使用されているコントローラに関連付けられているアカウント名。[はい（Yes）] に設定customer1
APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEYコントローラのアクセスキー。「エージェントとコントローラの接続」を参照してください。[はい（Yes）] に設定AB1a2b3c4 $ 123
APPDYNAMICS_APPLICATION_NAMEトレーサがインストゥルメント化されているアプリケーションの名前。[はい（Yes）] に設定testApp
APPDYNAMICS_CONTROLLER_HOSTAWS Lambda 関数で使用されているコントローラに関連付けられているホスト。http:// または https:// を含めないでください[はい（Yes）] に設定<accountname>.saas.appdynamics.com
APPDYNAMICS_SERVERLESS_API_ENDPOINT

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

[はい（Yes）] に設定
  • アジア太平洋（シドニー）： https://syd-sls-agent-api.saas.appdynamics.com
  • EU（フランクフルト）： https://fra-sls-agent-api.saas.appdynamics.com
  • 米国西部（オレゴン）： https://pdx-sls-agent-api.saas.appdynamics.com
APPDYNAMICS_CONTROLLER_PORT

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

ポートが空白のままの場合、または無効な場合、デフォルトは 443 です

[いいえ（No）]8080
APPDYNAMICS_LOG_LEVEL

トレーサのログレベル。許容値は DEBUG、INFO、WARN、ERROR、FATAL。

指定されない場合のデフォルトは INFO です。

[いいえ（No）]INFO
APPDYNAMICS_TIER_NAME

AWS Lambda 関数のティア名。この変数を使用して、ティアに別の 名前を指定します。

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

[いいえ（No）]serverlessTestTier
APPDYNAMICS_DISABLE_AGENT

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

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

デフォルトは false です。

なしtrue
APPDYNAMICS_ENABLE_EUM

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

デフォルトは false です。

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

なしTrue


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] をクリックします。

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

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