BigQuery로 Cloud Billing 데이터 내보내기 설정

이 가이드에서는 BigQuery로 Cloud Billing 데이터 내보내기를 사용 설정하는 데 필요한 모든 설정 단계를 제공합니다.

개요

BigQuery로 Cloud Billing 데이터를 내보내려면 다음 단계를 따라야 합니다.

  • Cloud Billing 데이터가 저장될 프로젝트를 만들고 프로젝트에서 결제를 사용 설정합니다(아직 설정하지 않은 경우).
  • 프로젝트 및 Cloud Billing 계정에 대한 권한을 구성합니다.
  • 가격 책정 데이터 내보내기를 위해 필요한 BigQuery Data Transfer Service API를 사용 설정합니다.
  • 데이터를 저장할 BigQuery 데이터 세트를 만듭니다.
  • 데이터 세트에 쓸 비용 데이터와 가격 책정 데이터의 Cloud Billing 내보내기를 사용 설정합니다.

이 문서에서는 이러한 각 단계에 대해 자세히 설명합니다.

Cloud Console 정보

Google Cloud Console(문서 보기, Console 열기)은 Google Cloud 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. Cloud Console을 사용하여 Google Cloud 및 Cloud Billing 리소스를 설정하고 관리할 수 있습니다.

이 작업에 필요한 권한

Google Cloud Billing 사용량 비용데이터를 BigQuery 데이터 세트로 내보내기를 사용 설정하고 구성하려면 다음 권한이 있어야 합니다.

  • Cloud Billing의 경우 대상 Cloud Billing 계정에 결제 계정 비용 관리자 역할 또는 결제 계정 관리자 역할이 있어야 합니다.
  • BigQuery의 경우 Cloud Billing 데이터를 저장하는 데 사용할 BigQuery 데이터 세트가 포함된 Cloud 프로젝트의 BigQuery 사용자 역할이 필요합니다.

Cloud Billing 가격 책정 데이터 내보내기를 사용 설정하고 구성하려면 다음 권한이 필요합니다.

  • Cloud Billing의 경우 대상 Cloud Billing 계정에 결제 계정 관리자 역할이 있어야 합니다.
  • BigQuery의 경우 Cloud Billing 가격 책정 데이터를 저장하는 데 사용할 BigQuery 데이터 세트가 포함된 Cloud 프로젝트의 BigQuery 관리자 역할이 필요합니다.
  • 대상 데이터 세트가 포함된 Cloud 프로젝트의 경우 resourcemanager.projects.update 권한이 필요합니다. 이 권한은 roles/editor 역할에 포함되어 있습니다.

다른 프로젝트 권한이 필요할 수도 있습니다. Google Cloud 조직의 구성원이 새 프로젝트를 만들려면 조직 또는 폴더에 대한 프로젝트 생성자 역할이 필요합니다. 특히 새 프로젝트를 만들려면 다음 권한이 필요합니다.

  • resourcemanager.organizations.get
  • resourcemanager.projects.create

Google Cloud 권한에 대한 자세한 내용은 다음을 참조하세요.

BigQuery로 Cloud Billing 데이터 내보내기 사용 설정

이 섹션에 자세히 설명된 단계를 완료하여 BigQuery로 Cloud Billing 데이터 내보내기를 사용 설정합니다.

1. 프로젝트 선택 또는 만들기

BigQuery로 내보낸 Cloud Billing 데이터는 BigQuery 데이터 세트에 포함되어 있습니다. 데이터 세트는 지정한 클라우드 프로젝트 내에 포함됩니다.

프로젝트 관련 권장사항: 내보낸 Cloud Billing 데이터를 포함하여 모든 결제 관리 요구 사항을 포함하는 클라우드 프로젝트를 만드는 것이 좋습니다. 또한 이 결제 관리 클라우드 프로젝트를 사용하여 Cloud Billing API 액세스, 프로그래매틱 방식의 예산 알림을 위한 Pub/Sub 채널, 기타 Cloud Billing 관리 작업을 수행할 수 있습니다.

