使用状況と予測データを表示する

このドキュメントでは、キャパシティプランナーでリソースの使用状況と予測データを表示する方法について説明します。キャパシティプランナーの詳細については、キャパシティプランナーの概要をご覧ください。

次のコンピューティングリソースの使用状況と予測データを表示できます。
- インスタンスにアタッチされた vCPU、メモリ、ローカル SSD ディスクを含む Compute Engine インスタンス。
- インスタンスにアタッチされているかどうかに関係なく、ストレージ、IOPS、スループットの Google Cloud Hyperdisk ボリュームと Persistent Disk ボリューム。
- インスタンスにアタッチされているかどうかに関係なく、GPU。
- TPU。
また、現在のオンデマンド予約や、過去と現在の将来の予約リクエストなど、コンピューティングリソースの予約を表示することもできます。

コンピューティングリソースに関するデータを使用して、リソースの使用量を最適化し、プロジェクト、フォルダ、組織における将来の容量と割り当てのニーズを計画できます。
下り（外向き）帯域幅の Cloud Storage バケットの使用状況データを表示できます。このデータを使用して、帯域幅の追加をリクエストするタイミングをモニタリングできます。下り（外向き）帯域幅と帯域幅の追加をリクエストする方法については、 Cloud Storage での帯域幅の使用量の概要をご覧ください。下り（外向き）帯域幅の増加のリクエストが拒否された場合は、テクニカルアカウントマネジメントにお問い合わせください。

また、過去 1 年間の任意の日付の予測を表示することもできます。このデータを使用すると、リソースの予測が時間の経過とともにどのように変化したかを比較したり、さまざまなパーセンタイルでのリソースの使用状況の傾向を分析したり、過去の予測の精度を実際の過去の使用量と比較して評価したりできます。詳細については、過去の予測スナップショットを表示するをご覧ください。

制限事項

キャパシティプランナーで使用状況と予測データを表示する前に、次の点を考慮してください。

次のリソースでは予測データはサポートされていません。
- Spot VM（インスタンスと、GPU や TPU などのアタッチされたリソースを含む）
- Cloud Storage バケット
Spot VM とプリエンプティブル割り当ての使用状況データは、インスタンス、GPU、TPU でのみ使用できます。このデータを表示するには、次のいずれかの方法を使用します。
- コンソールで、次のいずれかのグラフを開きます。 Google Cloud
  - マシンファミリーごとの使用量と予測
  - GPU タイプごとの使用量と予測
  - TPU タイプごとの使用量と予測
  [ その他のオプション] をクリックし、[Spot の使用量] 切り替えボタンをオンにします。
- Capacity Planner API で、isSpot フィールドを true に設定します。
[リソースタイプごとの使用量と予測] グラフには次の制限があります。
- コンピューティングインスタンス、GPU、TPU の割り当てを表示できるのは、次のすべてを行う場合のみです。
  - プロジェクトで使用状況と予測データを表示する。
  - グラフを単一のマシンファミリー、GPU タイプ、または TPU タイプでフィルタする。
  - インスタンスと GPU の場合は、グラフをリージョンでフィルタします。TPU の場合、Google Kubernetes Engine の割り当てを表示するには、グラフをリージョンでフィルタします。Cloud TPU の割り当てを表示するには、ゾーンでフィルタします。
- 予約と将来の予約リクエストを表示できるのは、次の両方を行う場合のみです。
  - インスタンスまたは GPU の使用状況と予測データを表示する。
  - 予約を作成したプロジェクト、このプロジェクトを含むフォルダ、または組織で使用状況と予測データを表示する。
[マシンタイプごとの使用量と予測] テーブルを表示できるのは、インスタンスまたは GPU の使用状況と予測データを表示する場合のみです。
過去の予測スナップショットは、Compute Engine インスタンス、Hyperdisk ボリュームと Persistent Disk ボリューム、GPU、TPU でのみ使用できます。リソースのこのデータを表示するには、次のいずれかの方法を使用します。
- コンソールで、過去の予測スナップショットを表示するに記載されている手順を行います。 Google Cloud
- Capacity Planner API で、startDate、endDate、generationDate フィールドを使用して、必要な日時を ISO 8601 形式（YYYY-MM-DDTHH:MM:SS.sssZ）で指定します。これらのフィールドを使用すると、特定の過去の予測データをフィルタして表示できます。
  
  たとえば、startDate を 2025-06-03T00:00:00.000Z、endDate を 2025-10-02T00:00:00.000Z、generationDate を 2025-05-04T00:00:00.000Z として指定します。API は、2025 年 5 月 4 日に計算された予測スナップショットを取得し、2025 年 6 月 3 日から 2025 年 10 月 2 日までの過去の予測データを表示します。
  
  注: generationDate フィールドの日付を指定しない場合、 API は最後に生成された予測スナップショットを取得します。

