Conversión de objetos `Event` de la API de telemetría de Lambda en OpenTelemetry Spans

Modo de enfoque

Conversión de objetos Event de la API de telemetría de Lambda en OpenTelemetry Spans - AWS Lambda

Mapeo de OTel Spans con Span Events Mapeo de OTel Spans con Child Spans

El esquema de la API de telemetría AWS Lambda es semánticamente compatible con OpenTelemetry (OTel). Esto significa que puede convertir sus objetos Event de la API de telemetría AWS Lambda en OpenTelemetry (OTel) Spans. Al realizar la conversión, no debe asignar un solo objeto de Event a un solo OTel Span. En su lugar, debe presentar los tres eventos relacionados con una fase del ciclo de vida en un solo OTel Span. Por ejemplo, los eventos start, runtimeDone y runtimeReport representan una sola invocación de función. Presente estos tres eventos como un solo OTel Span.

Puede convertir sus eventos mediante Span Events o Child Spans (agrupados). Las tablas de esta página describen las asignaciones entre las propiedades del esquema de la API de telemetría y las propiedades de OTel Span para ambos enfoques. Para obtener más información sobre OTel Spans, consulte Span en la página de la API de seguimiento del sitio web de OpenTelemetry Docs.

Mapeo de OTel Spans con Span Events

En las siguientes tablas, e representa el evento que proviene del origen de telemetría.

Mapeo de los eventos *Start

OpenTelemetry	Esquema de la API de telemetría de Lambda
`Span.Name`	Su extensión genera este valor en función del campo `type`.
`Span.StartTime`	Utilice `e.time`.
`Span.EndTime`	N/D, porque el evento aún no se ha completado.
`Span.Kind`	Configurado en `Server`.
`Span.Status`	Configurado en `Unset`.
`Span.TraceId`	Analice el encabezado AWS X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `TraceId`.
`Span.ParentId`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Parent`.
`Span.SpanId`	Utilice `e.tracing.spanId` si está disponible. De lo contrario, genere un nuevo `SpanId`.
`Span.SpanContext.TraceState`	N/D para un contexto de seguimiento de X-Ray.
`Span.SpanContext.TraceFlags`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Sampled`.
`Span.Attributes`	Su extensión puede agregar aquí cualquier valor personalizado.

Mapeo de los eventos *RuntimeDone

OpenTelemetry	Esquema de la API de telemetría de Lambda
`Span.Name`	Su extensión genera el valor en función del campo `type`.
`Span.StartTime`	Utilice `e.time` desde el evento coincidente `*Start`. Para otras opciones, consulte `e.time - e.metrics.durationMs`.
`Span.EndTime`	N/D, porque el evento aún no se ha completado.
`Span.Kind`	Configurado en `Server`.
`Span.Status`	S i`e.status` no es igual a `success`, entonces configúrelo en `Error`. De lo contrario, establézcala en `Ok`.
`Span.Events[]`	Utilice `e.spans[]`.
`Span.Events[i].Name`	Utilice `e.spans[i].name`.
`Span.Events[i].Time`	Utilice `e.spans[i].start`.
`Span.TraceId`	Analice el encabezado AWS X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `TraceId`.
`Span.ParentId`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Parent`.
`Span.SpanId`	Use el mismo `SpanId` del evento `*Start`. Si no está disponible, entonces utilice `e.tracing.spanId` o genere un nuevo `SpanId`.
`Span.SpanContext.TraceState`	N/D para un contexto de seguimiento de X-Ray.
`Span.SpanContext.TraceFlags`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Sampled`.
`Span.Attributes`	Su extensión puede agregar aquí cualquier valor personalizado.

Mapeo de los eventos *Report

