분석 뷰 만들기, 쿼리, 관리

이 문서에서는 분석 뷰를 만들고 관리하는 방법을 설명합니다. 분석 뷰를 만든 후 관측 가능성 뷰를 쿼리하는 것과 비슷한 방식으로 쿼리할 수 있습니다.

분석 뷰에 대한 개요는 분석 뷰 정보를 참고하세요.

시작하기 전에

  1. 계정에 로그인합니다. Google Cloud 를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. Google Cloud신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

  2. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. 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

    8.

  8. 분석 뷰를 만들고 관리하고 사용하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

    • Observability 뷰 접근자 (roles/observability.viewAccessor) 쿼리할 관측 가능성 뷰에 대한 이 역할은 권한 부여를 특정 뷰로 제한할 수 있는 IAM 조건을 지원합니다. 역할 부여에 조건을 연결하지 않으면 주 구성원이 모든 관측 가능성 뷰에 액세스할 수 있습니다. 관측 가능성 뷰는 공개 프리뷰 버전입니다.
    • Observability 분석 사용자 (roles/observability.analyticsUser) 프로젝트에 대한. 이 역할에는 비공개 쿼리를 저장하고 실행하는 데 필요한 권한과 공유 쿼리를 실행하는 데 필요한 권한이 포함되어 있습니다.
    • 로그 뷰어 (roles/logging.viewer) 프로젝트에 대한.

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

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

  9. 관측 가능성 뷰가 있는지 확인합니다. 자세한 내용은 Cloud Trace 스토리지 모델을 참조하세요.

분석 뷰 만들기

분석 뷰를 만들려면 다음 단계를 따르세요.

  1. 콘솔에서 로그 애널리틱스 페이지로 이동합니다. Google Cloud

    로그 애널리틱스로 이동

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

  2. 로그 애널리틱스 페이지를 구성합니다.
    1. 툴바에 쿼리 실행 이 표시되는지 확인합니다. 툴바에 BigQuery에서 실행이 표시되면 설정을 클릭하고 로그 애널리틱스 (기본값)을 선택합니다.
    2. 뷰 메뉴가 표시되지 않으면 탐색창으로 이동하여 뷰 및 스키마를 클릭합니다.

  3. 분석 뷰로 저장할 쿼리를 입력하고 유효성을 검사합니다.

    분석 뷰가 쿼리할 관측 가능성 뷰의 기본 쿼리를 로드하고 수정할 수 있습니다. 기본 쿼리를 로드하려면 다음 단계를 따르세요.

    1. 뷰 메뉴에서 Trace 섹션으로 이동한 후 _Trace.Spans._AllSpans를 선택합니다.

    2. 스키마 툴바에서 쿼리를 클릭한 후 덮어쓰기를 클릭합니다.

      쿼리 창이 SQL 쿼리로 업데이트됩니다.

    3. 쿼리 결과가 만족스러울 때까지 쿼리를 업데이트합니다.

  4. 분석 뷰를 만듭니다.

    1. 툴바에서 저장을 클릭한 후 분석 뷰로 저장을 선택합니다.

    2. 분석 뷰의 이름과 설명을 입력합니다.

      이름은 100자(영문 기준)로 제한되며 문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다. 분석 뷰를 만든 후에는 이름을 변경할 수 없습니다.

    3. 저장 을 클릭합니다.

    시스템에서 분석 뷰를 만들고 뷰 창의 분석 뷰 섹션에 나열합니다.

분석 뷰 쿼리

관측 가능성 뷰를 쿼리하는 것과 비슷한 방식으로 분석 뷰를 쿼리합니다. 분석 뷰를 쿼리하려면 FROM 절에 다음 형식을 사용합니다.

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

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

  • PROJECT_ID: 프로젝트 식별자
  • LOCATION: 분석 뷰의 위치.
  • ANALYTICS_VIEW_ID: 분석 뷰의 ID로, 100자(영문 기준)로 제한되며 문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.

자세한 내용은 trace 쿼리 및 분석을 참조하세요.

분석 뷰 나열