중요: 데이터 세트를 포함하도록 선택한 클라우드 프로젝트는 BigQuery 데이터 세트로 내보내려는 데이터가 포함된 같은 Cloud Billing 계정에 연결되어야 합니다. Cloud 프로젝트는 한 번에 Cloud Billing 계정 하나에만 연결됩니다. Cloud Billing 계정은 프로젝트 한 개 이상에 연결됩니다.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

프로젝트 만들기 및 관리에 대해 자세히 알아보세요.

2. 결제가 사용 설정되어 있는지 확인

데이터 세트를 포함하도록 선택한 클라우드 프로젝트에서 결제가 사용 설정되었는지, 그리고 클라우드 프로젝트가 BigQuery 데이터 세트로 내보낼 데이터가 포함된 같은 Cloud Billing 계정에 연결되어있는지 확인합니다.

3. BigQuery Data Transfer Service API를 사용 설정

Cloud Billing 가격 책정 데이터를 BigQuery로 내보내려면 BigQuery Data Transfer Service API를 사용 설정해야 합니다. Cloud Billing 가격 책정 데이터를 내보낼 계획이 없으면 4단계로 건너뛰어도 됩니다. BigQuery 데이터 세트 만들기로 건너뛰어도 됩니다.

BigQuery 데이터 세트를 포함하는 데 사용하는 것과 동일한 클라우드 프로젝트에서 BigQuery Data Transfer Service API를 사용 설정해야 합니다. 프로젝트 섹션의 권장사항을 따랐다면 이는 사용자의 결제 관리 Google Cloud 프로젝트입니다.

BigQuery Data Transfer Service API를 사용 설정하려면 다음을 수행하세요.

  1. Google Cloud Console에 로그인하고 API 페이지로 이동합니다.

    BigQuery Data Transfer Service API 페이지로 이동

  2. 메시지가 표시되면 프로젝트를 선택합니다. BigQuery 데이터 세트를 포함하는 데 사용하는 프로젝트와 동일한 프로젝트에서 BigQuery Data Transfer Service API를 사용 설정해야 합니다. 프로젝트 섹션의 권장사항을 따랐다면 이는 사용자의 결제 관리 Google Cloud 프로젝트입니다.

  3. BigQuery Data Transfer Service API 페이지에서 사용 설정을 클릭하여 선택한 프로젝트에서 API를 사용 설정합니다.

API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.

4. BigQuery 데이터 세트 만들기

BigQuery로 Cloud Billing 데이터를 내보내도록 만들기 전에 내보낸 데이터를 관리할 BigQuery 데이터 세트를 하나 이상 만들어야 합니다. 동일한 데이터 세트를 사용하여 표준 사용량 비용 데이터, 상세 사용량 비용 데이터, 가격 책정 데이터를 포함할 수 있습니다.

데이터 세트는 지정한 클라우드 프로젝트 내에 포함됩니다. 데이터 세트는 테이블에 대한 액세스를 구성하고 제어하는 데 사용하는 최상위 컨테이너입니다. 테이블이나 뷰는 반드시 데이터 세트에 속해야 하므로, 데이터 세트를 한 개 이상 만든 후에 데이터를 BigQuery로 로드해야 합니다.

새 데이터 세트를 만드는 경우 위치에 대해 미국(US) 또는 유럽 연합(EU)과 같이 멀티 리전 옵션을 선택하는 것이 좋습니다. 예를 들어 상세 사용량 비용 데이터는 멀티 리전 US 및 EU 데이터 세트에서만 지원됩니다.

기존 데이터 세트를 사용하는 경우 고객 관리 암호화 키가 사용 설정된 데이터 세트를 사용할 수 없는 경우 또는 상세 사용량 비용 데이터에 멀티 리전 데이터 세트가 필요한 경우와 같이 결제 데이터를 BigQuery로 내보내는 데 영향을 줄 수 있는 제한사항을 검토합니다.