詳細については、データの可用性と更新をご覧ください。

始める前に

キャパシティプランナーを以前に使用したことがない場合は、キャパシティプランナーの概要を確認し、プロジェクトとユーザーの前提条件を完了してキャパシティプランナーを有効にします。

必要なロール

リソースの使用状況と予測データを表示するために必要な権限を取得するには、プロジェクト、フォルダ、組織に対するCapacity Planner Usage Viewer （roles/capacityplanner.viewer）の IAM ロールを付与するように管理者へ依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールにはリソースの使用状況と予測データを表示するために必要な権限が設定されています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

リソースの使用状況と予測データを表示するには、次の権限が必要です。

予測データを表示するには: capacityplanner.forecasts.list プロジェクト、フォルダ、または組織に対する
過去の使用状況データを表示するには: capacityplanner.usageHistories.list プロジェクト、フォルダ、または組織に対する
過去の使用状況データを集計するには: capacityplanner.usageHistories.summarize プロジェクト、フォルダ、または組織に対する

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

データの可用性と更新

キャパシティプランナーで使用状況と予測データを表示する場合は、次の点を考慮してください。

キャパシティプランナーのデータは次のとおりです。
- 過去の使用状況データ : 過去 2 年間の使用状況データを使用できます。ただし、次の例外があります。
  - 予約の場合、2024 年 8 月 1 日より前の過去の使用状況データは使用できません。
  - 将来の予約リクエストの場合、使用状況データは予約期間の開始から 1 年間のみ使用できます。
  - Cloud Storage バケットの場合、2025 年 12 月 1 日より前の過去の使用状況データは使用できません。
- 予測データ: 最大 6 か月先の予測データを表示できます。
- 過去の予測スナップショットデータ: 過去 1 年間の過去の予測スナップショットデータを表示できます。
キャパシティプランナーのデータは次のように更新されます。
- キャパシティプランナーは、5 分ごとに過去の使用状況データをサンプリングし、使用後 24 時間以内にデータを表示します。
- [**概要**] Google Cloud コンソールページの [**分析情報**] セクションのデータは、少なくとも 48 時間ごとに 1 回更新されます。

リソースの予測と使用状況を表示する

プロジェクト、フォルダ、組織内のコンピューティングインスタンス、Persistent Disk ボリューム、GPU、TPU の使用状況と予測データを表示するには、次の方法を使用します。

コンソール Google Cloud を使用してリソースの予測と使用状況を表示する（推奨）
Capacity Planner API を使用してリソースの予測と使用状況を表示する

コンソールを使用してリソースの予測と使用状況を表示する Google Cloud

コンソールを使用してリソースの予測と使用状況を表示する手順は次のとおりです。Google Cloud

コンソールで、キャパシティプランナーを開きます。 Google Cloud

Capacity Planner に移動

[概要] ページが表示されます。
省略可: データを表示するスコープ（プロジェクト、フォルダ、組織）を変更するには、次の操作を行います。
1. コンソールのツールバーで、リソースセレクタをクリックします。 Google Cloud
2. [リソースを選択] ダイアログが表示されたら、プロジェクト、フォルダ、または組織を選択します。
[概要] ページでは、リソースのリージョン別分布や対応が必要な可能性のあるアクション項目など、リソースの使用状況の概要を次の方法で確認できます。
- The [Insights] section summarizes overall resource usage and highlights data that indicates potential action items.
  
  たとえば、[アクティブなリージョン] 指標には、プロジェクト、フォルダ、組織にリソースがあるリージョンの合計数が表示されます。この指標は、ワークロードの全体的なサイズと増加を把握するのに役立ちます。また、[最も成長しているリソース] 指標には、過去 30 日間の使用量の変化率が、その前の 30 日間と比較して最も大きいリソースが表示されます。
- [リージョンとリソースの分布] グラフには、過去 30 日間の各リソースタイプのリソース数がリージョンごとに表示されます。グラフをフィルタするには、[リソース] リストと次に [リソースタイプ] リストを使用して、リソース指標を選択します。
  
  なお、このグラフには Spot VM の使用量は含まれません。また、過去 30 日間に選択したリソース指標のリージョンが 5 つ以上ある場合は、指標の上位 5 つのリージョンのみが表示され、残りのリージョンは [その他] として指定されます。
