Java ベースの AWS Lambda 関数に対するネイティブトレースの設定
Java や、 Java 仮想マシン( JVM )をベースとした Kotlin などの言語で記述された AWS Lambda 関数に対して、 Instana ( AutoTrace )を設定できます。
詳細については、 Instana および AutoTrace をご覧ください。
Java ベースの AWS Lambda 関数でネイティブトレースを設定するには、Lambda関数に Instana のLambdaレイヤーを追加する必要があります。 トレースを有効にすると、 Instana のUIで、 Java をベースとする AWS Lambda 関数に関連するすべてのリクエストのトレースを確認できます。
サポートされるランタイム
Instana JVM、 1.8 以降に対応しています。
AWS Lambda 関数の設定
AWS Web コンソールまたは以下のいずれかの AWS 管理ツールを使用して、Lambda 関数のトレースを有効にすることができます。
AWS Webコンソールでのトレース機能を有効にする
JVM 内で実行されているLambda関数のトレースを有効にするには、 AWS Lambda のUIで以下の手順を実行してください:
関数に Instana のLambdaレイヤーを追加します:
Lambda 関数の 「構成」 タブで、 「層」 > 「層の追加」をクリックします。

「関数にレイヤーを追加」ウィンドウで、 「レイヤーバージョンのARNを指定する 」を選択し、ご利用のリージョンに対応する Instana LambdaレイヤーのAmazon Resource Name(ARN)をコピーして貼り付けます。 Instana のLambdaレイヤーに対応するARNは、 「 Instana のLambdaレイヤー 」セクションで確認できます。

追加 をクリックします。
以下の環境変数を構成します。
環境変数 値 JAVA_TOOL_OPTIONS-javaagent:/opt/instana/standalone-collector.jarINSTANA_ENDPOINT_URL<serverless_instana_endpoint>`INSTANA_AGENT_KEY<your_instana_agent_key>注: お住まいの地域に対応した、.https://serverless-で始まる正しい値を使用していることを確認してください。 詳細については、 「サーバーレス監視のエンドポイント」 を参照してください。これらの環境変数の正しい値は、 Instana のUIからも確認できます。 これらの環境変数の正しい値を取得するには、 Instana のUIで、[詳細 ] > [ エージェント] > [ エージェントのインストール] > [ プラットフォーム]: AWS > [テクノロジー]: AWS Lambda の順にクリックしてください。
Lambda 関数定義を保存します。

AWS のコマンドラインインターフェースでトレースを有効にする
AWS のLambda関数における 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 |
|---|---|
af-south-1 |
arn:aws:lambda:ap-northeast-1:410797082306:layer:instana-java:142 |
ap-east-1 |
arn:aws:lambda:ap-east-1:410797082306:layer:instana-java:69 |
ap-northeast-1 |
arn:aws:lambda:ap-northeast-1:410797082306:layer:instana-java:142 |
ap-northeast-2 |
arn:aws:lambda:ap-northeast-2:410797082306:layer:instana-java:140 |
ap-northeast-3 |
arn:aws:lambda:ap-northeast-3:410797082306:layer:instana-java:69 |
ap-south-1 |
arn:aws:lambda:ap-south-1:410797082306:layer:instana-java:140 |
ap-south-2 |
arn:aws:lambda:ap-south-2:410797082306:layer:instana-java:69 |
ap-southeast-1 |
arn:aws:lambda:ap-southeast-1:410797082306:layer:instana-java:140 |
ap-southeast-2 |
arn:aws:lambda:ap-southeast-2:410797082306:layer:instana-java:140 |
ap-southeast-3 |
arn:aws:lambda:ap-southeast-3:410797082306:layer:instana-java:69 |
ap-southeast-4 |
arn:aws:lambda:ap-southeast-4:410797082306:layer:instana-java:69 |
ca-central-1 |
arn:aws:lambda:ca-central-1:410797082306:layer:instana-java:140 |
cn-north-1 |
arn:aws-cn:lambda:cn-north-1:107998019096:layer:instana-java:36 |
cn-northwest-1 |
arn:aws-cn:lambda:cn-northwest-1:107998019096:layer:instana-java:45 |
eu-central-1 |
arn:aws:lambda:eu-central-1:410797082306:layer:instana-java:132 |
eu-central-2 |
arn:aws:lambda:eu-central-2:410797082306:layer:instana-java:58 |
eu-north-1 |
arn:aws:lambda:eu-north-1:410797082306:layer:instana-java:129 |
eu-south-1 |
arn:aws:lambda:eu-south-1:410797082306:layer:instana-java:58 |
eu-south-2 |
arn:aws:lambda:eu-south-2:410797082306:layer:instana-java:58 |
eu-west-1 |
arn:aws:lambda:eu-west-1:410797082306:layer:instana-java:129 |
eu-west-2 |
arn:aws:lambda:eu-west-2:410797082306:layer:instana-java:129 |
eu-west-3 |
arn:aws:lambda:eu-west-3:410797082306:layer:instana-java:129 |
il-central-1 |
arn:aws:lambda:il-central-1:410797082306:layer:instana-java:55 |
me-central-1 |
arn:aws:lambda:me-central-1:410797082306:layer:instana-java:55 |
me-south-1 |
arn:aws:lambda:me-south-1:410797082306:layer:instana-java:null |
sa-east-1 |
arn:aws:lambda:sa-east-1:410797082306:layer:instana-java:121 |
us-east-1 |
arn:aws:lambda:us-east-1:410797082306:layer:instana-java:121 |
us-east-2 |
arn:aws:lambda:us-east-2:410797082306:layer:instana-java:121 |
us-west-1 |
arn:aws:lambda:us-west-1:410797082306:layer:instana-java:121 |
us-west-2 |
arn:aws:lambda:us-west-2:410797082306:layer:instana-java:121 |
パターンは、 arn:aws:lambda:${region}:410797082306:layer:instana-java:${layer-version} (中国の AWS 地域の場合は arn:aws-cn:lambda:${region}:107998019096:layer:instana-java:${layer-version} ) です。
オプション:その他の環境設定の構成
Instana のLambdaトレーサーに関する環境設定の詳細については、 「 Instana のLambdaトレーサーのその他の設定」を参照してください。