다중 프로젝트 쿼리의 관측 가능성 범위 구성

이 문서에서는 데이터가 여러 프로젝트에 저장된 경우 차트를 만들거나 로그 데이터를 보는 방법을 설명합니다. 기본적으로 시각화 도구에서는 프로젝트에서 생성된 데이터만 사용할 수 있습니다. 하지만 범위를 구성하면 시각화 및 분석 도구에서 여러 프로젝트에 저장된 데이터를 쿼리할 수 있습니다.

하나의Google Cloud 프로젝트에 저장된 데이터만 모니터링하거나 보려는 경우에는 별도의 구성을 수행할 필요가 없습니다.

범위는 읽기 시간 집계를 제공합니다.

범위를 사용하면 시각화 및 분석 도구가 여러 위치에 저장된 데이터의 읽기 시간 집계를 실행할 수 있습니다. 범위는 데이터가 저장되는 위치를 제어하지 않습니다. 대신 쿼리 엔진은 범위를 사용하여 데이터를 검색할 위치를 결정합니다.

측정항목 및 트레이스 데이터는 항상 데이터가 발생한 Google Cloud 프로젝트에 저장됩니다. 여러 프로젝트에 저장된 측정항목 데이터를 단일 차트에 표시하려면 해당 프로젝트를 나열하도록 측정항목 범위를 구성합니다. 이 범위를 구성한 후 차트 또는 알림 정책을 만들면 이러한 서비스에서 실행하는 쿼리가 나열된 프로젝트의 측정항목 데이터를 자동으로 반환합니다. 동작은 추적 데이터와 유사합니다.

기본적으로 로그 데이터는 데이터가 발생한 Google Cloud 프로젝트, 결제 계정, 폴더 또는 조직에 저장됩니다. 하지만 로깅을 구성하여 로그 데이터가 발생한 리소스에서 다른 위치(예: 다른 프로젝트 또는 중앙 집중식 로그 버킷)로 로그 데이터를 라우팅할 수 있습니다. 모든 경우에 맞춤 로그 범위를 구성합니다. 로그 범위에 프로젝트 대신 로그 뷰를 나열하는 것이 좋습니다. 로그 뷰는 로그 버킷의 로그 항목 하위 집합에 대한 읽기 액세스 권한을 제공합니다. 예를 들어 세 개의 프로젝트에 저장된 로그 데이터가 있는 경우 각 프로젝트의 _Default/_AllLogs 뷰를 포함하도록 로그 뷰를 구성할 수 있습니다.

Google Cloud Observability에서 범위가 사용되는 방식

Google Cloud Observability 분석 및 시각화 도구는 데이터 유형별 범위를 사용하여 도구에서 표시하거나 분석할 데이터를 쿼리할 리소스를 결정합니다.

예:

• 로그 탐색기 페이지가 열리면 시스템에서 기본 로그 범위에 나열된 리소스에 로그 데이터를 쿼리합니다. 이 페이지가 열리면 툴바 옵션을 사용하여 다른 범위의 리소스를 쿼리할 수 있습니다.
• Trace 탐색기 페이지가 열리면 시스템은 기본 trace 범위에 나열된 프로젝트에서 trace 데이터를 쿼리합니다. 이 페이지가 열리면 툴바 옵션을 사용하여 다른 범위의 리소스를 쿼리할 수 있습니다.
• 알림 정책을 만들면 Monitoring이 측정항목 범위에 나열된 프로젝트에서 측정항목 데이터를 쿼리합니다. 그런 다음 쿼리 응답을 분석하고 사고를 생성할지 여부를 결정합니다.
• 측정항목 탐색기 페이지를 사용하여 차트를 만들 때 차트로 표시할 측정항목을 지정합니다. Monitoring은 측정항목 범위에 나열된 프로젝트에서 측정항목 데이터를 쿼리한 다음 쿼리 결과를 표시합니다.

로깅 및 추적은 쿼리에서 데이터를 반환하기 전에 리소스에 대한 Identity and Access Management (IAM) 역할을 확인합니다. 예를 들어 로그 데이터를 읽을 권한이 부여되지 않은 프로젝트가 로그 범위에 지정된 경우 해당 프로젝트에 대한 쿼리는 데이터를 반환하지 않습니다.