特定のリソースタイプについて、特定リージョンとゾーンの使用状況と予測データを表示するには、[使用量と予測] セクションのページを次のように確認します。
1. キャパシティプランナーのナビゲーションメニューの [使用量と予測] セクションで、データを表示するリソースのタイプに基づいてページを選択します。
  - インスタンスのデータを表示するには、[仮想マシン] ページを開きます。
  - Hyperdisk ボリュームと Persistent Disk ボリュームのデータを表示するには、[ディスク] ページを開きます。
  - GPU のデータを表示するには、[GPU] ページを開きます。
  - TPU のデータを表示するには、[TPU] ページを開きます。
  - Cloud Storage バケットのデータを表示するには、[Cloud Storage] ページを開きます。
2. [使用量と予測] ページの表とグラフについては、次のセクションをご覧ください。
  - リソースタイプごとの使用量と予測
  - マシンタイプごとの使用量と予測（[仮想マシン] ページと [GPU] ページのみ）

リソースタイプごとの使用量と予測

When you view the [Usage & forecast] pages, the graph that you see depends on which resource you're viewing. 次のグラフでは、グラフ内のデータを表示または非表示にすることもできます。

マシンファミリーごとの使用量と予測 または マシンタイプごとの使用量と予測 : [仮想マシン] ページでは、このグラフに、インスタンスのローカル SSD ディスク、メモリ、または vCPU の使用量、予測、予約（存在する場合）、割り当てが、次の条件でフィルタされて表示されます。
- マシンファミリーまたはマシンタイプ
- 場所
デフォルトでは、グラフには過去 30 日間の使用量が最も多いマシンファミリーとリージョンが表示されます。予約と Spot VM のデータを表示または非表示にすることもできます。
ディスクタイプごとの使用量と予測: [ディスク] ページでは、このグラフに Hyperdisk ボリュームと Persistent Disk ボリュームの履歴、予測、割り当てが、次の条件でフィルタされて表示されます。
- ディスクタイプ
- 機密モード（Hyperdisk Balanced で機密モードを使用する場合にのみ表示されます）
- 場所
- リソースタイプ（次のいずれか）:
  - ストレージ
  - IOPS
  - スループット
GPU タイプごとの使用量と予測: [GPU] ページでは、このグラフに GPU の使用量、予測、予約（存在する場合）、割り当てが次の条件でフィルタされて表示されます。
- GPU タイプまたはマシンタイプ
- 場所
予約と Spot VM のデータを表示または非表示にすることもできます。
TPU タイプごとの使用量と予測: [TPU] ページでは、このグラフに TPU の使用量、予測、割り当てが、TPU タイプとロケーションでフィルタされて表示されます。
バケットのトラフィック属性別の外向き帯域幅の使用量: [Cloud Storage] ページでは、このグラフに、次の条件でフィルタされた下り（外向き）帯域幅が表示されます。
- トラフィックパス（次のいずれか）:
  - Google
  - インターネット
- バケットのロケーションタイプ（次のいずれか）:
  - シングルリージョン
  - デュアルリージョン
  - マルチリージョン
- バケットのロケーション
- サービス提供場所

プロジェクト内のリソースの使用状況と予測データを表示していて、プロジェクトに十分な使用状況データがある場合は、グラフに [割り当て調整を有効にする] ボタンが表示されます。このボタンをクリックすると、プロジェクトで割り当て調整を有効にできます。

グラフ内のデータを表示または非表示にする

グラフのオプションを表示または非表示にするには、 [More options] をクリックし、それぞれの切り替えボタンをオンまたはオフにします。キャパシティプランナーは、計算された将来の予約データを 60 分ごとに更新します。

たとえば、Spot VM の使用量とプリエンプティブル割り当てを表示する方法については、 Spot VM の制限事項をご覧ください。

過去の予測スナップショットを表示する

過去の予測スナップショットを表示して、リソースの過去の予測を実際の使用量または現在の予測と比較できます。このデータを使用すると、予測の精度を評価し、使用状況の傾向が時間の経過とともにどのように変化したかを把握できます。

リソースの過去の予測スナップショットを表示する手順は次のとおりです。

コンソールで、 [Capacity Planner Overview] ページに移動します。 Google Cloud

Capacity Planner に移動
キャパシティプランナーのナビゲーションメニューの [使用量と予測] セクションで、次のいずれかのリソースタイプを選択します。
- Virtual Machines
- ディスク
- GPU
- TPU
リソースの [使用量と予測] グラフで、[予測オプション] をクリックし、次の操作を行います。
1. [グラフに過去の予測を表示する] 切り替えボタンをオンにします。
2. 現在の日付から 1 年前までの過去の日付を選択します。
3. 予測スナップショットデータを表示するパーセンタイルまたはパーセンタイルの組み合わせを選択します。
4. [適用] をクリックします。

