Compute Engine에서는 사용량 내보내기 기능을 사용하여 Compute Engine 사용량의 세부 보고서를 Cloud Storage 버킷으로 내보낼 수 있습니다. 사용량 보고서에는 리소스 수명에 대한 정보도 나와 있습니다. 예를 들어 프로젝트에서 n2-standard-4
머신 유형을 실행 중인 VM 인스턴스 수와 각 인스턴스가 실행되고 있는 시간을 확인할 수 있습니다. 영구 디스크의 저장공간과 기타 Compute Engine 기능에 대한 정보도 검토할 수 있습니다.
사용량 보고서는 API 요청에 대한 정보 같은 결제 또는 활동 정보는 제공하지 않습니다. 결제 정보는 결제 내보내기 기능에서 확인하세요. 활동 로그에 대한 자세한 내용은 활동 로그를 참조하세요.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
일일 사용량 보고서
이 보고서는 매일 제공되며 전날의 사용량 데이터를 담고 있습니다. 각각의 보고서는 마지막 기간의 데이터를 담고 있는 별도의 파일입니다. 이 보고서의 데이터는 변경이 불가능합니다. 즉, 부정확한 내용이 있더라도 Compute Engine이 로그 파일을 업데이트하거나 다시 작성하지 않습니다. 그 대신, 버킷에 제공되는 다음 신규 보고서에서 해당 데이터가 수정됩니다.
일일 사용량 보고서의 이름은 다음과 같은 형식으로 지정됩니다.
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMMDD>.csv
월간 롤업 보고서
단일 월간 롤업 보고서는 매일 제공되며 해당 프로젝트의 전일 누계(해당일 제외) 월간 사용량 데이터를 담고 있습니다. 월간 사용량 보고서는 해당일까지의 월간 리소스 사용량을 반영하는 새 데이터로 매일 덮어 써집니다. 프로젝트마다 월간 사용량 데이터 파일이 월별로 하나씩 존재합니다.
월간 롤업 보고서의 이름은 다음과 같은 형식으로 지정됩니다.
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMM>.csv
일일 보고서 파일과 월간 보고서 파일은 날짜 형식의 차이를 제외하면 아주 비슷해 보입니다. 즉, 월간 롤업 보고서는 연도와 월을 사용하여 표시되고(
YYYYMM
) 일일 사용량 보고서는 연도, 월, 일을 사용하여 표시됩니다(YYYYMMDD
).- 사용량 로그를 저장하려면 미리 버킷을 생성해야 합니다.
보고서를 전달받을 Cloud Storage 버킷
사용자가 소유자로 있는 모든 Cloud Storage 버킷(다른 프로젝트의 버킷 포함)을 선택할 수 있습니다. 보고서를 내보내려면 버킷이 존재해야 하고 사용자가 버킷에 소유자로 액세스할 수 있어야 합니다. Cloud Storage는 사용량에 따라 요금이 청구되므로, Cloud Storage 가격 책정을 검토하여 서비스 요금이 청구되는 방법에 대한 정보를 확인해야 합니다.
Cloud Storage 버킷에 대한 읽기 액세스 권한이 있는 모든 사용자는 버킷에 있는 사용량 보고서를 볼 수 있습니다. 버킷에 대한 쓰기 액세스 권한이 있는 모든 사용자는 버킷에 파일을 만들고 기존 파일을 보고 수정할 수 있습니다. 자세한 내용은 액세스 제어 섹션을 참조하세요.
파일의 보고서 프리픽스
사용량 보고서에 사용할 보고서 프리픽스를 지정할 수 있습니다. 이 프리픽스는 사용량 보고서의 파일 이름에 포함됩니다. 예를 들어 보고서 프리픽스로 'my-cool-project-report'를 지정하면
my-cool-project-report_1234567890_20131230.csv
와 유사한 형식의 파일 이름이 생성됩니다. 보고서 프리픽스를 지정하지 않으면 기본 프리픽스usage_gce
가 사용됩니다.Compute Engine 설정 페이지로 이동합니다.
사용량 내보내기 사용 설정 체크박스를 선택합니다.
버킷 이름을 요청하는 필드를 작성합니다. 원하는 경우 보고서 프리픽스를 제공합니다. 보고서 프리픽스를 비워두면 기본 프리픽스인
usage_gce
가 사용됩니다. 버킷에 전달되는 모든 사용량 보고서의 이름은 이 프리픽스로 지정됩니다.저장을 클릭합니다.
[BUCKET_NAME]
은 사용량 보고서를 수신할 기존 버킷의 이름입니다.gs://<bucket-name>
또는https://storage.googleapis.com/<bucket-name>
형식이어야 합니다. 이 명령어를 실행하는 사용자는 버킷의 소유자여야 합니다.[PREFIX]
는 사용량 보고서 이름의 프리픽스입니다(선택사항). 지정되지 않은 경우 기본 프리픽스는usage_gce
입니다.- 가상 머신
- 영구 디스크
- 이미지
- 스냅샷
- 고정 IP 주소
- 부하 분산기
- 예약
- 측정항목 유형: 문자열
- 설명: 사용 날짜
- 예: 2019-08-15
- 측정항목 유형: 문자열
-
설명: 측정 대상 리소스 유형의 ID.
예를 들어us-west2
머신 유형의n2-standard
를 나타내는VmimageN2StandardCore_Uswest2
입니다. -
예:
com.google.cloud/services/compute‑engine/VmimageN2StandardCore_Uswest2
-
예:
com.google.cloud/services/compute‑engine/VmimageN2StandardRam_Uswest2
- 측정항목 유형: 정수
- 설명: 지정한 날짜의 사용량
- 예: 86400
- 측정항목 유형: 문자열
- 설명: 회, 초, 시간 등의 단위 유형
- 예: 초
- 측정항목 유형: 문자열
- 설명: 지정한 리소스의 URI
- 예:
https://compute.googleapis.com/compute/v1/projects/<project‑id>/zones/<zone>/instances/<instance>
- 측정항목 유형: 정수
- 설명: 특정 리소스를 식별하는 숫자 ID
- 예: 16557630484925648021
- 측정항목 유형: 문자열
-
설명: 리소스의 위치. 영역 또는 리전 이름이나
GLOBAL
(전역 리소스의 경우). - 예:
us-central1-a
Compute Engine 설정 페이지로 이동합니다.
사용량 내보내기 사용 설정 체크박스를 선택 해제하여 사용량 내보내기를 중지합니다.
- 결제 내보내기 기능을 사용 설정하여 결제 로그 보기
- 활동 로그를 사용하여 프로젝트의 활동 추적하기
- Cloud Storage 버킷 자세히 알아보기
- Compute Engine 가격 책정 자세히 알아보기
- 가격 계산기를 사용하여 예상 가격 확인하기
Python
이 페이지의 Python 샘플을 로컬 개발 환경에서 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
개요
사용량 보고서를 사용 설정하면 Compute Engine에서 사용자가 지정한 Cloud Storage 버킷에 다음과 같은 두 가지 보고서를 전달합니다.
모든 사용량 보고서는 쉼표로 구분된 값(CSV) 형식으로 제공되고, 사용량 보고서 파일 앞에는
<report_prefix>
가 붙습니다.<report_prefix>
는 사용자가 선택하는 맞춤설정이 가능한 값입니다. 보고서 프리픽스를 지정하지 않으면 기본적으로usage_gce
프리픽스가 사용됩니다. 모든 시간은 태평양 표준시(PST)를 기준으로 제공됩니다.기본 요건
Compute Engine 사용량 내보내기를 사용하기 전에 먼저 다음 작업을 수행합니다.
사용량 내보내기 설정
사용량 내보내기 기능을 처음 사용 설정하면 다음 날, 그 전날의 사용량을 자세히 보여주는 첫 번째 보고서가 발송됩니다. 그 다음부터 24시간 간격으로 보고서가 수신됩니다.
사용량 내보내기 기능을 설정하려면
gcloud compute
도구에서 이 기능을 사용 설정합니다. 이 기능을 사용 설정할 때 다음 두 가지 속성을 정의해야 합니다.이 두 가지 속성을 결정했으면 다음과 같은 방법으로 사용량 내보내기 기능을 사용 설정할 수 있습니다.
Console
gcloud
gcloud compute
에서gcloud compute project-info set-usage-bucket
명령어를 사용하여 이 기능을 사용 설정합니다.gcloud compute project-info set-usage-bucket --bucket [BUCKET_NAME] [--prefix [PREFIX]]
각 항목의 의미는 다음과 같습니다.
Python
사용량 내보내기를 사용 설정하려면
Projects
컬렉션에서set_usage_export_bucket()
메서드를 사용합니다. 다음 예시에서는 Python용 Cloud 클라이언트 라이브러리를 사용합니다.자세한 내용은
projects.setUsageExportBucket
의 API 참조 문서를 확인하세요.사용량 내보내기 보고서 다운로드
버킷에서 사용량 보고서를 수신하기 시작하면 Cloud Storage에서 다른 객체를 다운로드하는 것처럼 보고서를 다운로드합니다. 자세한 내용은 객체 다운로드를 참조하세요.
지원되는 측정항목
일일 사용량 보고서는 다음 리소스에 대한 사용량 정보를 제공합니다.
각 리소스의 사용량은 다음과 같은 측정항목을 사용하여 기술됩니다.
측정항목 이름 측정항목 속성 보고서 작성일 측정 ID 수량 단위 리소스 URI 리소스 ID 위치 다음은 이 보고서의 예시 항목입니다.
보고서 작성일 측정 ID 수량 단위 리소스 URI 리소스 ID 위치 02/13/2019 com.google.cloud/services/compute-engine/VmimageE2Standard_2
86400 초 https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/my-instance
16557630484 us-central1-a 액세스 제어
Cloud Storage 버킷에 사용량 내보내기 기능을 사용 설정하면 Compute Engine이 사용량 보고서를 제공하기 위해 쓰기 액세스 권한이 있는 버킷에 자동으로 자신을 추가합니다. Compute Engine이 버킷에 액세스할 수 있고 사용량 내보내기 기능이 사용 설정되어 있다면 Compute Engine은 계속해서 지정된 Cloud Storage 버킷에 사용량 보고서를 내보냅니다.
버킷 IAM 정책에 다음 ID가 추가되어 있다면 Compute Engine이 버킷에 액세스할 수 있는 것입니다.
cloud-cluster-analytics-export@google.com
프로젝트의 소유자인 모든 사용자는 Cloud Storage 버킷에 대한 전체 액세스 권한이 있습니다. 작성자나 리더와 같은 기타 사용자의 버킷에 대한 액세스 권한은 저마다 다릅니다. 버킷의 IAM에 대해 알아보려면 Cloud Storage IAM을 참조하세요.
사용량 내보내기 기능을 사용 중지할 경우, Compute Engine은 버킷에 대한 자신의 쓰기 액세스 권한을 자동으로 삭제합니다. cloud-cluster-analytics-export@google.com 계정에서 권한을 수정한 다음 사용량 내보내기 기능을 사용 중지할 경우, Compute Engine은 사용량 내보내기 기능을 사용 중지하되 프로젝트 액세스 목록에서 계정을 삭제하지는 않습니다. 필요하다면 계정을 직접 삭제할 수 있습니다.
사용량 보고서가 사용 설정되어 있는지 확인
프로젝트에 대한 정보를 가져와서 프로젝트의 사용량 내보내기 설정을 확인할 수 있습니다.
gcloud compute project-info describe
usageExportLocation
필드를 찾습니다.+-------------------------+----------------------------------------------------+ | name | myproject | | description | | | creation-time | 2019-10-18T16:31:52.308-07:00 | | usage | | | snapshots | 1.0/1000.0 | | networks | 2.0/2.0 | | firewalls | 3.0/10.0 | |... | | | usageExportLocation | | | bucketName | https://storage.googleapis.com/usage-export-sample | | reportNamePrefix | | +-------------------------+----------------------------------------------------+
사용량 보고서 사용 중지
사용량 보고서를 사용 중지하면 Compute Engine에서 Cloud Storage 버킷에 대한 자신의 쓰기 액세스 권한을 자동으로 삭제하고 새 보고서의 전송을 중단합니다.
콘솔
gcloud
gcloud compute
에서--no-bucket
플래그로gcloud compute project-info set-usage-bucket
명령어를 실행하여 사용량 내보내기 기능을 사용 중지합니다.gcloud compute project-info set-usage-bucket --no-bucket
Python
사용량 내보내기를 중지하려면
usage_export_location_resource
가None
으로 설정된Projects
컬렉션에서set_usage_export_bucket()
메서드를 사용합니다. 다음 예시에서는 Python용 Cloud 클라이언트 라이브러리를 사용합니다.다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-05(UTC)
-