将 Lambda 遥测 API Event 对象转换为跨度 OpenTelemetry - Amazon Lambda
使用 Span 事件映射到 OTel 跨度使用子跨度映射到 OTel 跨度
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

将 Lambda 遥测 API Event 对象转换为跨度 OpenTelemetry

Amazon Lambda遥测 API 架构在语义上与 OpenTelemetry (oTel) 兼容。这意味着您可以将Amazon Lambda遥测 API Event 对象转换为 OpenTelemetry (oTel) 跨度。转换时，不应将单个 Event 对象映射到单个 OTel 跨度。相反，您应该在单个 OTel 跨度中呈现与生命周期阶段相关的所有三个事件。例如，start、runtimeDone 和 runtimeReport 事件代表单个函数调用。将所有这三项事件作为单个 OTel 跨度呈现。

您可以使用跨度事件或子（嵌套）跨度来转换事件。此页面上的表格描述了两种方法的遥测 API 架构属性和 OTel 跨度属性之间的映射。有关 oTel Sp an 的更多信息，请参阅 OpenTelemetry Docs 网站跟踪 API 页面上的 Span。

使用 Span 事件映射到 OTel 跨度

在下表中，e 代表来自遥测源的事件。

映射 *Start 事件
OpenTelemetry Lambda 遥测 API 架构

Span.Name

扩展根据 type 字段生成此值。

Span.StartTime

使用 e.time。

Span.EndTime

不适用，因为事件尚未完成。

Span.Kind

设置为 Server。

Span.Status

设置为 Unset。

Span.TraceId

解析 e.tracing.value 中找到的 Amazon X-Ray 标头，然后使用 TraceId 值。

Span.ParentId

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Parent 值。

Span.SpanId

如果可用，请使用 e.tracing.spanId。否则，生成一个新的 SpanId。

Span.SpanContext.TraceState

X-Ray 跟踪上下文不适用。

Span.SpanContext.TraceFlags

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Sampled 值。

Span.Attributes

扩展可以在此处添加任何自定义值。
映射 *RuntimeDone 事件
OpenTelemetry Lambda 遥测 API 架构

Span.Name

扩展根据 type 字段生成此值。

Span.StartTime

使用匹配 *Start 事件中的 e.time。

或者，请使用 e.time - e.metrics.durationMs。

Span.EndTime

不适用，因为事件尚未完成。

Span.Kind

设置为 Server。

Span.Status

如果 e.status 不等于 success，则设置为 Error。

否则，设置为 Ok。

Span.Events[]

使用 e.spans[]。

Span.Events[i].Name

使用 e.spans[i].name。

Span.Events[i].Time

使用 e.spans[i].start。

Span.TraceId

解析 e.tracing.value 中找到的 Amazon X-Ray 标头，然后使用 TraceId 值。

Span.ParentId

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Parent 值。

Span.SpanId

使用 *Start 事件中的相同 SpanId。如果不可用，则使用 e.tracing.spanId 或生成一个新的 SpanId。

Span.SpanContext.TraceState

X-Ray 跟踪上下文不适用。

Span.SpanContext.TraceFlags

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Sampled 值。

Span.Attributes

扩展可以在此处添加任何自定义值。
映射 *Report 事件
OpenTelemetry Lambda 遥测 API 架构

Span.Name

扩展根据 type 字段生成此值。

Span.StartTime

使用匹配 *Start 事件中的 e.time。

或者，请使用 e.time - e.metrics.durationMs。

Span.EndTime

使用 e.time。

Span.Kind

设置为 Server。

Span.Status

使用与 *RuntimeDone 事件相同的值。

Span.TraceId

解析 e.tracing.value 中找到的 Amazon X-Ray 标头，然后使用 TraceId 值。

Span.ParentId

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Parent 值。

Span.SpanId

使用 *Start 事件中的相同 SpanId。如果不可用，则使用 e.tracing.spanId 或生成一个新的 SpanId。

Span.SpanContext.TraceState

X-Ray 跟踪上下文不适用。

Span.SpanContext.TraceFlags

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Sampled 值。

Span.Attributes

扩展可以在此处添加任何自定义值。

使用子跨度映射到 OTel 跨度

下表描述了如何将 Lambda 遥测 API 事件转换为带 *RuntimeDone 跨度子（嵌套）跨度的 OTel 跨度。对于 *Start 和 *Report 映射，请参阅 使用 Span 事件映射到 OTel 跨度 中的表，因为它们与子跨度相同。在此表中，e 代表来自遥测源的事件。

映射 *RuntimeDone 事件
OpenTelemetry Lambda 遥测 API 架构

Span.Name

扩展根据 type 字段生成此值。

Span.StartTime

使用匹配 *Start 事件中的 e.time。

或者，请使用 e.time - e.metrics.durationMs。

Span.EndTime

不适用，因为事件尚未完成。

Span.Kind

设置为 Server。

Span.Status

如果 e.status 不等于 success，则设置为 Error。

否则，设置为 Ok。

Span.TraceId

解析 e.tracing.value 中找到的 Amazon X-Ray 标头，然后使用 TraceId 值。

Span.ParentId

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Parent 值。

Span.SpanId

使用 *Start 事件中的相同 SpanId。如果不可用，则使用 e.tracing.spanId 或生成一个新的 SpanId。

Span.SpanContext.TraceState

X-Ray 跟踪上下文不适用。

Span.SpanContext.TraceFlags

解析 e.tracing.value 中找到的 X-Ray 标头，然后使用 Sampled 值。

Span.Attributes

扩展可以在此处添加任何自定义值。

ChildSpan[i].Name

使用 e.spans[i].name。

ChildSpan[i].StartTime

使用 e.spans[i].start。

ChildSpan[i].EndTime

使用 e.spans[i].start + e.spans[i].durations。

ChildSpan[i].Kind

与父 Span.Kind 一样。

ChildSpan[i].Status

与父 Span.Status 一样。

ChildSpan[i].TraceId

与父 Span.TraceId 一样。

ChildSpan[i].ParentId

使用父 Span.SpanId。

ChildSpan[i].SpanId

生成新的 SpanId。

ChildSpan[i].SpanContext.TraceState

X-Ray 跟踪上下文不适用。

ChildSpan[i].SpanContext.TraceFlags

与父 Span.SpanContext.TraceFlags 一样。