Compute Engine では、使用状況データのエクスポート機能を使用して、Compute Engine の使用状況データに関する詳細なレポートを Cloud Storage バケットにエクスポートできます。使用状況レポートには、リソースの使用期間に関する情報が表示されます。たとえば、n2-standard-4
マシンタイプを実行しているプロジェクト内のインスタンスの数や、各インスタンスが実行されている期間を確認できます。永続ディスクの保存容量や、Compute Engine のその他の機能に関する情報も確認できます。
使用状況レポートには、お支払い情報やアクティビティ情報(API リクエストに関する情報など)は表示されません。お支払い情報については、課金データのエクスポート機能をご覧ください。アクティビティ ログについては、アクティビティ ログをご覧ください。
始める前に
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- デフォルトのリージョンとゾーンを設定します。
Python
このページの Python サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- 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 から指定の Cloud Storage バケットに 2 種類のレポートが配信されます。
日次使用状況レポート
このレポートは毎日配信されるもので、前日からの使用状況データが示されています。各レポートは、前回の期間からのデータを示す個別のファイルです。このレポートのデータは変更できません。つまり、誤りがあった場合でも、Compute Engine によってログファイルが更新されたり書き換えられたりすることはありません。代わりに、データは、バケットに次回配信される新しいレポートで修正されます。
日次使用状況レポートの名前形式は次のとおりです。
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMMDD>.csv
月次ロールアップ レポート
月次ロールアップ レポートは毎日 1 件配信されるもので、その日の前日までのそのプロジェクトに関する月次使用状況データが示されています。月次使用状況レポートは毎日新しいデータで上書きされ、その日までのリソースの月次使用状況が反映されます。月間使用状況データファイルは、プロジェクトごとに、1 か月あたり 1 つだけです。
月次ロールアップ レポートの名前形式は次のとおりです。
<bucket>/<report_prefix>_<numeric_project_id>_<YYYYMM>.csv
日次レポート ファイルと月次レポート ファイルはよく似ていますが、日付形式が異なります。月次ロールアップ レポートでは年と月(
YYYYMM
)が使用されますが、日次使用状況レポートでは年、月、日(YYYYMMDD
)が使用されます。
使用状況レポートはすべてカンマ区切り値(CSV)形式で配信され、レポートのファイル名には接頭辞 <report_prefix>
が付けられます。<report_prefix>
はユーザーが選択するカスタマイズ可能な値です。レポート接頭辞を指定しない場合は、デフォルトで接頭辞 usage_gce
が使用されます。時間はすべて太平洋時間(PST)で表記されます。
前提条件
Compute Engine の使用状況データのエクスポートを使用する前に、次のことを行います。
- 使用状況ログを保存するバケットを作成しておく必要があります。
使用状況データのエクスポートを設定する
使用状況データのエクスポート機能を初めて有効にしたときは、その翌日に、前日の使用状況の詳細を示す最初のレポートが送信されます。その後、レポートは 24 時間間隔で届きます。
使用状況データのエクスポート機能を設定するには、gcloud compute
ツールでこの機能を有効にします。この機能を有効にするときは、2 つのプロパティを定義する必要があります。
レポートの配信先にする Cloud Storage バケット
所有している任意の Cloud Storage バケット(異なるプロジェクトのバケットを含む)を選択できます。このバケットはレポートのエクスポートを開始する前に存在している必要があり、このバケットに対するオーナー アクセス権も必要です。Cloud Storage は使用量に応じて課金されるため、サービスの料金については Cloud Storage の料金をご覧ください。
Cloud Storage バケットへの読み取りアクセス権を持つすべてのユーザーは、バケット内の使用状況レポートを表示できます。バケットへの書き込みアクセス権を持つユーザーは、バケット内の既存のファイルを作成、表示、変更できます。詳しくは、アクセス制御のセクションをご覧ください。
ファイルのレポート接頭辞
使用状況レポートに使用するレポート接頭辞を指定できます。使用状況レポートには、この接頭辞を含むファイル名が付けられます。たとえば、レポート接頭辞として「my-cool-project-report」を指定すると、
my-cool-project-report_1234567890_20131230.csv
のような形式のファイル名になります。レポート接頭辞を指定しない場合は、デフォルトの接頭辞usage_gce
が使用されます。
これら 2 つのプロパティを決定したら、使用状況データのエクスポート機能を次の方法で有効にすることができます。
Console
Compute Engine の設定ページに移動します。
[使用量データのエクスポートを有効にする] チェックボックスをオンにします。
[バケット名] フィールドに入力します。必要に応じて、[レポート接頭辞] を入力します。レポート接頭辞を指定しなかった場合は、デフォルトの接頭辞
usage_gce
が使用されます。バケットに配信されるすべての使用状況レポートには、この接頭辞が付きます。[保存] をクリックします。
gcloud
この機能を有効にするには、gcloud compute
で gcloud compute project-info set-usage-bucket
コマンドを使用します。
gcloud compute project-info set-usage-bucket --bucket [BUCKET_NAME] [--prefix [PREFIX]]
ここで
[BUCKET_NAME]
は、使用状況レポートを受信する既存のバケットの名前です。形式をgs://<bucket-name>
またはhttps://storage.googleapis.com/<bucket-name>
にする必要があります。このコマンドを実行するユーザーは、バケットのオーナーである必要があります。[PREFIX]
は、使用状況レポート名の接頭辞です(省略可)。指定しない場合、デフォルトの接頭辞はusage_gce
です。
Python
使用状況のエクスポートを有効にするには、Projects
コレクション set_usage_export_bucket()
のメソッドを使用します。次の例では、Python 用 Cloud クライアント ライブラリを使用します。
詳細については、projects.setUsageExportBucket
の API リファレンス ドキュメントをご覧ください。
使用状況エクスポート レポートのダウンロード
Cloud Storage から他のオブジェクトをダウンロードする場合と同様に、バケットの使用状況レポートの受信を開始したらレポートをダウンロードします。詳細については、オブジェクトをダウンロードするをご覧ください。
サポートされている指標
日次使用状況レポートには、次のリソースに関する使用状況情報が示されます。
- 仮想マシン
- 永続ディスク
- イメージ
- スナップショット
- 静的 IP アドレス
- ロードバランサ
- 予約
各リソースについては以下の指標を使用して記載されます。
指標名 | 指標プロパティ |
---|---|
レポート生成日 |
|
MeasurementId |
|
数量 |
|
単位 |
|
リソースの URI |
|
ResourceId |
|
ロケーション |
|
レポート内のエントリの例は次のようになります。
レポート生成日 | MeasurementId | 数量 | 単位 | リソースの 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 バケットへの書き込みアクセス権が自動的に削除され、新しいレポートの送信が中止されます。
コンソール
Compute Engine の設定ページに移動します。
使用状況データのエクスポートを無効にするには、[使用量データのエクスポートを有効にする] チェックボックスをオフにします。
gcloud
gcloud compute
で、gcloud compute project-info set-usage-bucket
コマンドと --no-bucket
フラグを使用して、使用状況データのエクスポート機能を無効にします。
gcloud compute project-info set-usage-bucket --no-bucket
Python
使用状況のエクスポートを無効にするには、usage_export_location_resource
を None
に設定して Projects
コレクションの set_usage_export_bucket()
メソッドを使用します。次の例では、Python 用 Cloud クライアント ライブラリを使用します。
次のステップ
- 課金データのエクスポート機能をオンにして、課金ログを表示する。
- アクティビティ ログを使用して、プロジェクトのアクティビティをトラックする。
- Cloud Storage バケットの詳細を確認する。
- Compute Engine の料金を確認する。
- 料金計算ツールを使用して費用を見積もる。