BigQuery 데이터세트를 만들려면 다음을 수행합니다.

  1. Google Cloud Console에 로그인하고 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. Google Cloud Console 페이지 상단의 프로젝트 드롭다운 목록( 내 프로젝트 )에서 데이터 세트를 포함하도록 설정한 프로젝트를 선택합니다. 다음 단계에서 사용할 수 있도록 프로젝트 ID를 기록합니다.

  3. 탐색기 패널의 고정된 프로젝트 섹션에서 your-project-ID를 클릭하여 프로젝트를 엽니다. 프로젝트 ID 옆에 더보기 메뉴()가 표시되면 메뉴를 클릭하고 열기를 선택합니다.

  4. 데이터 세트 만들기를 클릭합니다. 데이터 세트 만들기 패널이 열립니다.

    1. 데이터 세트 ID를 입력합니다. 프로젝트별 ID가 아닌 all_billing_data와 같이 프로젝트를 포함하는 ID를 사용하는 것이 좋습니다.
    2. 데이터 위치를 선택합니다. 데이터 위치는 데이터가 저장되는 리전을 지정합니다. 이 데이터 세트에 있는 모든 테이블이 이 위치를 공유합니다.

      데이터 세트를 만들 때는 위치에 미국(US) 또는 유럽 연합(EU)과 같은 멀티 리전 옵션을 선택하는 것이 좋습니다. 이는 상세 사용량 비용 데이터를 내보내는 데 필요합니다.

      데이터 세트를 만든 후에는 이 위치를 변경할 수 없습니다. 위치 자세히 알아보기

    3. 기본 테이블 만료 시간사용 안 함으로 설정합니다.

      사용 안함을 선택하면 데이터가 보존됩니다. 일 수를 입력하면 이 데이터 세트에 새로 생성된 테이블은 생성된 후 지정된 일 수가 지나면 자동으로 삭제됩니다. 중요: 내보낸 Cloud Billing 데이터 레코드가 포함된 테이블을 삭제하면 이 레코드가 삭제되어 삭제된 레코드를 백필할 수 없습니다.

    4. 암호화 옵션을 Google 관리 키로 설정합니다.

      Cloud Billing 데이터 레코드를 BigQuery로 내보내는 경우에는 고객 관리 키 암호화가 지원되지 않습니다.

    5. 저장하려면 데이터세트 만들기를 클릭합니다.

BigQuery로 결제 데이터 내보내기에 영향을 줄 수 있는 제한사항을 참조하세요.

5. Cloud Billing을 BigQuery 데이터 세트로 내보내기 사용 설정

Cloud Console의 Cloud Billing 섹션에서 Cloud Billing 데이터 내보내기를 사용 설정합니다. 다음은 내보낼 수 있는 데이터 유형입니다.

  • 표준 사용량 비용 데이터 - 계정 ID, 인보이스 날짜, 서비스, SKU, 프로젝트, 라벨, 위치, 비용, 사용량, 크레딧, 조정, 통화 등의 표준 Cloud Billing 계정 비용 사용량 정보를 포함합니다. 리소스 수준 비용 데이터를 검토하지 않으려면 이 옵션을 사용 설정합니다.
  • 상세 사용량 비용 데이터 - 자세한 Cloud Billing 계정 비용 사용량 정보를 포함합니다. 표준 사용량 비용 데이터의 모든 정보와 서비스 사용량을 생성하는 가상 머신 또는 SSD 등 리소스 수준의 비용 데이터를 포함합니다. 표준 사용량 비용 데이터와 함께 리소스 수준 비용 데이터를 분석하려면 이 옵션을 사용 설정합니다. 표준상세를 모두 사용 설정할 필요는 없습니다.
  • 가격 책정 데이터 - 계정 ID, 서비스, SKU, 제품, 지역 메타데이터, 가격 책정 단위, 통화, 집계, 등급과 같은 Cloud Billing 계정 가격 책정 정보가 포함됩니다.

