Java ベースの AWS Lambda 関数に対するネイティブトレースの設定

Java や、 Java 仮想マシン( JVM )をベースとした Kotlin などの言語で記述された AWS Lambda 関数に対して、 Instana ( AutoTrace )を設定できます。

詳細については、 Instana および AutoTrace をご覧ください。

Java ベースの AWS Lambda 関数でネイティブトレースを設定するには、Lambda関数に Instana のLambdaレイヤーを追加する必要があります。 トレースを有効にすると、 Instana のUIで、 Java をベースとする AWS Lambda 関数に関連するすべてのリクエストのトレースを確認できます。

AWS Lambda 関数の設定

注:AWS Lambda ランタイム内部からバージョン情報やランタイムメトリクスを収集するには、 Lambdaモニタリング用のInstana ( AWS )エージェントを必ず設定してください。

AWS Web コンソールまたは以下のいずれかの AWS 管理ツールを使用して、Lambda 関数のトレースを有効にすることができます。

AWS Webコンソールでのトレース機能を有効にする

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

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

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

      層

    2. 「関数にレイヤーを追加」ウィンドウで、 「レイヤーバージョンの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. 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レイヤーは、常に最新バージョンを使用するようにしてください。 定期的に使用するレイヤー・バージョンを更新して、レイヤーの新規バージョンによって提供されるフィーチャーおよびフィックスを利用できるようにします。