グラフには、選択した日付から次の 6 か月間までに生成された過去の予測データが、実際の過去の使用量に重ねて表示されます。たとえば、日付として June 3, 2025 を選択すると、グラフには 2025 年 6 月 3 日から 2025 年 12 月 2 日までの過去の予測データが表示されます。

マシンタイプごとの使用量と予測

[Virtual Machines] ページまたは [GPU] ページを表示すると、 [マシンタイプごとの使用量と予測] テーブルに、次のリソースの過去と予測の使用量が表示されます。

コンピューティングインスタンスの使用状況データを表示すると、選択したマシンファミリーとロケーションの予測使用量がテーブルに表示されます。この表には Spot VM の使用量は含まれません。
GPU の使用状況データを表示すると、選択した GPU タイプとロケーションの予測使用量がテーブルに表示されます。

キャパシティプランナーは次のようにデータを表示します。

50、75、99 パーセンタイル。
個々のマシンタイプとゾーンごとに分類。
インスタンス、CPU コア（該当する場合）、GPU（該当する場合）でフィルタ。

テーブルには次の列が含まれます。

マシンタイプ: 選択したマシンファミリーの各マシンタイプの詳細（vCPU、メモリ、アタッチされたローカル SSD ディスク（存在する場合）、 GPU タイプ（存在する場合）など）。
ゾーン: 各マシンタイプが存在するゾーン。
**NTH パーセンタイルの RESOURCE 使用量の最大値**: 選択したパーセンタイルを使用して計算された、各マシンタイプを使用したインスタンスの最大数。
NTH 予測 MONTH の最大値: 選択したパーセンタイルを使用して計算された、特定の月に各マシンタイプを使用すると予測されるインスタンスの最大数。テーブルには、最大 6 か月先の個別の列が含まれています。
予約: 既存の予約と、過去と現在の将来の予約リクエスト。テーブルには、選択したパーセンタイルを使用して計算された、マシンタイプとゾーン別に分類されたデータが表示されます。特定のマシンタイプとゾーンの予約または将来の予約リクエストがある場合は、詳細ボタン をクリックします。次の内容が表示されます。
- [CPU プラットフォーム別の使用量] セクションに、そのマシンタイプとゾーンの最小 CPU プラットフォームの割合の内訳が表示されます。
- [期間の VM 予測] セクションに、選択したパーセンタイルの使用量について、選択した期間のインスタンスの予測数が表示されます。
- [CPU プラットフォーム別の予約] セクションに、CPU プラットフォーム別にグループ化された既存の予約と将来の予約リクエストが表示されます。

マシンタイプ別の割合の内訳を除き、キャパシティプランナーはすべての値を最も近い整数に切り上げます。

デフォルトでは、テーブルには、過去 30 日間に最もアクティブなロケーションで最も使用されたマシンタイプの 99 パーセンタイルの使用量と 50% の予測間隔が表示されます。選択した予測期間中に将来の予約リクエストを表示するには、[予測範囲内の将来の予約] をクリックします。

Capacity Planner API を使用してリソースの予測と使用状況を表示する

Capacity Planner API を使用してリソースの予測と使用状況を表示するには、次の表の 1 つ以上の REST メソッドにリクエストを送信します。これらのメソッドは、データをプログラムでクエリする場合に便利です。使用可能なデータの詳細については、コンソールを使用してリソースの予測と使用状況を表示する Google Cloud もご覧ください。

REST メソッド
過去の使用状況の時系列データをクエリする	プロジェクトレベルのクエリ: v1beta `projects.locations.usageHistories.query` メソッドフォルダレベルのクエリ: v1beta `folders.locations.usageHistories.query` メソッド組織レベルのクエリ: v1beta `organizations.locations.usageHistories.query` メソッド
予測の時系列データをクエリする	プロジェクトレベルのクエリ: v1beta `projects.locations.forecasts.query` メソッドフォルダレベルのクエリ: v1beta `folders.locations.forecasts.query` メソッド組織レベルのクエリ: v1beta `organizations.locations.forecasts.query` メソッド
予約の時系列データをクエリする	プロジェクトレベルのクエリ: v1beta `projects.locations.reservations.query` メソッドフォルダレベルのクエリ: v1beta `folders.locations.reservations.query` メソッド組織レベルのクエリ: v1beta `organizations.locations.reservations.query` メソッド