모니터링은 쿼리가 실행되는 프로젝트의 IAM 역할을 확인합니다. AllEnv라는 프로젝트의 측정항목 범위에 AllEnv, Prod, Staging 프로젝트가 나열되어 있다고 가정해 보겠습니다. 또한 AllEnv 프로젝트에 모니터링 뷰어 역할이 부여되었다고 가정합니다. AllEnv 프로젝트를 사용할 때 측정항목 탐색기 페이지에서 만든 차트에는 세 프로젝트의 측정항목 데이터가 자동으로 표시됩니다.

Google Cloud Observability 범위

이 섹션에서는 Google Cloud Observability에서 사용하는 범위를 설명합니다.

모니터링 가능성 범위

모니터링 가능성 범위는 기본 로그 범위와 기본 trace 범위를 지정합니다. 로그 탐색기 및 Trace 탐색기와 같은 페이지에서는 페이지가 열릴 때 기본 범위를 사용하여 쿼리할 리소스를 결정합니다. 예를 들어 세 개의 프로젝트에서 추적 데이터를 생성하는 애플리케이션이 있다고 가정해 보겠습니다. 기본 추적 범위를 설정하여 이러한 세 프로젝트를 자동으로 쿼리하도록 Trace 탐색기 페이지를 구성할 수 있습니다.

모니터링 가능성 범위를 구성하지 않으면 다음이 발생합니다.

• 로그 탐색기 페이지에서 프로젝트의 로그 데이터를 쿼리합니다.
• Trace 탐색기 페이지에서 프로젝트에 trace 데이터를 쿼리합니다.

관측 가능성 범위는 측정항목 데이터에 적용되지 않습니다.

모니터링 가능성 범위를 구성해야 하는 경우

다음 시나리오에서는 모니터링 가능성 범위를 구성합니다.

• 맞춤 로그 범위를 만들고 해당 범위에 나열된 리소스가 기본적으로 쿼리되기를 원합니다.

• 맞춤 추적 범위를 만들고 해당 범위에 나열된 프로젝트를 기본적으로 쿼리하려고 합니다.

관측 가능성 범위와 관련된 제한사항

설명	최댓값
프로젝트당 관측 가능성 범위 수	1

로그 범위

로그 범위는 로그 탐색기 페이지와 로그 데이터를 표시하는 대시보드에서 사용됩니다.

• 로그 탐색기 페이지가 열리면 시스템에서 기본 로그 범위에 나열된 리소스에 로그 데이터를 자동으로 쿼리합니다. 이 페이지에서는 범위를 전환할 수 있는 컨트롤도 제공합니다.

• 대시보드의 경우 구현에 따라 시스템이 프로젝트를 쿼리하는지 아니면 기본 로그 범위에 나열된 리소스를 쿼리하는지가 결정됩니다.

로그 범위에는 로그 뷰, 프로젝트, 폴더, 조직이 나열될 수 있습니다.

커스텀 로그 범위를 구성하지 않으면 로그 탐색기 페이지에서 프로젝트의 로그 데이터를 쿼리합니다.

맞춤 로그 범위를 만들어야 하는 경우

다음 구성에 대한 맞춤 로그 범위를 만듭니다.

• 로그 데이터를 중앙 집중식 로그 버킷으로 라우팅합니다.
• 여러 프로젝트에 로그 데이터를 저장합니다.
• App Hub 애플리케이션의 대시보드를 생성하는 서비스인 애플리케이션 모니터링을 사용하고 있습니다.

모든 경우에 하나 이상의 로그 보기를 나열하도록 맞춤 로그 범위를 구성합니다. 이러한 로그 뷰는 중앙 집중식 로그 버킷에 있거나 서로 다른 로그 버킷에 있는 로그 뷰일 수 있습니다. 중앙 집중식 로그 버킷을 사용하는 경우 각각 자체 로그 뷰 집합이 있는 맞춤 로그 범위를 여러 개 만들 수 있습니다.

맞춤 로그 범위를 만드는 경우 기본 로그 범위를 업데이트하는 것이 좋습니다.