프로젝트에서 분석 뷰를 나열하려면 다음 단계를 따르세요. Google Cloud

  1. 콘솔에서 로그 애널리틱스 페이지로 이동합니다. Google Cloud

    로그 애널리틱스로 이동

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

  2. 로그 애널리틱스 페이지를 구성합니다.
    1. 툴바에 쿼리 실행 이 표시되는지 확인합니다. 툴바에 BigQuery에서 실행이 표시되면 설정을 클릭하고 로그 애널리틱스 (기본값)을 선택합니다.
    2. 뷰 메뉴가 표시되지 않으면 탐색창으로 이동하여 뷰 및 스키마를 클릭합니다.

  3. 뷰 메뉴에서 분석 뷰 섹션으로 이동합니다.

분석 뷰에 대한 세부정보 가져오기

스키마 창의 옵션을 사용하여 분석 뷰에 대한 다음 정보를 표시할 수 있습니다.

  • 이름
  • 생성일
  • 최종 업데이트
  • 스키마
  • 쿼리

분석 뷰의 세부정보를 보려면 프로젝트의 분석 뷰를 나열한 후 다음 단계를 따르세요.

  1. 정보를 보려는 분석 뷰를 선택합니다.
  2. 스키마 툴바에서 분석 뷰 옵션 보기를 클릭하고 세부정보 보기를 선택합니다.

분석 뷰 수정

분석 뷰를 수정하려면 다음 단계를 따르세요.

  1. 콘솔에서 로그 애널리틱스 페이지로 이동합니다. Google Cloud

    로그 애널리틱스로 이동

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

  2. 로그 애널리틱스 페이지를 구성합니다.
    1. 툴바에 쿼리 실행 이 표시되는지 확인합니다. 툴바에 BigQuery에서 실행이 표시되면 설정을 클릭하고 로그 애널리틱스 (기본값)을 선택합니다.
    2. 뷰 메뉴가 표시되지 않으면 탐색창으로 이동하여 뷰 및 스키마를 클릭합니다.

  3. 뷰 메뉴에서 분석 뷰 섹션으로 이동하여 수정할 분석 뷰를 선택합니다.

  4. 스키마 툴바에서 분석 뷰 옵션 보기를 클릭하고 뷰 수정을 선택합니다.

    분석 뷰에 대한 정보가 표시된 대화상자가 열립니다. 설명과 쿼리를 수정할 수 있습니다.

  5. 수정을 완료한 후 저장된 뷰 덮어쓰기 를 클릭합니다.

분석 뷰 삭제

분석 뷰를 삭제하려면 다음 단계를 따르세요.

  1. 콘솔에서 로그 애널리틱스 페이지로 이동합니다. Google Cloud

    로그 애널리틱스로 이동

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

  2. 로그 애널리틱스 페이지를 구성합니다.
    1. 툴바에 쿼리 실행 이 표시되는지 확인합니다. 툴바에 BigQuery에서 실행이 표시되면 설정을 클릭하고 로그 애널리틱스 (기본값)을 선택합니다.
    2. 뷰 메뉴가 표시되지 않으면 탐색창으로 이동하여 뷰 및 스키마를 클릭합니다.

  3. 뷰 메뉴에서 분석 뷰 섹션으로 이동하여 삭제할 분석 뷰를 선택합니다.
  4. 스키마 툴바에서 분석 뷰 옵션 보기를 클릭하고 뷰 삭제를 선택한 후 대화상자를 완료합니다.

제한사항

분석 뷰에는 다음과 같은 제한사항이 적용됩니다.

  • 분석 뷰는 관측 가능성 뷰만 쿼리할 수 있습니다.
  • 분석 뷰의 상위 리소스는 Google Cloud 프로젝트여야 합니다.
  • 로그 애널리틱스 페이지를 사용하고 로그 애널리틱스 (기본값) 쿼리 엔진을 사용하는 경우에만 분석 뷰를 쿼리할 수 있습니다.
  • 분석 뷰가 쿼리하는 모든 뷰는 동일한 위치에 있어야 합니다.
  • 콘솔을 사용하여 분석 뷰를 만들거나 관리해야 합니다. Google Cloud
  • 프로젝트당 최대 100 개의 분석 뷰를 만들 수 있습니다 Google Cloud .
  • 리전당 최대 50개의 분석 뷰를 만들 수 있습니다.
  • 프로젝트당 최대 10 개의 리전에 분석 뷰가 포함될 수 있습니다. Google Cloud

다음 단계