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

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

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

시작하기 전에

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $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. 관측 가능성 API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할 (roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

    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. 관측 가능성 API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할 (roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

    API 사용 설정하기

    8.

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

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

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

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

  9. 다음 중 하나 이상이 있어야 합니다.

분석 뷰 만들기

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

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

    로그 애널리틱스로 이동

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

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

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

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

    1. 보기 메뉴에서 다음 중 하나를 실행합니다.

      • 로그 섹션으로 이동하여 로그 뷰를 선택합니다.
      • 트레이스 섹션으로 이동하여 _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자(영문 기준)로 제한되며 문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.

자세한 내용은 로그 애널리틱스를 참고하세요.

분석 뷰 나열

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

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

    로그 애널리틱스로 이동

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

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

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

애널리틱스 뷰에 대한 세부정보 가져오기

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

  • 이름
  • 생성일
  • 최종 업데이트
  • 스키마
  • Query.

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

  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 콘솔을 사용하여 분석 보기를 만들거나 관리해야 합니다.
  • Google Cloud 프로젝트당 최대 100개의 분석 뷰를 만들 수 있습니다.
  • 리전당 최대 50개의 분석 보기를 만들 수 있습니다.
  • Google Cloud 프로젝트당 최대 10개의 리전에 분석 뷰가 포함될 수 있습니다.

다음 단계