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

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

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

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

制限事項

Capacity Planner で使用状況と予測データを表示する前に、次の点に注意してください。

次のリソースでは予測データはサポートされていません。
- Spot VM（インスタンスと、GPU や TPU などのアタッチされたリソースを含む）
- Cloud Storage バケット
Spot VM とプリエンプティブルの割り当ての使用状況データは、インスタンス、GPU、TPU でのみ使用できます。このデータを表示するには、次のいずれかの方法を使用します。
- Google Cloud コンソールで、次のいずれかのグラフを開きます。
  - マシンファミリーごとの使用量と予測
  - GPU タイプ別の使用量と予測
  - TPU タイプごとの使用量と予測
  [その他のオプション] をクリックし、[スポット使用量] 切り替えボタンをクリックしてオンにします。
- Capacity Planner API で、isSpot フィールドを true に設定します。
リソースタイプ別の使用量と予測グラフには、次の制限事項があります。
- コンピューティングインスタンス、GPU、TPU の割り当てを表示できるのは、次のすべてを実行した場合のみです。
  - プロジェクトで使用状況と予測データを表示します。
  - グラフは、単一のマシンファミリー、GPU タイプ、または TPU タイプでフィルタします。
  - インスタンスと GPU の場合、グラフはリージョンでフィルタします。TPU の場合、Google Kubernetes Engine の割り当てを表示するには、グラフをリージョンでフィルタします。Cloud TPU の割り当てを表示するには、ゾーンでフィルタします。
- 予約と将来の予約リクエストを表示できるのは、次の両方を行う場合のみです。
  - インスタンスまたは GPU の使用量と予測データを表示します。
  - 使用状況と予測データは、予約を作成したプロジェクト、このプロジェクトを含むフォルダ、または組織で表示します。
[マシンタイプごとの使用量と予測] テーブルは、インスタンスまたは GPU の使用量と予測データを表示する場合にのみ表示されます。

詳細については、このドキュメントのデータの可用性と更新もご覧ください。

始める前に

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

必要なロール

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

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

必要な権限

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

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

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

データの可用性と更新

Capacity Planner で使用状況と予測データを表示する場合は、次の点に注意してください。

容量プランナーのデータは次のように利用できます。
- 過去の使用状況データ: 過去 2 年間の使用状況データを利用できます。ただし、次の例外があります。
  - 予約の場合、2024 年 8 月 1 日より前の過去の使用状況データは利用できません。
  - 将来の予約リクエストの場合、使用状況データは予約期間の開始から 1 年間のみ使用できます。
  - Cloud Storage バケットの場合、2025 年 12 月 1 日より前の過去の使用状況データは利用できません。
- 予測データ: 最大 6 か月先の予測データを表示できます。
キャパシティプランナーのデータは次のように更新されます。
- キャパシティプランナーは、過去の使用状況データを 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. 表示された [リソースを選択] ダイアログで、プロジェクト、フォルダ、または組織を選択します。
[概要] ページでは、リソース使用状況の概要データを確認できます。これには、対応が必要な可能性のあるアクション項目や、リソースのリージョン別分布も含まれます。
- [分析情報] セクションには、リソースの全体的な使用状況がまとめられ、潜在的なアクションアイテムを示すデータがハイライト表示されます。
  
  たとえば、アクティブなリージョン指標は、プロジェクト、フォルダ、組織にリソースがあるリージョンの合計数を示します。この指標は、ワークロードの全体的なサイズと増加を把握するのに役立ちます。また、最も成長率の高いリソース指標は、過去 30 日間の使用量の変化率が、その前の 30 日間と比較して最も大きいリソースを示します。
- [リージョンとリソースの分布] グラフには、過去 30 日間の各リソースタイプについて、各リージョンにあるリソースの数が表示されます。グラフをフィルタするには、[リソース] リストと [リソースタイプ] リストを使用して、リソース指標を選択します。
  
  なお、このグラフには Spot VM の使用量は含まれていません。また、選択したリソース指標のリージョンが過去 30 日間に 5 つ以上ある場合は、指標の上位 5 つのリージョンのみがリストされ、残りのリージョンは [その他] として指定されます。
特定のリージョンとゾーンの特定タイプのリソースの使用量と予測データを表示するには、使用量と予測セクションのページを次のように確認します。
1. キャパシティプランナーのナビゲーションメニューの [使用量と予測] セクションで、データを表示するリソースのタイプに基づいてページを選択します。
  - インスタンスのデータを表示するには、[仮想マシン] ページを開きます。
  - Hyperdisk ボリュームと Persistent Disk ボリュームのデータを表示するには、[ディスク] ページを開きます。
  - GPU のデータを表示するには、[GPU] ページを開きます。
  - TPU のデータを表示するには、[TPU] ページを開きます。
  - Cloud Storage バケットのデータを表示するには、[Cloud Storage] ページを開きます。
2. [使用量と予測] ページの表とグラフについては、次のセクションをご覧ください。
  - リソースタイプごとの使用量と予測
  - マシンタイプごとの使用量と予測（[仮想マシン] ページと [GPU] ページのみ）

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

[使用量と予測] ページを表示すると、表示されるグラフは、表示しているリソースによって異なります。次のグラフでは、グラフ内のデータの表示と非表示を切り替えることもできます。

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

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

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

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

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

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

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

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

Capacity Planner は次のようにデータを表示します。

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` メソッド