Capacity Planner overview

This document gives an overview of Capacity Planner.

You can use Capacity Planner to view the current and forecasted usage of the following resources in your Google Cloud project, folder, or organization:

  • Compute Engine instances

  • Persistent Disk volumes

  • GPUs

  • TPUs

Use cases

Capacity Planner helps you plan for future capacity and quota needs by letting you do the following:

  • View historical and forecasted usage of your compute instances, Persistent Disk volumes, GPUs, and TPUs.

  • View current on-demand reservations, as well as past and current future reservation requests, to plan for future growth or spikes in usage.

  • Request resources in advance to prepare for expected or unexpected growth.

  • Manage quota limits in your project by seeing how close you are to your limit. You can also set up automatic quota increase requests when your quota nears a limit to do the following:

    • Prevent outages when you reach a quota.

    • Reduce the need to submit manual quota increase requests.

How Capacity Planner works

The following sections outline how Capacity Planner calculates and displays usage data and statistical forecasts for the compute instances, Persistent Disk volumes, GPUs, and TPUs in your project, folder, or organization.

Usage data

You can view the usage data of the compute instances, Persistent Disk volumes, GPUs, or TPUs in your project, folder, or organization to see their consumption patterns. The usage data in Capacity Planner is a daily percentile usage of your resources. You can apply the following usage percentile to track the usage data of your resources:

  • P50. The P50 usage percentile is the 50th percentile usage data that separates the lower 50% of the usage data of your resources from the upper 50%.

  • P75. The P75 usage percentile is the 75th percentile usage data that separates the lower 75% of the usage data of your resources from the upper 25%.

  • P99. The P99 usage percentile is the 99th percentile usage data that separates the lower 99% of the usage data of your resources from the upper 1%.

Capacity Planner samples usage data as follows:

  • When you view the usage data in a project, Capacity Planner samples the usage data every five minutes and displays the data within 24 hours after usage.

  • When you view the usage data in a folder or organization, Capacity Planner samples the usage data of all projects in your folder or organization every five minutes, and aggregates them to a daily usage percentile value. Then, Capacity Planner displays the data within 24 hours after usage.

Capacity Planner retains historical usage data for up to two years. However, data related to future reservation requests is only accessible for one year after the start of its reservation period.

Forecasts

You can view the forecast of the compute instances, Persistent Disk volumes, GPUs, or TPUs in your project, folder, or organization to help you predict your future capacity needs. The forecast in Capacity Planner is a combination of the following:

  • A linear and superlinear model.

  • Yearly seasonality effects on usage, for projects, folders and organizations that have at least two years of usage data.

The forecast provides an estimate of future usage based on historical usage patterns for a specified period of time. You can apply the following prediction intervals to the forecast:

  • P25-P75. The P25-P75 interval is a prediction interval of 50%, which means that there is a 50% probability that actual future usage will fall within the lower bound and upper bound forecast.

  • P05-P95. The P05-P95 interval is a prediction interval of 90%, which means that there is a 90% probability that actual future usage will fall within the lower bound and upper bound forecast.

The statistical forecast is estimated for up to six months in the future.

Pricing

There is no additional cost for using Capacity Planner. You are only charged for any billable Google Cloud resources that you create or use with Capacity Planner.

For example, if you reserve capacity in Capacity Planner, then any Compute Engine resources in your project are subject to Compute Engine pricing. Additionally, if you export data to a Cloud Storage bucket or BigQuery table, then any Cloud Storage resources or BigQuery resources in your project are subject to Cloud Storage pricing and BigQuery pricing respectively.

Get support

To learn how to get help with Capacity Planner, see Get support.

Prerequisites

To start using Capacity Planner, complete the following prerequisites:

  1. If your project has not used Capacity Planner before, enable Capacity Planner for your project.
  2. Set up Capacity Planner for each new user.

Enable Capacity Planner for a project

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Capacity Planner API by using one of the following methods.

    Console

    Enable the Capacity Planner API.

    Enable the API

    gcloud

    Enable the Capacity Planner API.

    Enable the API

Set up Capacity Planner for a new user

To start using Capacity Planner as a user, do the following:

  1. To get the permissions that you need to use Capacity Planner, ask your administrator to grant you the required IAM roles on the project. Refer to the documentation for each task to see its required permissions.

    For example, if you want to start learning how to use Capacity Planner by viewing usage and forecast data, consider requesting the Capacity Planner Viewer (roles/capacityplanner.viewer) role on the project.

    For more information about granting roles, see Manage access.

  2. If you want to use the API for Capacity Planner, learn how to Authenticate to Capacity Planner.

What's next