Cloud Billing 사용량 비용 또는 가격 책정 데이터를 BigQuery로 내보내려면 다음 안내를 따르세요.

  1. Google Cloud Console에 로그인합니다.

    Cloud Console에 로그인

  2. Console 탐색 메뉴()를 열고 결제를 선택합니다.

    Cloud Billing 계정이 두 개 이상 있으면 다음 중 하나를 수행하세요.

    • 현재 Cloud 프로젝트의 Cloud Billing을 관리하려면 연결된 결제 계정으로 이동을 선택합니다.
    • 다른 Cloud Billing 계정을 찾으려면 결제 계정 관리를 선택하고 Cloud Billing 데이터를 BigQuery로 내보내기를 사용 설정할 계정을 선택합니다.
  3. 결제 탐색 메뉴에서 결제 내보내기를 선택합니다.

  4. BigQuery 내보내기 탭을 선택합니다(기본적으로 선택된 탭).

  5. 내보낼 데이터 유형의 설정 수정을 클릭합니다. 각 데이터 유형은 개별적으로 구성됩니다.

  6. 프로젝트 목록에서 BigQuery 데이터 세트를 포함하도록 설정한 프로젝트를 선택합니다.

    선택한 프로젝트는 내보낸 Cloud Billing 데이터를 BigQuery 데이터 세트에 저장하는 데 사용됩니다.

    표준상세 사용량 비용 데이터 내보내기의 경우 Cloud Billing 데이터에는 동일한 Cloud Billing 계정으로 결제되는 클라우드 프로젝트 모두에 대한 사용량/비용 데이터가 포함됩니다.

    가격 책정 데이터 내보내기의 경우 Cloud Billing 데이터에 선택한 데이터 세트 프로젝트에 연결된 Cloud Billing 계정의 가격 책정 데이터만 포함됩니다.

  7. 데이터 세트 ID 필드에서 내보낸 Cloud Billing 데이터를 포함하도록 설정한 데이터 세트를 선택합니다.

    BigQuery로 내보낸 모든 유형의 Cloud Billing 데이터에는 다음이 적용됩니다.

    • BigQuery로 데이터를 내보내려면 BigQuery API가 필요합니다. 선택한 프로젝트에 BigQuery API가 사용 설정되지 않은 경우 사용 설정하라는 메시지가 표시됩니다. BigQuery API 사용 설정을 클릭하여 API를 사용 설정합니다.
    • 선택한 프로젝트에 BigQuery 데이터 세트가 포함되지 않은 경우 데이터 세트를 만들라는 메시지가 표시됩니다. 필요한 경우 다음 단계를 따라 새 데이터 세트를 만듭니다.
    • 기존 데이터 세트를 사용하는 경우 결제 데이터를 BigQuery로 내보내는 데 영향을 미칠 수 있는 제한사항(예: 고객 관리 키 암호화를 사용하도록 구성된 데이터 세트로 데이터를 내보낼 수 없음)을 검토합니다.

    가격 책정 데이터 내보내기의 경우 BigQuery로 데이터를 내보내려면 BigQuery Data Transfer Service API가 필요합니다. 선택한 프로젝트에 BigQuery Data Transfer Service API가 사용 설정되지 않은 경우에는 사용 설정하라는 메시지가 표시됩니다. 필요한 경우 다음 단계에 따라 API를 사용 설정합니다.

  8. 저장을 클릭합니다.

내보낼 Cloud Billing 데이터 업데이트

Cloud Billing 데이터를 BigQuery로 내보내도록 사용 설정한 후 다른 유형을 사용 중지하거나 사용 설정하여 내보낼 데이터를 변경할 수 있습니다.

데이터 내보내기를 중지하기 전에 제한사항데이터 가용성 가이드라인을 검토하여 BigQuery로 내보낸 결제 데이터에 미치는 영향을 확인합니다.

BigQuery로 내보내는 Cloud Billing 유형을 사용 중지하려면 다음 단계를 따르세요.

  1. 그에 따라 표준 내보내기 사용 중지, 상세 내보내기 사용 중지 또는 가격 책정 내보내기 사용 중지를 선택합니다.
  2. 확인을 선택하여 선택사항을 저장합니다.

현재 사용 중지된 Cloud Billing 유형을 BigQuery로 내보내는 기능을 사용 설정하려면 Cloud Billing 데이터를 BigQuery로 내보내도록 설정을 참조하세요.

