このトピックでは、必須およびオプションの環境変数(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

トレーサのログレベル。許容値は DEBUGINFOWARNERRORFATAL

指定されない場合のデフォルトは 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. またはその関連会社の商標です。