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
}

핸들러 함수는 최대 두 개의 인자를 받아 반환할 수 있으며, 단, 두 개의 인자를 받는 경우 첫 번째 인자는 반드시 를 구현해야 한다는 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()
    }

    // ...
}