OpenTelemetry	Esquema de la API de telemetría de Lambda
`Span.Name`	Su extensión genera el valor en función del campo `type`.
`Span.StartTime`	Utilice `e.time` desde el evento coincidente `*Start`. Para otras opciones, consulte `e.time - e.metrics.durationMs`.
`Span.EndTime`	Utilice `e.time`.
`Span.Kind`	Configurado en `Server`.
`Span.Status`	Usa el mismo valor que el evento `*RuntimeDone`.
`Span.TraceId`	Analice el encabezado AWS X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `TraceId`.
`Span.ParentId`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Parent`.
`Span.SpanId`	Use el mismo `SpanId` del evento `*Start`. Si no está disponible, entonces utilice `e.tracing.spanId` o genere un nuevo `SpanId`.
`Span.SpanContext.TraceState`	N/D para un contexto de seguimiento de X-Ray.
`Span.SpanContext.TraceFlags`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Sampled`.
`Span.Attributes`	Su extensión puede agregar aquí cualquier valor personalizado.

Mapeo de OTel Spans con Child Spans

En la siguiente tabla se describe cómo convertir los eventos de la API de telemetría de Lambda en OTel Spans con Child Spans (agrupados) para los Spans *RuntimeDone. Para las asignaciones de *Start y *Report, consulte las tablas en Mapeo de OTel Spans con Span Events, ya que son las mismas para Child Spans. En esta tabla, e representa el evento que proviene del origen de telemetría.

Mapeo de los eventos *RuntimeDone

OpenTelemetry	Esquema de la API de telemetría de Lambda
`Span.Name`	Su extensión genera el valor en función del campo `type`.
`Span.StartTime`	Utilice `e.time` desde el evento coincidente `*Start`. Para otras opciones, consulte `e.time - e.metrics.durationMs`.
`Span.EndTime`	N/D, porque el evento aún no se ha completado.
`Span.Kind`	Configurado en `Server`.
`Span.Status`	S i`e.status` no es igual a `success`, entonces configúrelo en `Error`. De lo contrario, establézcala en `Ok`.
`Span.TraceId`	Analice el encabezado AWS X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `TraceId`.
`Span.ParentId`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Parent`.
`Span.SpanId`	Use el mismo `SpanId` del evento `*Start`. Si no está disponible, entonces utilice `e.tracing.spanId` o genere un nuevo `SpanId`.
`Span.SpanContext.TraceState`	N/D para un contexto de seguimiento de X-Ray.
`Span.SpanContext.TraceFlags`	Analice el encabezado X-Ray que se encuentra en `e.tracing.value` y, a continuación, use el valor `Sampled`.
`Span.Attributes`	Su extensión puede agregar aquí cualquier valor personalizado.
`ChildSpan[i].Name`	Utilice `e.spans[i].name`.
`ChildSpan[i].StartTime`	Utilice `e.spans[i].start`.
`ChildSpan[i].EndTime`	Utilice `e.spans[i].start + e.spans[i].durations`.
`ChildSpan[i].Kind`	Igual que el `Span.Kind` principal.
`ChildSpan[i].Status`	Igual que el `Span.Status` principal.
`ChildSpan[i].TraceId`	Igual que el `Span.TraceId` principal.
`ChildSpan[i].ParentId`	Utilice el `Span.SpanId` principal.
`ChildSpan[i].SpanId`	Genere una nueva `SpanId`.
`ChildSpan[i].SpanContext.TraceState`	N/D para un contexto de seguimiento de X-Ray.
`ChildSpan[i].SpanContext.TraceFlags`	Igual que el `Span.SpanContext.TraceFlags` principal.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Referencia del esquema Event

API de registros

En esta página

Seleccione sus preferencias de cookies

Personalizar preferencias de cookies

Esenciales

De rendimiento

Funcionales

De publicidad

No se pueden guardar las preferencias de cookies

Conversión de objetos `Event` de la API de telemetría de Lambda en OpenTelemetry Spans

Secciones

Mapeo de OTel Spans con Span Events

Mapeo de OTel Spans con Child Spans

En esta página

Related resources

¿Le ha servido de ayuda esta página?

Related resources

Tema siguiente:

Tema anterior:

¿Necesita ayuda?