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

Go Lambda プロジェクト instalambda にこのモジュールを追加するには、ファイル go.mod が含まれているフォルダから次のコマンドを実行してください：

go get github.com/instana/go-sensor/instrumentation/instalambda

このコマンドを実行すると、インスツルメンテーション・モジュールがプロジェクトの依存関係リストおよびメインの Go Tracerに追加されます。

以下のコードスニペットは、 Go で記述された典型的な AWS Lambda 関数を示しています：

package main

import (
    "github.com/aws/aws-lambda-go/lambda"
)

func main() {
    lambda.Start(Handle)
}

func Handle() (string, error) {
    // handler code
}

ハンドラ関数は最大2つの引数を受け取り、返すことができます。 ただし、ハンドラ関数が2つの引数を受け取る場合、最初の引数は を実装している必要があります context.Context。

ハンドラー関数を装備するには、以下のステップを実行します。

1. 元のハンドラ関数から、 を使用して instalambda.NewHandler() 、計測機能を備えたハンドラを作成します。
2. インスツルメント・ハンドラーを lambda.StartHandler()に渡します。 以下のスニペットは、コード変更を示しています。

package main

import (
    "github.com/aws/aws-lambda-go/lambda"

    // Import the in-process sensor and instrumentation packages
    instana "github.com/instana/go-sensor"
    "github.com/instana/go-sensor/instrumentation/instalambda"
)

func main() {
    // Initialize the instana.Sensor instance
    sensor := instana.NewSensor("my-lambda-handler")

    // Create an instrumented handler from your handler function
    h := instalambda.NewHandler(Handle, sensor)

    // Pass the handler to the lambda.StartHandler() invoke loop
    lambda.StartHandler(h)
}

func Handle() (string, error) {
    // handler code
}

以下のコードスニペットは、次のように実装された典型的な AWS Lambdalambda.Handlerハンドラを示しています：

package main

import (
    "github.com/aws/aws-lambda-go/lambda"
)

func main() {
    h := &Handler{
        // handler configuration
    }

    lambda.StartHandler(h, sensor)
}

type Handler struct {
    // ...
}

func (h *Handler) Invoke(ctx context.Context, payload []byte) ([]byte, error) {
    // handler code
}

このようなハンドラーを実装するには、それを で囲み instalambda.WrapHandler() 、: に渡します labmda.StartHandler()

package main

import (
    "github.com/aws/aws-lambda-go/lambda"

    // Import the in-process sensor and instrumentation packages
    instana "github.com/instana/go-sensor"
    "github.com/instana/go-sensor/instrumentation/instalambda"
)

func main() {
    // Initialize the instana.Sensor instance
    sensor := instana.NewSensor("my-lambda-handler")

    h := &Handler{
        // handler configuration
    }

    // Wrap and pass the handler to the lambda.StartHandler() invoke loop
    lambda.StartHandler(instalambda.WrapHandler(h, sensor))
}

type Handler struct {
    // ...
}

func (h *Handler) Invoke(ctx context.Context, payload []byte) ([]byte, error) {
    // handler code
}

トレース・コンテキスト伝搬を使用可能にするには、ハンドラー・コードを更新せずに main() 関数にいくつかの変更を加える必要がある最小限のインスツルメンテーションが必要です。 ただし、ハンドラー関数の引数のリストに context.Context を追加することはできます。 context.Context を引数として追加すると、 instalambda は Lambda トリガー・イベントのスパンをコンテキストに注入します。 これらのスパンを instana.SpanFromContext() で取得し、それらを親として使用して、ハンドラー内で行われる内部呼び出しおよび外部呼び出しをトレースすることができます。

func MyHandler(ctx context.Context) error {
    // Pass the handler context to a subcall to trace its execution
    subCall(ctx)

    // ...

    // Propagate the trace context within an HTTP request to another service monitored with Instana
    // using an instrumented http.Client
    req, err := http.NewRequest("GET", url, nil)
    client := &http.Client{
        Transport: instana.RoundTripper(sensor, nil),
    }

    client.Do(req.WithContext(ctx))

    // ...
}

func subCall(ctx context.Context) {
    if parent, ok := instana.SpanFromContext(ctx); ok {
        // start a new span, using the Lambda entry span as a parent
        sp = parent.Tracer().StartSpan(/* ... */)
        defer sp.Finish()
    }

    // ...
}