데이터 세트 권한 정보

Cloud Billing을 BigQuery로 내보내기는 서비스 계정을 사용하여 데이터 세트 권한을 관리합니다.

BigQuery로 Cloud Billing 내보내기를 사용 설정하면 Google에서는 자동으로 사용자가 지정한 데이터 세트에 소유자로 서비스 계정을 추가합니다. 서비스 계정은 다음과 같습니다.

  • 표준 및 세부 사용량 비용 데이터 세트의 경우: billing-export-bigquery@system.gserviceaccount.com
  • 가격 책정 데이터 세트의 경우: cloud-account-pricing@cloud-account-pricing.iam.gserviceaccount.com

서비스 계정은 Google에서 소유하고 관리하며, 오프라인 프로세스에서 테이블을 만들고 Cloud Billing 레코드를 기록하는 데 필요한 권한을 제공합니다.

BigQuery로 결제 데이터 내보내기에 영향을 줄 수 있는 제한사항을 참조하세요.

결제 데이터 테이블

Cloud Billing을 BigQuery로 내보내기를 사용 설정한 직후 결제 데이터 테이블이 BigQuery 데이터 세트에 자동으로 생성됩니다. 이러한 BigQuery 테이블 및 테이블 스키마에 대한 자세한 내용은 BigQuery에서 자동 생성된 데이터 테이블 이해하기를 참조하세요.

데이터 로드 빈도

  • BigQuery로 표준 또는 상세 사용량 비용 내보내기를 처음 사용 설정하면 Google Cloud 비용 데이터가 표시되는 데 몇 시간이 걸릴 수 있습니다.
  • BigQuery로 가격 내보내기를 처음 사용 설정하면 Google Cloud 가격 책정 데이터가 표시되는 데 최대 48시간이 걸릴 수 있습니다.

BigQuery 테이블로 로드하는 데이터 빈도에 대한 자세한 내용은 데이터 로드 빈도를 참조하세요.

제한사항

Cloud Billing 데이터를 BigQuery로 내보내려면 다음과 같은 제한사항이 적용됩니다.

  • 표준 사용량 비용가격 책정 데이터가 포함된 BigQuery 데이터 세트에는 내보내기를 처음 사용 설정한 날짜부터 발생한 Google Cloud Billing 데이터만 반영됩니다. 즉, Google Cloud 결제 데이터는 소급하여 추가되지 않으므로 내보내기를 사용 설정하기 전의 Cloud Billing 데이터는 표시되지 않습니다. 자세한 내용은 데이터 가용성을 참조하세요.
  • 상세 사용량 비용 데이터가 포함된 BigQuery 데이터 세트는 내보내기를 다시 사용 설정하지 않는 한 내보내기를 처음 사용 설정한 전월 초부터 발생한 Google Cloud Billing 데이터를 반영합니다. 즉, 이번 달과 지난달에 대해서만 Google Cloud Billing 데이터가 소급하여 추가됩니다. 자세한 내용은 데이터 가용성을 참조하세요.
  • 상세 사용량 비용 데이터를 내보낼 때 미국(US) 또는 유럽 연합(EU)과 같은 멀티 리전 위치로 구성된 데이터 세트로 내보내야 합니다. 멀티 리전 위치가 아닌 데이터 세트를 선택하면 Cloud Billing에서 해당 데이터 세트 내의 적절한 테이블에 상세 결제 데이터를 쓰지 못하게 됩니다.
  • 결제 데이터를 BigQuery로 내보낼 때는 고객 관리 암호화 키(CMEK)가 지원되지 않습니다. 결제 데이터 데이터 세트에 CMEK를 사용 설정하면 Cloud Billing에서 해당 데이터 세트 내의 적절한 테이블에 결제 데이터를 쓰지 못하게 됩니다. 대신 Google 관리 키 암호화를 사용하도록 데이터 세트를 구성해야 합니다.

Google Cloud Console에서 사용 가능한 비용 및 가격 책정 보고서