本文档介绍了如何在容量规划工具中查看资源的使用情况和预测数据。如需详细了解容量规划工具， 请参阅 容量规划工具概览。
您可以查看以下计算资源的使用情况和预测数据：
Compute Engine 实例，包括 vCPU、内存和挂接到实例的本地 SSD 磁盘。
Google Cloud Hyperdisk 和 Persistent Disk 卷的存储、IOPS 和吞吐量，无论它们是否挂接到实例。
GPU，无论它们是否挂接到实例。
TPU。
您还可以查看计算资源的预留，包括当前的按需预留以及过去和当前的未来预留请求。
您可以使用有关计算资源的数据来帮助优化资源用量，并规划项目、文件夹或组织未来的容量和配额需求。
您可以查看 Cloud Storage 存储分区的出站流量带宽用量数据。您可以使用此数据来监控何时请求更多带宽。如需详细了解出站流量带宽以及如何 请求更多带宽，请参阅 Cloud Storage 中的带宽用量概览。如果增加出站流量带宽的请求被拒绝，请 与客户技术支持联系。
此外，您还可以查看过去一年中任何一天的预测。借助这些数据，您可以比较资源的预测随时间的变化情况，分析各种百分位数的资源用量趋势，并根据实际历史用量评估过去的预测准确性。如需了解详情，请参阅 查看历史预测快照 部分。
限制
在容量规划工具中查看使用情况和预测数据之前，请注意以下事项：
以下资源不支持预测数据：
- Spot 虚拟机（包括 实例和任何挂接的资源，例如 GPU 和 TPU）
- Cloud Storage 存储分区
Spot 虚拟机和抢占式配额的使用情况数据仅适用于实例、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针对项目、文件夹或组织的
数据可用性和更新
在容量规划工具中查看使用情况和预测数据时，请注意以下事项：
容量规划工具数据可用性如下：
历史用量数据：历史用量数据最长可查看 过去两年，但以下情况除外：
对于预留，2024 年 8 月 1 日之前的历史用量数据不可用。
对于未来预留请求，用量数据仅在预留期开始后一年内可用。
对于 Cloud Storage 存储分区，2025 年 12 月 1 日之前的历史用量数据不可用。
预测数据：您可以查看未来六个月的 预测数据。
历史预测快照数据：您可以查看过去一年的历史预测 快照数据。
容量规划工具数据更新方式如下：
容量规划工具每五分钟对历史用量数据进行一次采样，并在用量发生后 24 小时内显示数据。
在概览 Google Cloud 控制台页面上， 数据分析部分中的数据至少每 48 小时更新一次。
查看资源的预测和用量
您可以使用以下方法查看项目、文件夹或组织中的计算实例、Persistent Disk 卷、GPU 和 TPU 的用量和预测数据：
- 使用 Google Cloud 控制台查看资源的预测和用量（推荐）
- 使用 Capacity Planner API 查看资源的预测和用量
使用 Google Cloud 控制台查看资源的预测和用量
如需使用 Google Cloud 控制台查看资源的预测和用量，请完成以下步骤。
在 Google Cloud 控制台中，打开容量规划工具。
系统会显示概览 页面。
可选：如需更改要查看数据的范围（项目、文件夹或组织），请执行以下操作：
- 在 Google Cloud 控制台工具栏上，点击资源选择器。
- 在随即显示的选择资源 对话框中，选择项目、文件夹或组织。
在概览 页面上，您可以查看汇总资源总体用量的数据，包括潜在的操作项和资源的区域分布，如下所示：
数据分析 部分汇总了资源总体用量 ，并突出显示了表明潜在操作项的数据。
例如，活跃区域 指标显示了项目、文件夹或组织中包含资源的区域总数；此指标可能有助于您了解工作负载的总体规模和增长情况。此外，增长最快的资源指标 显示了在过去 30 天内用量正 百分比变化 最大的资源（与之前的 30 天相比）。
区域和资源分布 图表显示了过去 30 天内每个区域中每种资源的数量。如需过滤图表，请使用资源 列表，然后使用资源类型 列表选择资源指标。
值得注意的是，此图表不包含 Spot 虚拟机用量。 此外，如果过去 30 天内所选 资源指标的区域超过 5 个，则仅列出该指标的前 5 个区域，其余区域指定为 其他。
如需查看特定区域和可用区中特定类型资源的使用情况和预测数据，请查看用量和预测 部分中的页面，如下所示：
在容量规划工具导航菜单的用量和预测 部分中，根据要查看数据的资源类型选择页面：
如需查看实例的数据，请打开虚拟机 页面。
如需查看 Hyperdisk 和 Persistent Disk 卷的数据，请打开磁盘 页面。
如需查看 GPU 的数据，请打开 GPU 页面。
如需查看 TPU 的数据，请打开 TPU 页面。
如需查看 Cloud Storage 存储分区的数据，请打开 Cloud Storage 页面。
如需了解用量和预测 页面上的表格和图表，请参阅以下部分：
- 用量和预测（按资源类型）
- 用量和预测（按机器类型）（仅限虚拟机和GPU页面）
用量和预测（按资源类型）
查看用量和预测页面时， 您看到的图表取决于您查看的资源。对于以下所有 图表，您还可以 显示或隐藏图表中的数据。
用量和预测（按机器家族） 或 用量和预测（按机器类型）：在虚拟机 页面上， 此图表显示了实例的 本地 SSD 磁盘、内存或 vCPU 的用量、预测、预留（如果有）和配额，并按以下条件过滤：
- 机器家族或机器类型
- 位置
默认情况下，该图表显示了过去 30 天内用量最高的机器家族和区域。您还可以显示或隐藏预留和 Spot 虚拟机的数据。
用量和预测（按磁盘类型）：在磁盘页面上，此图表显示了 Hyperdisk 和 Persistent Disk 卷的历史记录、预测和配额，并按以下条件过滤：
- 磁盘类型
- 机密模式（仅当您对 Hyperdisk Balanced 使用机密模式时才会显示）
- 位置
- 资源类型，为以下类型之一：
- 存储
- IOPS
- 吞吐量
用量和预测（按 GPU 类型）：在 GPU 页面上，此图表显示了 GPU 的用量、预测、预留（如果有）和配额， 并按以下条件过滤：
- GPU 类型或机器类型
- 位置
您还可以显示或隐藏预留和 Spot 虚拟机的数据。
用量和预测（按 TPU 类型）：在 TPU 页面上，此图表显示了 TPU 的用量、预测和配额，并按 TPU 类型和 位置过滤。
出站带宽用量（按存储桶流量属性）：在 Cloud Storage页面上，此图表显示了出站带宽，并按 以下条件过滤：
- 流量路径，为以下路径之一：
- 互联网
- 存储分区位置类型，为以下类型之一：
- 单区域
- 双区域
- 多区域
- 存储分区位置
- 提供位置
- 流量路径，为以下路径之一：
如果您在项目中查看资源的使用情况和预测数据，并且项目具有足够的使用情况数据，则图表中会显示启用配额调整工具 按钮。您可以点击该按钮以 在项目中启用配额调整工具。
在图表中显示或隐藏数据
如需在图表中显示或隐藏选项，请点击 更多选项，然后点击 相应的切换开关，将其切换到“开启”或“关闭”位置。容量规划工具每 60 分钟更新一次计算出的未来预留数据。
例如，如需了解如何查看 Spot 虚拟机用量和 抢占式配额，请参阅 Spot 虚拟机的限制。
查看历史预测快照
您可以查看历史预测快照，将资源的过去预测与其实际用量或当前预测进行比较。借助这些数据，您可以评估预测准确性，并了解用量趋势随时间的变化情况。
如需查看资源的历史预测快照，请执行以下操作：
在 Google Cloud 控制台中，前往 容量规划工具概览 页面。
在容量规划工具导航菜单的用量和预测 部分中，选择以下资源类型之一：
- 虚拟机
- 磁盘
- GPU
- TPU
在资源的用量和预测 图表中，点击预测选项 ，然后按照以下步骤操作：
点击在图表上显示历史预测 开关，将其切换到“开启”位置。
选择过去的一个日期，最长可选择当前日期之前的一年。
选择您要查看预测快照数据的百分位，或百分位的组合。
点击应用 。
该图表显示了从所选日期到未来六个月生成的过去预测数据，并与实际历史用量叠加显示。例如，如果您选择的日期为 June 3, 2025，则该图表会显示从 2025 年 6 月 3 日到 2025 年 12 月 2 日的历史预测数据。
用量和预测（按机器类型）
当您查看虚拟机页面或GPU页面时， 用量和预测（按机器类型）表会显示以下资源的历史用量和 预测用量：
当您查看计算实例的用量数据时，该表会显示所选机器家族和位置的预测用量。此表不包含 Spot 虚拟机用量。
当您查看 GPU 的用量数据时，该表会显示所选 GPU 类型和位置的预测用量。
容量规划工具会按以下方式呈现数据：
按第 50、75 或 99 百分位。
按各个机器类型和可用区细分。
按实例、CPU 核心（如果适用）或 GPU（如果适用）过滤。
该表包含以下列：
机器类型：所选机器家族中每种机器类型的详细信息，包括 vCPU、内存、挂接的本地 SSD 磁盘（如果有）和 GPU 类型（如果有）。
可用区：每种机器类型所在的可用区。
第 NTH 百分位 RESOURCE 用量上限：使用每种机器类型的实例数量上限，使用您选择的百分位计算得出。
第 NTH 百分位预测 MONTH上限：预计在特定月份使用每种机器类型的实例数量上限，使用您选择的百分位计算得出。该表包含单独的列，最多可显示未来六个月的数据。
预留：现有预留以及过去和现有的 未来预留请求。该表显示了按机器类型和可用区细分的数据，并使用您选择的百分位计算得出。如果特定机器类型和可用区有预留或未来预留请求，请点击详细信息按钮 。系统会显示一个窗格，其中显示以下内容：
在按 CPU 平台划分的用量 部分中，该机器类型和可用区的最低 CPU 平台的百分比细分。
在日期范围内的虚拟机预测 部分中，所选日期范围内所选百分位用量的预测实例数量。
在按 CPU 平台划分的预留 部分中，按 CPU 平台分组的现有预留和未来预留请求。
除了按机器类型划分的百分比细分之外，容量规划工具会将所有值四舍五入到最接近的整数。
默认情况下，该表显示了过去 30 天内最活跃位置中最常用机器类型的第 99 百分位用量和 50% 的预测区间。如需查看所选预测日期内的未来预留请求，请点击预测范围内的未来预留 。
使用 Capacity Planner API 查看资源的预测和用量
如需使用 Capacity Planner API 查看资源的预测和用量，请向下表中一个或多个 REST 方法发出请求。 当您想要以编程方式查询数据时，这些方法非常有用。 如需详细了解可用数据，另请参阅 使用 Google Cloud 控制台查看资源的预测和用量。
| REST 方法 | |
|---|---|
| 查询历史用量时序 | |
| 查询预测时序 | |
| 查询预留时序 | |