로그 범위 구성 시 권장사항

• 로그 뷰만 포함합니다.
• 프로젝트와 로그 뷰를 모두 나열하는 범위를 구성하지 마세요.

로그 범위와 관련된 제한사항

설명	최댓값
프로젝트당 로그 범위 수	100
로그 범위당 프로젝트 수	5
로그 범위당 로그 뷰 또는 프로젝트 수	100

자세한 내용은 로그 범위 만들기 및 관리를 참조하세요.

측정항목 범위

측정항목 범위는 Cloud Monitoring에서 실행된 모든 쿼리에서 사용됩니다. 예를 들어 알림 정책과 측정항목 탐색기와 같은 차트 작성 도구는 측정항목 범위에 나열된 프로젝트에 쿼리를 실행합니다.

측정항목 범위를 구성하지 않으면 Monitoring 서비스가 프로젝트에서 측정항목 데이터를 쿼리합니다.

측정항목 범위를 구성해야 하는 경우

다음 중 하나라도 해당하는 경우 측정항목 범위를 구성합니다.

• 여러 프로젝트에 저장된 데이터를 차트로 표시하려는 경우
• 여러 프로젝트에 저장된 데이터를 모니터링하는 알림 정책이 필요한 경우
• App Hub에 애플리케이션을 등록하는 경우. 이 시나리오에 대한 자세한 내용은 관리 프로젝트의 측정항목 범위를 참조하세요.

측정항목 범위와 관련된 제한사항

설명	최댓값
프로젝트당 측정항목 범위 수	1
측정항목 범위당 프로젝트 수	375

자세한 내용은 측정항목 범위 개요를 참조하세요.

trace 범위

trace 범위는 Trace 탐색기 페이지에서 사용됩니다. 이 페이지가 열리면 시스템에서 기본 추적 범위에 나열된 프로젝트에 추적 데이터를 자동으로 쿼리합니다. 이 페이지에서는 범위를 전환할 수 있는 컨트롤도 제공합니다.

맞춤 trace 범위를 구성하지 않으면 Trace 탐색기 페이지에서 프로젝트에 trace 데이터를 쿼리합니다.

맞춤 추적 범위 생성 시점

여러 Google Cloud 프로젝트의 리소스에 의존하는 애플리케이션이 있는 경우 맞춤 추적 범위를 만듭니다.

추적 범위와 관련된 한도

설명	최댓값
프로젝트당 추적 범위 수	100
추적 범위당 프로젝트 수	20

자세한 내용은 trace 범위 만들기 및 관리를 참조하세요.

모니터링 가능성 범위 구성

이 섹션은 폴더 또는 조직에는 적용되지 않습니다.

로그 및 trace 데이터의 경우 보고 있는 프로젝트와 검색된 프로젝트 및 로그 뷰에 대한 Identity and Access Management (IAM) 역할에 따라 쿼리에서 반환되는 데이터가 달라집니다. 볼 권한이 없는 로그 데이터를 보기 위해 쿼리를 실행하면 쿼리에서 로그 데이터를 반환하지 않습니다.

측정항목 데이터의 경우 프로젝트의 측정항목 범위가 구성되면 프로젝트에 측정항목 범위에 나열된 프로젝트에서 저장한 측정항목 데이터에 대한 읽기 액세스 권한이 부여됩니다. 사용자에게 프로젝트의 측정항목 데이터를 볼 수 있는 ID 및 액세스 관리 역할이 부여되면 프로젝트에서 사용할 수 있는 측정항목 데이터를 볼 수 있습니다.

관측 가능성 범위를 구성하려면 기본 로그 범위와 기본 추적 범위를 설정합니다. 이 섹션의 나머지 부분에서는 이러한 작업을 완료하는 방법을 설명합니다.

