Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

AWS Lambda

View as MarkdownEdit this pageReport an issueSet up docs MCP

本指南支持以下集成：

✅ 日志✅ 指标✅ 链路追踪

安装 OpenTelemetry Lambda layer

OpenTelemetry 项目提供了独立的 Lambda layer，分别用于：

  1. 使用 OpenTelemetry 自动插桩功能，自动为 Lambda 函数代码添加插桩。
  2. 将采集到的日志、指标和链路追踪转发到 ClickStack。

添加特定语言的自动插桩 layer

特定语言的自动插桩 Lambda layer 会使用适用于相应语言的 OpenTelemetry 自动插桩包，自动为你的 Lambda 函数代码启用插桩。

每种语言和区域都有各自对应的 layer ARN。

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

开始使用：

  1. 在 Layers 部分中点击 “Add a layer”
  2. 选择 specify an ARN，并根据语言选择正确的 ARN；请确保将 <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 function 的日志、指标和链路追踪转发到 ClickStack，且不会因 exporter 延迟而影响响应时间。

安装 collector layer：

  1. 在 Layers 部分中，点击 "Add a layer"
  2. 选择指定 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
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 'localhost:4317'
      http:
        endpoint: 'localhost:4318'

processors:
  batch:
  decouple:

exporters:
  otlphttp:
    endpoint: "<YOU_OTEL_COLLECTOR_HTTP_ENDPOINT>"
    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

检查安装

部署这些 layer 后，你现在应该能在 HyperDX 中看到从 Lambda 函数自动收集到的链路追踪。decouple 和 batching 处理器可能会导致可观测数据收集出现延迟，因此链路追踪可能不会立即显示。若要发送自定义日志或指标，你需要使用特定语言的 OpenTelemetry SDK 为代码添加埋点。

故障排查

自定义插桩未发送

如果你看不到手动定义的 链路追踪 或其他遥测数据，可能是因为你使用了与 OpenTelemetry API 包不兼容的版本。请确保你的 OpenTelemetry API 包版本至少与 AWS Lambda 中包含的版本相同或更低。

启用 SDK 调试日志

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

启用 collector 调试日志

要排查 collector 问题，可以修改 collector 配置文件，添加 logging exporter，并将 telemetry 的 日志级别设置为 debug，以启用 collector Lambda layer 的更详细日志。

# collector.yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 'localhost:4317'
      http:
        endpoint: 'localhost:4318'

exporters:
  logging:
    verbosity: detailed
  otlphttp:
    endpoint: "<YOU_OTEL_COLLECTOR_HTTP_ENDPOINT>"
    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]
Navigation