trace 범위 만들기 및 관리

이 문서에서는 Trace Explorer 페이지에서 보거나 분석하려는 트레이스 스팬을 찾을 수 있는 트레이스 범위를 만들고 관리하는 방법을 설명합니다. Google Cloud 프로젝트에서 발생한 스팬만 보고 분석하려는 경우 추적 범위를 구성할 필요가 없습니다. 그러나 마이크로서비스 아키텍처를 사용할 때와 같이 트레이스 데이터가 여러 프로젝트에 저장된 경우 단일 Google Cloud 프로젝트의 모든 스팬을 보려면 몇 가지 구성 작업을 실행해야 합니다.

이 문서에서는 트레이스 및 스팬을 보는 방법을 설명하지 않습니다. 이 주제에 관한 자세한 내용은 trace 찾기 및 탐색을 참고하세요.

trace 범위 정보

트레이스 범위는 Google Cloud 프로젝트 집합을 나열하는 프로젝트 수준의 영구 리소스입니다. Trace 탐색기 페이지를 trace 범위별로 검색하도록 구성할 수 있습니다. 즉, 선택한 범위에 나열된 프로젝트를 검색합니다. 검색된 프로젝트에 대한 Identity and Access Management (IAM) 역할과 기간 설정에 따라 저장소에서 가져와 표시할 데이터가 결정됩니다.

Google Cloud 프로젝트를 만들면 _Default라는 트레이스 범위가 생성됩니다. 이 범위에는 Google Cloud 프로젝트만 포함됩니다. 이 범위에 프로젝트를 추가하거나 이 범위를 삭제할 수 없습니다.

트레이스 범위를 만들 수 있으며 만든 트레이스 범위를 수정하고 삭제할 수 있습니다. 스팬 데이터를 여러 Google Cloud 프로젝트에 쓰는 서비스가 있는 경우 트레이스 범위를 만들려 합니다.

trace 범위 또는 trace 및 스팬 ID가 포함된 URL로 Trace 탐색기 페이지를 열지 않는 한 Trace 탐색기 페이지는 기본 trace 범위에 나열된 Google Cloud 프로젝트에서 trace 데이터를 검색합니다. 프로젝트를 만들 때 _Default라는 트레이스 범위가 기본 트레이스 범위로 설정됩니다. 하지만 기본 트레이스 범위로 사용할 다른 트레이스 범위를 선택할 수 있습니다.

시작하기 전에

트레이스 범위를 만들고 보고 기본 트레이스 범위를 설정하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 트레이스 범위를 만들고 보거나 기본 트레이스 범위를 가져오려면 프로젝트에 대한 Cloud Trace 사용자 (roles/cloudtrace.user)
  • 기본 트레이스 범위를 설정하려면 프로젝트에 대한 관측 가능성 편집자 (roles/observability.editor)를 사용하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 트레이스 범위를 만들고 보고, 기본 트레이스 범위를 설정하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

트레이스 범위를 만들고 보고 기본 트레이스 범위를 설정하려면 다음 권한이 필요합니다.

  • trace 범위를 만들고 관리하려면 다음 단계를 따르세요. cloudtrace.traceScopes.[create, delete, get, list, update]
  • 기본 트레이스 범위를 설정하려면 다음을 실행합니다. observability.scopes.[get, update]

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

trace 범위 나열

트레이스 범위를 나열하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서  설정 페이지로 이동합니다.

    설정으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. 트레이스 범위 탭을 선택합니다.

    테이블에 트레이스 범위가 나열됩니다. Google Cloud 프로젝트를 선택하면 항목 하나에 '기본값' 아이콘()이 표시됩니다. 이는 기본 트레이스 범위임을 나타냅니다. trace 탐색기 페이지는 페이지가 열릴 때 기본 trace 범위에 나열된 프로젝트에서 trace 데이터를 검색합니다.

trace 범위 만들기

Trace Explorer 페이지에 표시되는 스팬은 검색된 프로젝트, 해당 프로젝트의 IAM 역할, 시간 범위 설정, 적용한 필터에 따라 다릅니다.

프로젝트당 트레이스 범위를 100개까지 만들 수 있습니다. trace 범위에는 총 20개의 프로젝트가 포함될 수 있습니다.