시작하기 전에

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. 범위를 만들고 보는 데 필요한 권한을 얻으려면 관리자에게 다음의 IAM 역할을 부여해 달라고 요청하세요.

   • 로그 범위를 만들고 보거나 기본 로그 범위를 가져오려는 경우: 프로젝트에 대한 로그 구성 작성자(roles/logging.configWriter)
   • 측정항목 범위를 수정하려는 경우: 프로젝트나 측정항목 범위에 추가하려는 각 프로젝트에 대한 모니터링 관리자(roles/monitoring.admin)
   • trace 범위를 만들고 보거나 기본 범위를 가져오고 설정하려는 경우: 프로젝트에 대한 관측 가능성 범위 편집자 (roles/observability.scopesEditor)

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

   커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

   관측 가능성 범위 편집자 역할에는 추적 범위를 만들고 볼 수 있는 비공개 권한이 포함되어 있습니다. 이러한 권한은 커스텀 IAM 역할에 포함할 수 없습니다.

2. Select the tab for how you plan to use the samples on this page:

   Console

   When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

   gcloud

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

   REST

   로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

   Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.

   gcloud init

   외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

   자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

   기본 범위 보기 및 설정

   콘솔

   모니터링 가능성 범위를 구성하려면 기본 로그 범위, 측정항목 범위, 기본 trace 범위인 구성요소를 구성합니다.

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

      설정으로 이동

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

   2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.

   3. 기본 로그 범위를 구성합니다.

      1. 로그 범위 탭을 선택합니다.

         기존 로그 범위가 나열됩니다. '기본값' 아이콘()이 있는 항목이 기본 로그 범위입니다. 로그 범위를 만들려면 로그 범위 만들기를 클릭한 다음 대화상자를 완료합니다. 자세한 내용은 로그 범위 만들기 및 관리를 참조하세요.

      2. 기본값으로 지정할 항목을 찾아  더보기를 클릭한 다음 기본값으로 설정을 선택합니다.

   4. 측정항목 범위를 구성합니다.

      1. 측정항목 범위 탭을 선택합니다.
      2. Google Cloud 프로젝트 창에서 프로젝트 추가를 클릭한 다음 대화상자를 완료합니다. 자세한 내용은 측정항목 범위 구성을 참조하세요.

   5. 기본 trace 범위를 구성합니다.

      1. trace 범위 탭을 선택한 후 다음을 수행합니다.

         기존 trace 범위가 나열됩니다. '기본값' 아이콘()이 있는 항목이 기본 trace 범위입니다. trace 범위를 만들려면 로그 범위 만들기를 클릭한 다음 대화상자를 완료합니다. 자세한 내용은 trace 범위 만들기 및 관리를 참조하세요.

      2. 기본값으로 지정할 항목을 찾아  더보기를 클릭한 다음 기본값으로 설정을 선택합니다.

   gcloud

   참고: Google Cloud CLI를 사용하여 관측 가능 범위의 콘텐츠를 나열하고 기본 로그 범위를 설정할 수 있습니다. 이 인터페이스를 사용하여 기본 추적 범위를 설정할 수는 없습니다.

   모니터링 가능성 범위를 보고 설정하려면 다음을 수행합니다.

   1. 모니터링 가능성 범위의 설정을 보려면 gcloud observability scopes describe 명령어를 실행합니다.

      아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

      • OBSERVABILITY_SCOPE_ID: Scope 객체의 이름. 이 값은 _Default로 설정해야 합니다.
      • LOCATION: 위치 필드는 global로 설정되어야 합니다.
      • PROJECT_ID: 프로젝트 식별자

      gcloud observability scopes describe 명령어를 실행합니다.

      Linux, macOS 또는 Cloud Shell

      gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
         --location=LOCATION\
         --project=PROJECT_ID

      Windows(PowerShell)

      gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
         --location=LOCATION`
         --project=PROJECT_ID

      Windows(cmd.exe)

      gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
         --location=LOCATION^
         --project=PROJECT_ID

      명령어의 응답은 다음과 비슷합니다.

      logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
      traceScope: projects/my-project/locations/global/traceScopes/_Default
      name: projects/my-project/locations/global/scopes/_Default
      

   2. 모니터링 가능성 범위를 업데이트하려면 gcloud observability scopes update 명령어를 실행합니다. update 명령어에서 --log-scope 플래그를 포함하여 기본 로그 범위를 업데이트할 수 있습니다.

      아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

      • OBSERVABILITY_SCOPE_ID: Scope 객체의 이름. 이 값은 _Default로 설정해야 합니다.
      • LOG_SCOPE_FQN_ID: 로그 범위의 정규화된 ID입니다. 이 필드의 형식은 다음과 같습니다.

        logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

        이전 표현식에서 LOG_SCOPE_ID는 로그 범위의 ID입니다. 예를 들면 my-scope입니다.

      • LOCATION: 위치 필드는 global로 설정되어야 합니다.
      • PROJECT_ID: 프로젝트 식별자

      gcloud observability scopes update 명령어를 실행합니다.

      Linux, macOS 또는 Cloud Shell

      gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
         --log-scope=LOG_SCOPE_FQN_ID\
         --location=LOCATION\
         --project=PROJECT_ID

      Windows(PowerShell)

      gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
         --log-scope=LOG_SCOPE_FQN_ID`
         --location=LOCATION`
         --project=PROJECT_ID

      Windows(cmd.exe)

      gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
         --log-scope=LOG_SCOPE_FQN_ID^
         --location=LOCATION^
         --project=PROJECT_ID

      예를 들어 LOG_SCOPE_ID 값이 my-scope이면 응답은 다음과 비슷합니다.

      Updated scope [_Default].
      logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-scope
      name: projects/my-project/locations/global/scopes/_Default
      

   REST

   프리뷰

   이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참고하세요.

   API 호출을 사용하여 기본 로그 범위 또는 기본 trace 범위를 가져오고 설정하려면 모니터링 가능성 범위를 구성합니다. 모니터링 가능성 범위에는 기본 로그 범위와 기본 trace 범위가 표시됩니다.

   • 프로젝트의 기본 모니터링 가능성 범위를 가져오려면 projects.locations.scopes.get 엔드포인트로 요청을 보냅니다. 경로 매개변수를 지정해야 합니다. 응답은 기본 로그 범위와 기본 trace 범위를 나열하는 Scope 객체입니다.

   • 프로젝트의 기본 모니터링 가능성 범위를 업데이트하려면 projects.locations.scopes.patch 엔드포인트에 요청을 보냅니다. 경로 매개변수와 쿼리 매개변수를 지정하고 Scope 객체를 제공해야 합니다. 쿼리 매개변수는 변경된 필드를 식별합니다. 응답은 Scope 객체입니다.

   두 엔드포인트의 경로 매개변수는 다음과 같은 형식을 갖습니다.

   projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID
   

   이전 표현식의 필드는 다음과 같은 의미를 갖습니다.

   • PROJECT_ID: 프로젝트 식별자 App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
   • LOCATION: 위치 필드는 global로 설정되어야 합니다.
   • OBSERVABILITY_SCOPE_ID: Scope 객체의 이름. 이 필드는 _Default로 설정해야 합니다. 이름이 _Default인 Scope 객체는 자동으로 생성되며 기본 로그 범위와 기본 trace 범위에 관한 정보를 저장합니다.

   API 엔드포인트에 명령어를 전송하려면 참조 페이지에서 명령어를 실행할 수 있는 API 탐색기를 사용하면 됩니다. 예를 들어 현재 기본 범위를 가져오려면 다음을 수행하면 됩니다.

   1. projects.locations.scopes.get을 클릭합니다.

   2. 이 메서드 사용해 보기 위젯의 이름 필드에 다음을 입력합니다.

      projects/PROJECT_ID/locations/global/scopes/_Default
      

      이전 필드를 복사하기 전에 PROJECT_ID를 프로젝트 이름으로 바꿉니다.

   3. 실행을 선택합니다.

   4. 승인 대화상자에서 필수 단계를 완료합니다.

      응답은 다음 예시와 유사합니다.

      {
      "name": "projects/my-project/locations/global/scopes/_Default",
      "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
      "traceScope": "projects/my-project/locations/global/traceScopes/_Default"
      }
      

   범위 자세히 알아보기

   범위에 대한 자세한 내용은 다음 문서를 참고하세요.

   • 로그 범위 만들기 및 관리
   • 측정항목 범위 개요를 참고하세요.
   • 추적 범위 만들기 및 관리
   의견 보내기