Trace 및 스팬

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

Trace 데이터 모델

트레이스에는 다음과 같은 속성이 있습니다.

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

  • 트레이스 ID의 값을 공유하는 스팬 모음입니다.

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

스팬 데이터 모델

스팬은 0이 아닌 유한한 시간 동안 발생한 작업에 해당합니다. 다음은 각 스팬에 저장된 몇 가지 필수 속성을 보여줍니다.

  • Trace ID: 이 특정 전체 작업이 발생한 엔드 투 엔드 작업의 식별자입니다.
  • 스팬 ID: 스팬의 고유 식별자입니다. 단일 전체 작업을 완료하는 과정에서 동일한 작업이 여러 번 호출되면 트레이스에 동일한 이름의 스팬이 여러 개 포함될 수 있습니다. 그러나 각 스팬에는 고유한 스팬 ID가 있습니다.
  • 상위 스팬 ID: 이 스팬을 호출한 작업을 식별합니다. '루트' 스팬의 상위 스팬 ID는 null로 설정되어 있습니다.
  • 이름: 실행된 작업의 이름입니다.
  • 시작 시간: 작업의 시작 시간입니다.
  • 종료 시간: 작업의 종료 시간입니다.

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

리소스

OpenTelemetry 리소스:

다음 단계