트레이스 범위를 만들려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서  설정 페이지로 이동합니다.

    설정으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. 트레이스 범위 탭을 선택한 다음 트레이스 범위 만들기를 클릭합니다.

  3. 프로젝트 추가를 클릭하고 대화상자를 완료합니다.

    프로젝트를 추가하면 해당 프로젝트에 저장된 스팬이 트레이스 범위에 포함됩니다. 범위에 포함할 프로젝트를 모르는 경우 기존 Trace Explorer 페이지를 사용하여 프로젝트를 식별할 수 있습니다. 자세한 내용은 이 문서의 트레이스 범위로 이전 섹션을 참고하세요.

  4. 트레이스 범위 이름 지정 섹션에 트레이스 범위 탭에 표시할 이름과 설명을 입력합니다.

    trace 범위 이름은 수정할 수 없으며 프로젝트 내에서 고유해야 합니다.

  5. 트레이스 범위 만들기를 클릭합니다.

trace 범위로 마이그레이션

Trace 탐색기 페이지에서는 trace 데이터를 검색할 Google Cloud 프로젝트를 지정해야 합니다. 이는 기존 Trace 탐색기 페이지와는 다른 동작입니다. 기존 트레이스 탐색기 페이지는 조직의 모든 프로젝트를 검색합니다. 이러한 차이로 인해 trace 탐색기 페이지에 기존 trace 탐색기 페이지에 표시되는 스팬이 표시되지 않을 수 있습니다.

기존 Trace Explorer 페이지의 trace 세부정보 창 섹션을 사용하여 trace 데이터를 저장하는 Google Cloud 프로젝트 목록을 컴파일할 수 있습니다.

  1. 기존 트레이스 탐색기 페이지로 이동합니다.

    기존 Trace 탐색기로 이동

  2. 트레이스를 선택합니다.

    다음을 시도해 보세요.

    • Trace ID 필드에 ID를 입력하여 트레이스를 봅니다.
    • 필터를 추가합니다.

  3. Trace 세부정보 창에서 트레이스를 선택한 다음 Projects 탭으로 이동합니다.

    이 탭에는 트레이스의 스팬을 저장하는 프로젝트가 나열됩니다.

  4. 나열된 프로젝트가 포함된 트레이스 범위를 만들려면 프로젝트 탭의 툴바로 이동하여 이 프로젝트로 범위 만들기를 선택한 후 대화상자를 완료합니다.

  5. 프로젝트 목록을 컴파일할 때까지 이전 단계를 반복합니다.

프로젝트 목록을 컴파일한 후 트레이스 범위를 만듭니다. 기본 트레이스 범위로 설정할 수도 있습니다.

기본 트레이스 범위 설정

Trace 탐색기 페이지가 열리면 기본 trace 범위에 나열된 프로젝트에서 trace 데이터를 검색합니다. 이 트레이스 범위에 액세스할 수 없는 경우 프로젝트에서 트레이스 데이터를 검색합니다.

프로젝트가 생성될 때 _Default라는 트레이스 범위가 생성되고 기본 트레이스 범위로 지정됩니다. 하지만 자체 트레이스 범위를 만들어 기본 트레이스 범위로 지정할 수 있습니다.

기본 트레이스 범위를 설정하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서  설정 페이지로 이동합니다.

    설정으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. 트레이스 범위 탭을 선택합니다.

  3. 기본 트레이스 범위로 지정할 트레이스 범위를 찾아  더보기를 클릭한 다음 기본값으로 설정을 선택합니다.

    선택한 트레이스 범위에 '기본값' 아이콘()이 표시됩니다.

트레이스 범위 수정 또는 삭제

_Default라는 트레이스 범위는 삭제하거나 수정할 수 없습니다. 다른 모든 트레이스 범위를 수정하거나 삭제할 수 있습니다.

트레이스 범위를 수정하거나 삭제하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서  설정 페이지로 이동합니다.

    설정으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. 트레이스 범위 탭을 선택합니다.

  3. 수정하거나 삭제하려는 트레이스 범위를 찾고  더보기를 클릭한 후 다음 중 하나를 수행합니다.

    • 수정하려면 범위 수정을 선택한 후 대화상자를 완료합니다.
    • 삭제하려면 범위 삭제를 선택한 후 대화상자를 완료합니다.

제한사항

트레이스 범위를 만들거나 관리하기 위한 Cloud Trace API 또는 Google Cloud CLI는 지원되지 않습니다.

다음 단계