Trace 및 스팬

이 문서에서는 trace 및 스팬의 개념에 대해 소개합니다. trace는 단일 엔드 투 엔드 작업을 나타냅니다. trace는 단일 함수 또는 작업의 레코드인 스팬으로 구성됩니다.

Trace 데이터 모델

trace에는 다음과 같은 속성이 있습니다.

  • trace ID: 엔드 투 엔드 작업의 고유 식별자입니다. trace ID는 엔드 투 엔드 작업의 일부로 컨텍스트로 전파되어야 합니다.

  • trace ID에 동일한 값을 공유하는 스팬 모음입니다.

    Cloud Trace는 trace ID를 사용하여 저장소에서 동일한 trace와 연결된 스팬을 식별합니다.

스팬 데이터 모델

스팬은 유한하지만 0이 아닌 기간에 발생한 작업에 해당합니다. 다음은 각 스팬에 저장된 몇 가지 필수 속성입니다.

  • trace ID: 이 특정 전체 작업이 수행된 엔드 투 엔드 작업의 식별자입니다.
  • 스팬 ID: 스팬의 고유 식별자입니다. 단일 전체 작업의 처리에서 동일한 작업이 여러 번 호출되는 경우, trace에는 동일한 이름의 여러 스팬이 포함될 수 있습니다. 그러나 각 스팬에는 고유한 스팬 ID가 있습니다.
  • 상위 스팬 ID: 이 스팬을 호출한 작업을 식별합니다. '루트' 스팬의 상위 스팬 ID는 null로 설정됩니다.
  • 이름: 수행된 작업의 이름입니다.
  • 시작 시간: 작업의 시작 시간입니다.
  • 종료 시간: 작업의 종료 시간입니다.

스팬에는 키-값 쌍을 사용하여 작업에 대한 추가 정보를 저장하는 속성도 포함될 수 있습니다. Cloud Trace에서는 가능한 경우 OpenTelemetry 시맨틱스 규칙을 사용하도록 권장합니다.

리소스

OpenTelemetry 리소스:

다음 단계