Ruby のLambda関数に対するトレースの設定

AWS のWebコンソールで Ruby のLambda関数のトレースを有効にするには、以下の手順を実行してください：

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

   1. Lambda 関数の設定ページで、 「レイヤー」 をクリックします。

      

   2. [ レイヤー] ボックスで、 [レイヤーを追加] をクリックします。

      

   3. 「 レイヤーの追加」 ページで、レイヤーのソースとして 「ARNを指定」 オプションを選択します。

   4. 「ARNを指定 」フィールドに、ご利用のリージョンに対応する「 Instana 」LambdaレイヤーのARNをコピーして貼り付けてください。 「 Instana 」Lambdaレイヤーに対応するARNは、 「 Instana 」 の「Lambdaレイヤー」セクションで確認できます。

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

      

2. ハンドラ関数を実装する：

   次の例に示すように、 Ruby のラムダ関数を ` Instana.serverless.wrap_aws block` で囲み、イベントとコンテキストを引数として渡します。 このラッパーは、Lambdaの呼び出しに対して自動的にspanを生成し、トレースコンテキストを処理します。

   require 'bundler/setup'
   
   require 'json'
   require 'instana'
   
   def lambda_handler(event:, context:)
     Instana.serverless.wrap_aws(event, context) do
       # Your original Lambda function code goes here
       {
         statusCode: 200,
         body: {
           message: "Hello World!",
         }.to_json
       }
     end
   end
    

   ラッパー方式を採用すれば、既存のハンドラ関数の名前を維持したまま、 Instana のトレース機能を追加することができます。 AWS コンソールでLambdaハンドラーの設定を変更する必要はありません。

3. 環境変数を設定します。

   以下の環境変数を追加します。

   • INSTANA_ENDPOINT_URL: サーバーレス監視のエンドポイント。 該当するリージョン用の、https://serverless- で始まる適切な値を使用していることを確認してください。
   • INSTANA_AGENT_KEY: エージェントキー。
   • LAMBDA_HANDLER: デフォルトのハンドラーを使用していない場合 lambda_function.lambda_handler、独自のハンドラー。

   これらの環境変数の正しい値は、 Instana のUIからも確認できます。 これらの環境変数の正しい値を取得するには、 [データソース] > [エージェントのインストール ] > [ AWS Lambda ] をクリックします。

以下の例は、 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={INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , LAMBDA_HANDLER=...}""