Trace 스토리지 개요

이 문서에서는 Cloud Trace 데이터의 스토리지 모델을 설명합니다. 관측 가능성 버킷, 관측 가능성 뷰, 링크를 소개합니다. 링크를 만들면 BigQuery에서 trace 데이터를 쿼리할 수 있습니다.

이 문서에서는 개별 스팬이 저장되는 방식을 지정하는 스키마를 설명하지 않습니다. 자세한 내용은 Trace 스키마를 참조하세요.

관측 가능성 스토리지 모델

관측 가능성 API 스토리지 모델은 다음 아키텍처를 사용합니다.

관측 가능성 버킷
관측 가능성 버킷은 데이터를 저장하는 데이터 세트의 관리 항목입니다. 관측 가능성 버킷은 특정 위치에 있으며 데이터 보관 정책이 있습니다. 서비스가 관측 가능성 API를 사용하여 데이터를 저장하면 시스템은 서비스 이름, 데이터를 저장할 데이터 세트, 저장된 데이터에 대한 읽기 액세스 권한을 제공하는 뷰를 기반으로 관측 가능성 버킷을 만듭니다. Google Cloud 예를 들어 Cloud Trace 서비스의 경우 시스템은 시스템에서 만든 버킷의 이름을 _Trace, 데이터 세트의 이름을 Spans, 뷰의 이름을 _AllSpans로 지정합니다. 관측 가능성 버킷의 구조에 대한 자세한 내용은 Bucket을 참조하세요.
데이터 세트
데이터 세트는 데이터를 저장합니다. 시스템은 데이터 세트를 관리하는 관측 가능성 버킷을 만들 때 데이터 세트 하나를 자동으로 만듭니다. 예를 들어, 시스템이 _Trace 버킷을 만들 때 trace 데이터를 저장하는 Spans라는 데이터 세트도 만듭니다. 데이터 세트의 구조 에 대한 자세한 내용은 Dataset을 참조하세요.
데이터 세트의 뷰
각 데이터 세트는 하나 이상의 뷰를 호스팅합니다. 뷰는 데이터 세트의 항목 하위 집합에 대한 읽기 액세스 권한을 제공합니다. 시스템은 데이터 세트를 만들 때 뷰 하나를 만듭니다. 이 뷰에는 데이터 세트의 모든 데이터가 포함됩니다. 뷰의 이름은 서비스에 따라 다릅니다. 예를 들어 Cloud Trace 서비스의 경우 시스템은 _AllSpans 데이터 세트에 뷰를 만듭니다.Spans 뷰의 구조에 대한 자세한 내용은 View를 참조하세요.
데이터 세트의 링크

각 데이터 세트는 최대 하나의 링크를 포함할 수 있습니다. 데이터 세트의 링크를 만들면 시스템은 연결된 BigQuery 데이터 세트를 만듭니다. 그런 다음 BigQuery 또는 BigQuery API를 사용하는 다른 서비스를 사용하여 데이터 세트의 데이터를 쿼리할 수 있습니다. 링크의 구조에 대한 자세한 내용은 Link를 참조하세요.

시스템은 데이터 세트에 링크를 자동으로 만들지 않습니다.

trace 데이터의 스토리지 구성

trace 데이터는 _Trace라는 관측 가능성 버킷에 저장됩니다. 시스템은 이 버킷에 Spans라는 데이터 세트를 만듭니다. 해당 데이터 세트에서 시스템은 `_AllSpans`라는 뷰를 만듭니다._AllSpans 이 뷰에는 데이터 세트의 모든 데이터가 포함됩니다.

버킷이 없고 다음 중 하나가 참인 경우 시스템은 _Trace 라는 관측 가능성 버킷을 만들려고 시도합니다.

  • 애플리케이션이 Cloud Trace API 또는 Telemetry API를 사용하여 trace 데이터를 프로젝트로 전송합니다. Google Cloud

  • 서비스에 Cloud Trace를 사용 설정하면 해당 서비스가 trace 데이터를 프로젝트로 전송합니다. Google Cloud Google Cloud 예를 들어 Cloud Service Mesh 는 trace 수집을 지원하지만 trace 수집은 기본적으로 사용 중지되어 있습니다. Cloud Service Mesh의 추적을 사용 설정하면 해당 서비스에서 전송한 데이터로 인해 시스템에서 버킷이 생성됩니다.

    Cloud Run 함수, Cloud Run, App Engine에서 생성된 trace 데이터는 시스템에서 관측 가능성 버킷을 만들지 않습니다. 이러한 서비스의 스팬은 관측 가능성 버킷이 있는 경우에만 저장됩니다.

Trace 탐색기 페이지를 사용하여 trace 데이터를 볼 수 있는 경우 _Trace라는 관측 가능성 버킷이 있는 것입니다. 데이터가 표시되지 않거나 스토리지가 초기화되지 않았다는 배너가 표시되면 다음 중 하나를 시도해 보세요.

관측 가능성 버킷의 데이터 상주

특정 위치에 데이터를 저장하거나 CMEK를 사용해야 하는 규정 준수 또는 규제 요구사항이 있는 경우 관측 가능성 버킷의 기본 설정을 구성하는 것이 좋습니다.

  • 조직, 폴더, 프로젝트의 경우 관측 가능성 버킷의 기본 설정을 사용하면 다음을 구성할 수 있습니다.

    • 기본 스토리지 위치
    • 각 위치의 기본 Cloud Key Management Service 키

    리소스 계층 구조의 하위 항목은 기본 설정을 구성한 하위 항목을 제외하고 이러한 설정을 자동으로 사용합니다.

    관측 가능성 버킷의 기본 설정은 기존 리소스가 아닌 새 리소스에만 적용됩니다. 자세한 내용은 관측 가능성 버킷의 기본값 설정을 참조하세요.

관측 가능성 버킷 설정의 기본 설정은 로그 데이터를 저장하는 로그 버킷에는 적용되지 않습니다. 로그 버킷의 기본 위치를 설정하거나 CMEK를 요구하는 방법을 알아보려면 Cloud Logging의 기본 리소스 설정 구성을 참조하세요.

제한사항

다음은 수행할 수 없습니다.

  • 관측 가능성 버킷을 수정하거나 삭제합니다.
  • 데이터 세트를 만들거나 삭제하거나 수정합니다.
  • 뷰를 만들거나 삭제하거나 수정합니다.
  • 콘솔을 사용하여 버킷, 데이터 세트, 뷰 또는 링크를 나열합니다. Google Cloud

다음 단계