Java ベースの AWS Lambda 関数のネイティブ・トレースのセットアップ

AWS ウェブコンソールからトレースを有効にする

JVM 内部で実行されている Lambda 関数のトレースを有効にするには、 AWS Lambda UI で以下のステップを実行します。

1. Instana Lambda レイヤーを関数に追加します。

   1. Lambda 関数の 「構成」 タブで、 「層」 > 「層の追加」をクリックします。

      

   2. 「Add layer to function」ウィンドウで、 「Provide a layer version ARN」を選択し、ご使用の地域に一致する Instana Lambda レイヤーの Amazon リソース名 (ARN) をコピーして貼り付けます。 Instana Lambda レイヤーの正しい ARN は、 「Instana Lambda レイヤー」 セクションにあります。

      

   3. 追加 をクリックします。

2. 以下の環境変数を構成します。

   環境変数	値
   JAVA_TOOL_OPTIONS	-javaagent:/opt/instana/standalone-collector.jar
   INSTANA_ENDPOINT_URL	<serverless_instana_endpoint>`
   INSTANA_AGENT_KEY	<your_instana_agent_key>

   https://serverless-で始まる領域に対して正しい値を使用していることを確認してください。 詳しくは、 サーバーレス・モニターのエンドポイントを参照してください。

   これらの環境変数の正しい値を Instana UI から取得することもできます。 これらの環境変数の正しい値を取得するには、Instana UI で 「More」 > 「Agents」 > 「Install Agents」 > Platform: AWS > Technology: AWS Lambda をクリックします。

3. Lambda 関数定義を保存します。

   

AWS コマンドラインインターフェイスからトレースを有効にする

AWS Lambdas の Instana 統合を自動化する場合は、以下の AWS CLI コマンドの例を参照してください。

# Do not copy and paste this verbatim!
# It will overwrite any previously defined collection of layers and
# environment variables.
aws --region $YOUR_REGION lambda update-function-configuration \
  --function-name $YOUR_LAMBDA_FUNCTION_NAME \
  --layers $INSTANA_LAYER_ARN \
  --environment ""Variables={JAVA_TOOL_OPTIONS=-javaagent:/opt/instana/standalone-collector.jar, INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , ...}""

Instana Lambda レイヤー

領域に応じた Java 用の最新バージョンの AWS Lambda レイヤーの ARN は、以下のとおりです。

パターンは、 arn:aws:lambda:${region}:410797082306:layer:instana-java:${layer-version} (中国の AWS 地域の場合は arn:aws-cn:lambda:${region}:107998019096:layer:instana-java:${layer-version} ) です。

常に最新バージョンの Instana Lambda レイヤーを使用するようにしてください。 定期的に使用するレイヤー・バージョンを更新して、レイヤーの新規バージョンによって提供されるフィーチャーおよびフィックスを利用できるようにします。