Lambda 텔레메트리 API `Event` 객체를 OpenTelemetry 범위로 변환

AWS Lambda 텔레메트리 API 스키마는 OpenTelemetry(OTel)와 의미 체계가 호환됩니다. 즉, AWS Lambda 텔레메트리 API Event 객체를 OpenTelemetry(OTel) 범위로 변환할 수 있습니다. 변환할 때는 단일 Event 객체를 단일 OTel 범위에 매핑해서는 안 됩니다. 대신 수명 주기 단계와 관련한 세 가지 이벤트를 모두 단일 OTel 범위에 표시해야 합니다. 예를 들어 start, runtimeDone 및 runtimeReport 이벤트는 단일 함수 호출을 나타냅니다. 이 세 가지 이벤트를 모두 하나의 OTel 범위로 표시합니다.

범위 이벤트 또는 하위(중첩) 범위를 사용하여 이벤트를 변환할 수 있습니다. 이 페이지의 표에서는 두 접근 방식에 대한 텔레메트리 API 스키마 속성과 OTel 범위 속성 간의 매핑을 설명합니다. OTel 범위에 대한 자세한 내용은 OpenTelemetry 문서 웹 사이트의 추적 API 페이지에서 범위를 참조하세요.

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`에 있는 AWS 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`에 있는 AWS 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`에 있는 AWS 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 매핑의 경우 하위 범위와 동일하므로 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`에 있는 AWS 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`와 동일합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Event 스키마 참조

Logs API

Lambda 텔레메트리 API Event 객체를 OpenTelemetry 범위로 변환

Sections

OTel 범위를 범위 이벤트에 매핑

OTel 범위를 하위 범위에 매핑

Lambda 텔레메트리 API `Event` 객체를 OpenTelemetry 범위로 변환