Stay organized with collections
Save and categorize content based on your preferences.
This document explains how to export a CSV file containing the usage and
forecast data of your resources in your project, folder, or organization. To
export this data to a different Google Cloud product, see instead
Export data to a Cloud Storage bucket or BigQuery table.
You can export usage and forecast data as a CSV file for the following
resources:
Compute Engine instances
Persistent Disk volumes
GPUs
TPUs
This action helps you view and analyze the usage data of your resources on your
local workstation.
To get the permissions that
you need to export usage and forecast data of your resources,
ask your administrator to grant you the
following IAM roles on your project, folder, or organization:
These predefined roles contain
the permissions required to export usage and forecast data of your resources. To see the exact permissions that are
required, expand the Required permissions section:
Required permissions
The following permissions are required to export usage and forecast data of your resources:
To view forecasted usage data:
capacityplanner.forecasts.list
on the project, folder, or organization
To view historical usage data:
capacityplanner.usageHistories.list
on the project, folder, or organization
To summarize the usage of your resources:
capacityplanner.usageHistories.summarize
on the project, folder, or organization
Based on the usage and forecast data of the resources within your project,
folder, or organization that you want to export, use one of the following
methods:
To export usage and forecast data of your compute instances,
Persistent Disk volumes, GPUs, or TPUs for the past two years and for up
to six months in the future,
export data by resource type.
You can export usage and forecast data about your compute instances,
Persistent Disk volumes, GPUs, or TPUs from the
Usage and forecast by resource type graph.
You can export usage data from within two years in the past, and forecast data
for up to six months in the future. To export data, first select the tab for the
resource that you want to export, and then filter the data by the following:
Resource type
Region or zone
Usage percentile
To export usage and forecast data about your instances, Persistent Disk
volumes, GPUs, or TPUs, do the following:
In the Google Cloud console, go to the Capacity Planner page.
Optional: To change project, folder, or organization, in the project picker
at the top of the page, select a project, folder, or organization.
To export a specific resource, select one of the following options:
Compute instances
In the navigation menu, click the Virtual machine tab.
For Machine family, choose the machine family to export. To
export all, select All.
For Machine type, choose the machine type to export. To export
all machine types within a machine family, select Select.
For Location, select the region or zone of the instances to
export.
For Usage percentile, select a usage percentile.
In the Usage and forecast by machine family or
Usage and forecast by machine types graph, click
file_downloadExport.
A CSV file downloads to your workstation.
Persistent Disks
In the navigation menu, click the Disk tab.
For Disk type, choose the type of Persistent Disk to export.
For Location, select a region or zone.
For Usage percentile, select a usage percentile.
In the Usage and forecast by disk type graph, click
file_downloadExport.
A CSV file downloads to your workstation.
GPUs
In the navigation menu, click the GPU tab.
For GPU type, choose the type of GPU to export. To export all,
select All.
For Machine type, choose the machine type that have your chosen
GPU attached to export. To export all machine types that have a
specific GPU type attached, select Select.
For Usage percentile, select a usage percentile.
In the Usage and forecast by GPU type or
Usage and forecast by machine types graph, click
file_downloadExport.
A CSV file downloads to your workstation.
TPUs
In the navigation menu, click the TPU tab.
For TPU type, choose the type of TPU to export. To export
all, select All.
For Usage percentile, select a usage percentile.
In the Usage and forecast by TPU type or
Usage and forecast by machine types graph, click
file_downloadExport.
A CSV file downloads to your workstation.
Export data filtered by machine family or GPU type
You can export usage and forecast data of your instances from the
Usage and forecast by machine types table.
To export data, first select the resource that you want to export, and
filter the data by the following:
Compute instances, CPU cores, or GPUs
Region or zone
Usage percentile
To export usage and forecast data of your instances filtered by machine family
or GPU type, do the following:
In the Google Cloud console, go to the Capacity Planner page:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eThis document guides you through exporting Compute Engine resource usage and forecast data, including VMs, Persistent Disk volumes, and GPUs, as a CSV file for local analysis.\u003c/p\u003e\n"],["\u003cp\u003eYou can export data for all Compute Engine resource types across all locations or filter data by specific machine families or GPU types within a chosen location.\u003c/p\u003e\n"],["\u003cp\u003eBefore accessing the Capacity Planner to export data, ensure your organization is eligible, and you have the necessary IAM roles, specifically the Capacity Planner Viewer role.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves navigating to the Capacity Planner in the Google Cloud console, selecting the resource type (VM, Disk, or GPU), and using the export options available in the Usage and Forecast graph or table.\u003c/p\u003e\n"],["\u003cp\u003eThe product mentioned is under private preview, which means it is subject to the Pre-GA Offerings Terms, it is provided "as is", and might have limited support.\u003c/p\u003e\n"]]],[],null,["| **Preview**\n|\n|\n| This product is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document explains how to export a CSV file containing the usage and\nforecast data of your resources in your project, folder, or organization. To\nexport this data to a different Google Cloud product, see instead\n[Export data to a Cloud Storage bucket or BigQuery table](/capacity-planner/docs/export-data-api).\n\nYou can export usage and forecast data as a CSV file for the following\nresources:\n\n- Compute Engine instances\n\n- Persistent Disk volumes\n\n- GPUs\n\n- TPUs\n\nThis action helps you view and analyze the usage data of your resources on your\nlocal workstation.\n\nBefore you begin\n\nIf you haven't used Capacity Planner before, review\n[Capacity Planner overview](/capacity-planner/docs/overview)\nand enable Capacity Planner by completing the\n[prerequisites for projects and users](/capacity-planner/docs/overview#prerequisites).\n\nRequired roles\n\n\nTo get the permissions that\nyou need to export usage and forecast data of your resources,\n\nask your administrator to grant you the\nfollowing IAM roles on your project, folder, or organization:\n\n- To access and view Capacity Planner: [Capacity Planner Viewer](/iam/docs/roles-permissions/capacityplanner#capacityplanner.viewer) (`roles/capacityplanner.viewer`)\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThese predefined roles contain\n\nthe permissions required to export usage and forecast data of your resources. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\nRequired permissions\n\nThe following permissions are required to export usage and forecast data of your resources:\n\n- To view forecasted usage data: ` capacityplanner.forecasts.list` on the project, folder, or organization\n- To view historical usage data: ` capacityplanner.usageHistories.list` on the project, folder, or organization\n- To summarize the usage of your resources: ` capacityplanner.usageHistories.summarize` on the project, folder, or organization\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nExport usage and forecast data\n\nBased on the usage and forecast data of the resources within your project,\nfolder, or organization that you want to export, use one of the following\nmethods:\n\n- To export usage and forecast data of your compute instances,\n Persistent Disk volumes, GPUs, or TPUs for the past two years and for up\n to six months in the future,\n [export data by resource type](#export-data-resources).\n\n- To export usage and forecast data of your machine types for a specific usage\n period,\n [export data filtered by machine family or GPU type](#export-data-machine-family).\n\nExport data by resource type\n\nYou can export usage and forecast data about your compute instances,\nPersistent Disk volumes, GPUs, or TPUs from the\n[**Usage and forecast by resource type** graph](/capacity-planner/docs/view-data#usage-forecast).\nYou can export usage data from within two years in the past, and forecast data\nfor up to six months in the future. To export data, first select the tab for the\nresource that you want to export, and then filter the data by the following:\n\n- Resource type\n\n- Region or zone\n\n- Usage percentile\n\nTo export usage and forecast data about your instances, Persistent Disk\nvolumes, GPUs, or TPUs, do the following:\n\n1. In the Google Cloud console, go to the **Capacity Planner** page.\n\n [Go to Capacity Planner](https://console.cloud.google.com/capacity/usage)\n2. Optional: To change project, folder, or organization, in the project picker\n at the top of the page, select a project, folder, or organization.\n\n3. To export a specific resource, select one of the following options:\n\n Compute instances\n 1. In the navigation menu, click the **Virtual machine** tab.\n\n 2. For **Machine family** , choose the machine family to export. To\n export all, select **All**.\n\n 3. For **Machine type** , choose the machine type to export. To export\n all machine types within a machine family, select **Select**.\n\n 4. For **Location**, select the region or zone of the instances to\n export.\n\n 5. For **Usage percentile**, select a usage percentile.\n\n 6. In the **Usage and forecast by machine family** or\n **Usage and forecast by machine types** graph, click\n file_download **Export**.\n\n A CSV file downloads to your workstation.\n\n Persistent Disks\n 1. In the navigation menu, click the **Disk** tab.\n\n 2. For **Disk type**, choose the type of Persistent Disk to export.\n\n 3. For **Location**, select a region or zone.\n\n 4. For **Usage percentile**, select a usage percentile.\n\n 5. In the **Usage and forecast by disk type** graph, click\n file_download **Export**.\n\n A CSV file downloads to your workstation.\n\n GPUs\n 1. In the navigation menu, click the **GPU** tab.\n\n 2. For **GPU type** , choose the type of GPU to export. To export all,\n select **All**.\n\n 3. For **Machine type** , choose the machine type that have your chosen\n GPU attached to export. To export all machine types that have a\n specific GPU type attached, select **Select**.\n\n 4. For **Usage percentile**, select a usage percentile.\n\n 5. In the **Usage and forecast by GPU type** or\n **Usage and forecast by machine types** graph, click\n file_download **Export**.\n\n A CSV file downloads to your workstation.\n\n TPUs\n 1. In the navigation menu, click the **TPU** tab.\n\n 2. For **TPU type** , choose the type of TPU to export. To export\n all, select **All**.\n\n 3. For **Usage percentile**, select a usage percentile.\n\n 4. In the **Usage and forecast by TPU type** or\n **Usage and forecast by machine types** graph, click\n file_download **Export**.\n\n A CSV file downloads to your workstation.\n\nExport data filtered by machine family or GPU type\n\nYou can export usage and forecast data of your instances from the\n[**Usage and forecast by machine types** table](/capacity-planner/docs/view-data#usage-machine-type).\nTo export data, first select the resource that you want to export, and\nfilter the data by the following:\n\n- Compute instances, CPU cores, or GPUs\n\n- Region or zone\n\n- Usage percentile\n\nTo export usage and forecast data of your instances filtered by machine family\nor GPU type, do the following:\n\n1. In the Google Cloud console, go to the **Capacity Planner** page:\n\n [Go to Capacity Planner](https://console.cloud.google.com/capacity/usage)\n2. Optional: To change project, folder, or organization, in the project picker\n at the top of the page, select a project, folder, or organization.\n\n3. To filter the usage data of your instances by machine family or GPU type,\n select one of the following options:\n\n Compute instances\n 1. In the navigation menu, click the **Virtual machine** tab.\n\n 2. For **Machine family**, select one of the following options:\n\n - To select a single machine family only, select one of the\n available machine families.\n\n - To select all machine families, select **All**.\n\n 3. For **Location**, select a region or zone.\n\n 4. For **Usage percentile**, select a usage percentile.\n\n 5. In the **Usage and forecast by machine types** table, for\n **View data for**, select one of the following options:\n\n - To view usage and forecast by instances, select **VM**.\n\n - To view usage and forecast by CPU cores, select **Cores**.\n\n 6. For **History start date**, select the start date of the usage\n period.\n\n 7. For **History end date**, select the end date of the usage period.\n\n 8. Click file_download **Export**.\n\n A CSV file downloads to your workstation.\n\n GPUs\n 1. In the navigation menu, click the **GPU** tab.\n\n 2. For **GPU type**, select one of the following options:\n\n - To select a single GPU type only, select one of the available\n GPU types.\n\n - To select all GPU types, select **All**.\n\n 3. For **Location**, select a region or zone.\n\n 4. For **Usage percentile**, select a usage percentile.\n\n 5. In the **Usage and forecast by machine types** table, for\n **View data for**, select one of the following options:\n\n - To view usage and forecast by instances, select **VM**.\n\n - To view usage and forecast by GPUs, select **GPU**.\n\n 6. For **History start date**, select the start date of the usage\n period.\n\n 7. For **History end date**, select the end date of the usage period.\n\n 8. Click file_download **Export**.\n\n A CSV file downloads to your workstation.\n\nWhat's next\n\n- [Audit logging information for Capacity Planner](/capacity-planner/docs/audit-logging)"]]
