Trace 스토리지 개요

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

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

관측 가능성 스토리지 모델

관측 가능성 API 스토리지 모델은 다음 아키텍처를 기반으로 합니다.

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

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

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

추적 데이터의 스토리지 구성

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

버킷이 존재하지 않고 다음 중 하나가 참인 경우 시스템은 _Trace이라는 버킷을 한 번만 만들려고 시도합니다.

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

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

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

_Trace라는 이름의 모니터링 가능성 버킷이 있는지 확인하거나 이 버킷을 만드는 흐름을 트리거하려면 다음을 실행하세요.

  1. Google Cloud 콘솔에서 Trace 탐색기 페이지로 이동합니다.

    Trace 탐색기로 이동

    검색창을 사용하여 이 페이지를 찾을 수도 있습니다.

  2. 다음 중 하나를 수행합니다.

    • 페이지에 추적 데이터가 표시되면 아무것도 하지 않아도 됩니다.Google Cloud 프로젝트에 _Trace이라는 모니터링 가능성 버킷이 포함되어 있습니다.

    • 페이지에 다음 배너가 표시되면 추적 데이터가 없거나 Cloud Run Functions, Cloud Run, App Engine의 데이터만 있는 것입니다.

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      _Trace라는 관측 가능성 버킷을 만드는 흐름을 트리거하려면 배너로 이동하여 사용 설정을 클릭합니다.

    • 페이지에 다음 배너가 표시되면 _Trace라는 관측 가능성 버킷의 초기화가 실패한 것입니다. 이 메시지가 표시되면 배너로 이동하여 티켓 제출을 클릭하세요.

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

제한사항

다음은 허용되지 않습니다.

  • 관측 가능성 버킷을 수정하거나 삭제합니다.
  • 데이터 세트를 만들거나 삭제하거나 수정합니다.
  • 뷰를 만들거나 삭제하거나 수정합니다.
  • Google Cloud 콘솔을 사용하여 버킷, 데이터 세트, 뷰 또는 링크를 나열합니다.
  • us 이외의 위치에 관측 가능성 버킷을 만듭니다. 관측 가능성 버킷은 us 위치에 있어야 합니다.

다음 단계