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

이 문서에서는 분석 뷰를 만들고, 관리하고, 쿼리하는 방법을 설명합니다. 개념 개요는 분석 뷰 정보를 참고하세요.

시작하기 전에

분석 뷰는 로그 뷰를 쿼리하므로 분석 뷰를 만들고 쿼리하려면 IAM 역할에서 로그 뷰를 쿼리하고 로그 애널리틱스를 사용할 수 있어야 합니다. 이 섹션에서는 분석 뷰를 만드는 데 필요한 IAM 역할과 로그 뷰를 쿼리하고 로그 애널리틱스를 사용하는 데 필요한 IAM 역할을 보여줍니다.

  • 분석 뷰를 만들고, 관리하고, 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Observability Analytics 사용자 (roles/observability.analyticsUser) IAM 역할을 부여해 달라고 요청하세요.

    이 사전 정의된 역할에는 분석 보기를 만들고, 관리하고, 사용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

    필수 권한

    분석 뷰를 만들고, 관리하고, 사용하려면 다음 권한이 필요합니다.

    • observability.analyticsViews.get
    • observability.analyticsViews.list
    • observability.analyticsViews.create
    • observability.analyticsViews.update
    • observability.analyticsViews.delete

  • 로그 뷰를 쿼리하고 로그 애널리틱스를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

    • _Required 및 _Default 로그 버킷을 쿼리하려는 경우: 로그 뷰어(roles/logging.viewer)
    • 프로젝트의 모든 로그 뷰를 쿼리하려는 경우: 로그 뷰 접근자(roles/logging.viewAccessor)

    프로젝트 수준에서 부여된 로그 뷰 액세스자 역할에 IAM 조건을 추가하거나 로그 뷰의 정책 파일에 IAM 바인딩을 추가하여 주 구성원을 특정 로그 뷰로 제한할 수 있습니다. 자세한 내용은 로그 뷰에 대한 액세스 제어를 참조하세요.

    사용자 정의 버킷의 뷰를 쿼리하거나 _Default 로그 버킷의 _AllLogs 뷰를 쿼리해야 하는 추가 역할에 대한 자세한 내용은 Cloud Logging 역할을 참고하세요.

분석 뷰 만들기

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

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

    로그 애널리틱스로 이동

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

  2. 뷰 메뉴에서 로그 섹션으로 이동한 다음 쿼리할 로그 뷰를 선택합니다.

    로그 뷰를 찾으려면 필터 막대를 사용하거나 로그 뷰 목록을 스크롤하세요. 목록의 각 항목은 다음 형식 BUCKET_ID.LOG_VIEW_ID이며, 여기서 이러한 필드는 로그 버킷 및 로그 뷰의 ID를 참조합니다.

  3. 스키마 툴바에서 쿼리를 클릭합니다.

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

  4. 툴바에 쿼리 실행이 표시되는지 확인합니다.

    툴바에 BigQuery에서 실행이 표시되면 설정을 클릭하고 로그 애널리틱스 (기본값)를 선택합니다.

  5. 쿼리 결과가 만족스러울 때까지 쿼리 창에서 SQL 쿼리를 업데이트합니다.

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

  7. 분석 보기의 이름과 설명을 입력한 후 저장을 클릭합니다.

    애널리틱스 뷰가 생성되고 뷰 창의 애널리틱스 뷰 섹션에 표시됩니다. 목록의 각 항목은 다음 형식 LOCATION.ANALYTICS_VIEW_ID이며, 이 필드는 분석 뷰의 위치와 ID를 참조합니다. 예를 들어 로그 버킷이 global 리전에 있는 로그 뷰를 쿼리하는 my-analytic-view라는 분석 뷰를 만든 경우 이 섹션에는 global.my-analytic-view이 표시됩니다.

분석 뷰 쿼리

분석 뷰가 있으면 로그 뷰를 쿼리하는 것과 비슷하게 쿼리할 수 있습니다. 로그 애널리틱스 페이지를 사용하는 방법을 설명하는 문서 목록은 이 문서의 다음 단계 섹션을 참고하세요.

