通过观测云 DataKit Extension 接入 AWS Lambda 最佳实践

作者：观测云

2024-10-10
上海
本文字数：2284 字
阅读完需：约 7 分钟

通过观测云 DataKit Extension 接入 AWS Lambda 最佳实践

前言

AWS Lambda 是一项计算服务，使用时无需预配置或管理服务器即可运行代码。AWS Lambda 只在需要时执行代码并自动缩放。借助 AWS Lambda，几乎可以为任何类型的应用程序或后端服务运行代码，而且无需执行任何管理。

Lambda Layer 是一个包含补充代码或数据的 .zip 文件存档，通常包含库依赖项、自定义运行时系统或配置文件。Lambda 扩展则是可以增强 Lambda 函数的功能，例如集成监控、安全性和监管工具等。

在本文中，我们将引导您了解如何将观测云服务集成到 AWS Lambda，通过配置 Lambda 层、设置环境变量，实现 Lambda 函数的指标、日志和链路采集。

前提条件

确保您拥有 AWS 账户，并且具备管理 Lambda 函数的权限。
已注册观测云账号

第 1 步：创建 Lambda 层

1、打开 AWS Lambda 控制台并导航至「Layers」页面。

2、点击「Create layer」，创建一个新的层。

3、在「Layer configuration」中，填写层的名称。

4、选择「Upload a .zip file」并上传以下链接对应的文件：

AMD 架构：https://static.guance.com/datakit/datakit_aws_extension-linux-amd64.zip
ARM 架构：https://static.guance.com/datakit/datakit_aws_extension-linux-arm64.zip

第 2 步：复制 ARN 并添加层到 Lambda 函数

创建成功后，复制层的 ARN 值。

在 Lambda 函数配置中添加此 ARN 到 Layers 部分。

第 3 步：配置环境变量

设置以下环境变量以确保数据正确传输到观测云：

Datakit 监听的地址名

DD_AGENT_HOST: 0.0.0.0

Datakit 监听的端口号

DD_TRACE_AGENT_PORT: 9529

DataWay 真实地址

ENV_DATAWAY: https://xxxx.guance.com?token=<your-token>

第 4 步：日志、链路和指标采集

日志采集

支持采集控制台日志。

Node.js 18.x 和 Go 日志采集示例。

链路采集

使用 OpenTelemetry 或 DDTrace 进行链路采集
对于 Go 语言，需要在业务代码中添加相应的追踪代码。Go 代码示例较为复杂，需要修改业务代码，示例如下：

package main
import (        "context"        "fmt"        "github.com/aws/aws-lambda-go/lambda"        "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/ext"        "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"        "os"        "time")
type MyEvent struct {        Name string `json:"name"`}
func HandleRequest(ctx context.Context, event *MyEvent) (*string, error) {        return run(ctx, event)}
func run(ctx context.Context, event *MyEvent) (*string, error) {        tracer.Start(                tracer.WithEnv("prod"),                tracer.WithService("test-file-read"),                tracer.WithServiceVersion("1.2.3"),                tracer.WithGlobalTag("project", "add-ddtrace-in-golang-project"),                tracer.WithLambdaMode(false),        )
        // end of app exit, make sure tracer stopped        defer tracer.Stop()
        tick := time.NewTicker(time.Second)        defer tick.Stop()        ctx, cancel := context.WithTimeout(ctx, time.Minute*2)        defer cancel()        // your-app-main-entry...        for {                runApp()                runAppWithError()
                select {                case <-tick.C:                case <-ctx.Done():                        message := fmt.Sprintf("Hello %s!", event)                        return &message, nil                }        }}
func main() {        //run(context.Background(), &MyEvent{Name: "Hello World!"})        lambda.Start(HandleRequest)}
func runApp() {        var err error        // Start a root span.        span := tracer.StartSpan("get.data")        defer span.Finish(tracer.WithError(err))
        // Create a child of it, computing the time needed to read a file.        child := tracer.StartSpan("read.file", tracer.ChildOf(span.Context()))        child.SetTag(ext.ResourceName, os.Args[0])
        // Perform an operation.        var bts []byte        bts, err = os.ReadFile(os.Args[0])        span.SetTag("file_len", len(bts))        child.Finish(tracer.WithError(err))}
func runAppWithError() {        var err error        // Start a root span.        span := tracer.StartSpan("get.data")
        // Create a child of it, computing the time needed to read a file.        child := tracer.StartSpan("read.file", tracer.ChildOf(span.Context()))        child.SetTag(ext.ResourceName, "somefile-not-found.go")
        defer func() {                child.Finish(tracer.WithError(err))                span.Finish(tracer.WithError(err))        }()
        // Perform an error operation.        if _, err = os.ReadFile("somefile-not-found.go"); err != nil {                // error handle        }}