Ruby Lambda関数のトレース設定

AWS ウェブ・コンソールから Ruby Lambda 関数のトレースを有効にするには、以下の手順を実行します：

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

   1. ラムダ関数の設定ページで、 レイヤーをクリックする。

      

   2. レイヤー・ボックスで、 レイヤーの追加をクリックする。

      

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

   4. Specify an ARN (ARN の指定 )] フィールドに、お住まいの地域に一致する Instana Lambda Layer の ARN をコピーして貼り付けます。 Instana Lambda Layer の正しい ARN は、 Instana Lambda Layers セクションで見つけることができます。

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

      

2. ハンドラ関数をインストルメント化する：

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

   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 コンソールでラムダ・ハンドラの設定を変更する必要はない。

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

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

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

   これらの環境変数の正しい値は、Instana UI から取得することもできます。 これらの環境変数の正しい値を取得するには、 データソース > エージェントのインストール > 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={INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , LAMBDA_HANDLER=...}""