분석 뷰의 기본 쿼리를 실행하려면 다음 단계를 따르세요.

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

    로그 애널리틱스로 이동

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

  2. 분석 보기의 쿼리를 입력하거나 기본 쿼리를 로드합니다. 쿼리의 FROM 절은 다음과 같은 형식이어야 합니다.

    FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

    이전 표현식에서 필드의 의미는 다음과 같습니다.

    • PROJECT_ID: 프로젝트 식별자
    • LOCATION: 분석 뷰의 위치입니다. 분석 뷰의 위치는 쿼리하는 리소스에서 상속됩니다. 예를 들어 분석 보기가 global 위치에 있는 로그 보기를 쿼리하는 경우 분석 보기의 위치도 global입니다.
    • ANALYTICS_VIEW_ID: 분석 보기의 ID입니다.

    기본 쿼리를 실행하려면 다음 단계를 따르세요.

    1. 뷰 메뉴에서 애널리틱스 보기 섹션으로 이동하여 쿼리할 애널리틱스 보기를 선택합니다.

      분석 보기를 찾으려면 필터 막대를 사용하거나 분석 보기 목록을 스크롤하세요. 목록의 각 항목은 다음 형식 LOCATION.ANALYTICS_VIEW_ID이며, 이 필드는 분석 뷰의 위치와 ID를 참조합니다.

    2. 스키마 툴바에서 쿼리를 클릭합니다.

      선택한 분석 보기를 쿼리하는 SQL 쿼리로 쿼리 창이 업데이트됩니다.

  3. 쿼리 실행을 클릭합니다.

    툴바에 BigQuery에서 실행이 표시되면 설정을 클릭하고 로그 애널리틱스 (기본값)를 선택합니다.

분석 뷰 나열

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

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

    로그 애널리틱스로 이동

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

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

    애널리틱스 보기 목록이 표시됩니다. 목록의 각 항목은 다음 형식 LOCATION.ANALYTICS_VIEW_ID입니다. 여기서 이러한 필드는 분석 뷰의 위치와 ID를 참조합니다. 예를 들어 로그 버킷이 global 리전에 있는 로그 뷰를 쿼리하는 my-analytic-view라는 분석 뷰를 만든 경우 이 섹션에는 global.my-analytic-view이 표시됩니다.

  3. 특정 분석 뷰의 세부정보를 보려면 다음 단계를 따르세요.

    1. 애널리틱스 보기를 선택합니다.

      분석 뷰의 스키마는 스키마 섹션에 표시됩니다.

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

      이 대화상자에는 애널리틱스 보기가 생성된 시점, 스키마, 쿼리 등 애널리틱스 보기에 관한 정보가 표시됩니다.

분석 보기 수정

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

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

    로그 애널리틱스로 이동

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

  2. 뷰 메뉴에서 애널리틱스 보기 섹션으로 이동하여 쿼리할 애널리틱스 보기를 선택합니다.

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

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

  4. 수정을 마친 후 저장된 뷰 덮어쓰기를 클릭합니다.

분석 뷰 삭제

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

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

    로그 애널리틱스로 이동

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

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

제한사항

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

  • 분석 뷰는 다른 분석 뷰를 쿼리할 수 없습니다.
  • 분석 뷰는 여러 로그 뷰를 쿼리할 수 있습니다. 그러나 쿼리된 로그 뷰를 호스팅하는 로그 버킷은 한 위치에 있어야 합니다. 예를 들어 us-east1에 하나, asia-east1에 하나씩 로그 버킷이 두 개 있다고 가정해 보겠습니다. 이러한 로그 버킷에서 로그 뷰를 쿼리하는 분석 뷰를 만들 수 없습니다.
  • 분석 뷰의 상위 리소스는 Google Cloud 프로젝트여야 합니다. 폴더 또는 조직에서는 분석 보기를 만들 수 없습니다.
  • 연결된 데이터 세트는 분석 뷰에서 지원되지 않습니다. 따라서 로그 애널리틱스 페이지를 사용하여야만 분석 뷰를 쿼리할 수 있습니다. 또한 기본 Cloud Logging 서비스에서 이러한 쿼리를 실행해야 합니다.
  • 분석 뷰를 만들거나 관리하기 위한 API 지원은 없습니다.

  • 분석 뷰에는 다음과 같은 한도가 적용됩니다.

    • Google Cloud 프로젝트당 최대 분석 뷰 수: 100
    • Google Cloud 프로젝트당 지역별 최대 분석 뷰 수: 50
    • Google Cloud 프로젝트당 분석 뷰를 저장할 수 있는 최대 지역 수: 10개

다음 단계