Javaベースの AWS ラムダ関数にネイティブ・トレースを設定する

JVM内で実行されているLambda関数のトレースを有効にするには、 AWS Lambda UIで以下の手順を実行します：

1. インスタナラムダレイヤーを関数に追加します：

   1. Lambda関数の Configuration タブで、 Layers > Add a layerをクリックします。

      

   2. Add layer to function" ウィンドウで、" Provide a layer version ARN" を選択し、地域に一致する Instana Lambda レイヤーの Amazon Resource Name (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 で [詳細 ] > [エージェント] > [エージェントのインストール] > [プラットフォーム: AWS > [テクノロジー: AWS Lambda] をクリックします。

3. ラムダ関数の定義を保存する。

   

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=... , ...}""

AWS Lambda layers for Java の最新バージョンの地域別ARNは以下の通り：

パターンは arn:aws:lambda:${region}:410797082306:layer:instana-java:${layer-version} （中国の AWS 地域は arn:aws-cn:lambda:${region}:107998019096:layer:instana-java:${layer-version} ）。