跳到主要内容
跳到主要内容

AWS Lambda

本指南集成以下内容：

✅ 日志✅ 指标✅ 链路追踪

安装 OpenTelemetry Lambda 层​

OpenTelemetry 项目提供了独立的 Lambda 层，用于：

  1. 使用 OpenTelemetry 自动埋点功能自动为你的 Lambda 函数代码进行监测。
  2. 将收集到的日志、指标和链路追踪数据转发到 ClickStack。

添加特定语言的自动埋点层​

特定语言的自动埋点 Lambda layer 会使用适用于该语言的 OpenTelemetry 自动埋点包，自动对你的 Lambda 函数代码进行埋点。

每种语言和每个 Region 都有各自的 layer ARN。

如果你的 Lambda 已经通过 OpenTelemetry SDK 完成埋点，可以跳过此步骤。

开始操作：

  1. 在 Layers 部分点击 “Add a layer”
  2. 选择 “Specify an ARN”，并根据语言选择对应的 ARN，确保将 <region> 替换为你的 Region（例如 us-east-2）：
arn:aws:lambda:<region>:184161586896:layer:opentelemetry-nodejs-0_7_0:1

这些 layer 的最新发布版本可在 OpenTelemetry Lambda Layers GitHub 仓库 中查看。

  1. 在 Lambda 函数的 “Configuration” > “Environment variables” 中配置以下环境变量。
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler
OTEL_PROPAGATORS=tracecontext
OTEL_TRACES_SAMPLER=always_on

安装 OpenTelemetry collector Lambda layer​

collector Lambda layer 允许你将日志、指标和追踪从 Lambda 函数转发到 ClickStack，同时不会因为导出器延迟而影响响应时间。

安装 collector layer 的步骤如下：

  1. 在 Layers 部分点击“Add a layer”
  2. 选择“Specify an ARN”，并根据架构选择正确的 ARN，确保将 <region> 替换为你的区域（例如 us-east-2）：
arn:aws:lambda:<region>:184161586896:layer:opentelemetry-collector-amd64-0_8_0:1
  1. 将以下 collector.yaml 文件添加到你的项目中，用于配置 collector 将数据发送到 ClickStack：
# collector.yaml \{#collectoryaml}
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 'localhost:4317'
      http:
        endpoint: 'localhost:4318'

processors:
  batch:
  decouple:

exporters:
  otlphttp:
    endpoint: "<YOU_OTEL_COLLECTOR_HTTP_ENDPOINT>
    headers:
      authorization: <YOUR_INGESTION_API_KEY>
    compression: gzip

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp]
    metrics:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp]
    logs:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp]
  1. 添加如下环境变量：
OPENTELEMETRY_COLLECTOR_CONFIG_FILE=/var/task/collector.yaml

检查安装情况​

在部署这些层之后，你现在应该可以在 HyperDX 中看到从 Lambda 函数自动收集到的 trace。decouple 和 batching processor 可能会在遥测数据收集过程中引入一定延迟，因此 trace 的展示可能会有所滞后。要发送自定义日志或指标，你需要使用与你所用编程语言对应的 OpenTelemetry SDKS 对代码进行埋点（instrumentation）。

疑难排解​

自定义埋点未发送​

如果您看不到手动定义的 trace 或其他遥测数据，可能是因为使用了不兼容版本的 OpenTelemetry API 包。请确保您的 OpenTelemetry API 包版本不高于 AWS Lambda 中所包含的版本。

启用 SDK 调试日志​

将 OTEL_LOG_LEVEL 环境变量设置为 DEBUG，以启用 OpenTelemetry SDK 的调试日志。这有助于确保自动埋点层已正确对应用程序进行埋点。

启用 collector 调试日志​

若要排查 collector 问题，可以通过修改 collector 配置文件，添加 logging exporter，并将遥测日志级别设置为 debug，以启用来自 collector Lambda 层的更详细日志记录。

# collector.yaml \{#collectoryaml}
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 'localhost:4317'
      http:
        endpoint: 'localhost:4318'

exporters:
  logging:
    verbosity: detailed
  otlphttp:
    endpoint: "https://in-otel.hyperdx.io"
    headers:
      authorization: <您的摄取_API_密钥>
    compression: gzip

service:
  telemetry:
    logs:
      level: "debug"
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp, logging]
    metrics:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp, logging]
    logs:
      receivers: [otlp]
      processors: [batch, decouple]
      exporters: [otlphttp, logging]