| π Awarded |
|---|
| This project was the winner of the Google Open Source Peer Bonus in 2022 π₯³ |
Calculate estimated monthly costs of Google Cloud Platform products and resources. Optimized for DevOps, architects and engineers to quickly see a cost breakdown and compare different options upfront:
- Mapping of resource usage is done in easy to learn YAML usage files
- Price information is read from a local file (
pricing.yml) - Calculation is done via
gcostsCLI program - Calculated costs are saved in CSV file optimized for non-technical audience
Full control and no disclosure of any information and costs to third parties.
Everything is calculated on your local computer.
No need to have a connection to the Internet.
Everything tested and matched against the actual invoice in large Google Cloud migration projects.
Over 320 automated tests ensure gcosts reliability.
gcosts works on various OS and terminals, including Windows CMD, macOS iTerm2, and in CI systems like GitHub Actions.
| 1οΈβ£ Create YAML file | 2οΈβ£ Run gcosts CLI program |
3οΈβ£ Open CSV file |
|---|---|---|
 |
 |
 |
The cost of a resource is calculated by multiplying its price by its usage.
| π‘ Google Cloud Free Program |
|---|
Free tiers and free trial (90-day, $300), which are usually not a significant part of cloud costs, are ignored. For example: 1x free non-preemptible e2-micro VM instance per month, free NAT for 32 VMs, 30 GB-months standard persistent disk, 1 GB network egress and everything else are not taken into account. |
Resources that gcosts supports, and Google charges for:
π₯οΈ Compute Engine Instances
- All machine types are supported
-
A2andG2accelerator optimized machines -
C2,C2DandH3compute optimized machine series -
M1,M2andM3memory optimized machine series -
C3,E2,N1,N2,N2D,T2DandT2Ageneral purpose machine series
-
- Sustained use discounts (SUD) are applied to monthly costs
- Spot provisioning model (Spot VM) is supported
- Flexible committed use discounts (Flexible CUD) are not supported
- 1 year and 3 year committed use discounts (CUD) are supported
- Paid "premium" operating system licenses (paid images) are supported
- SUSE Linux Enterprise Server
- SLES for SAP (1y and 3y committed use discounts (CUD) are also supported)
- Red Hat Enterprise Linux (1y and 3y committed use discounts (CUD) are also supported)
- RHEL for SAP (1y and 3y committed use discounts (CUD) are also supported)
- Windows Server
- Custom machine types are supported (have to be created manually)
- Sole-tenant VMs are not supported
πΎ Compute Engine Disks
- All persistent disk (PD) types are supported
- Zonal persistent disk
- Regional persistent disk
- Local SSD
- Provisioned IOPS
πͺ£ Cloud Storage
- All storage classes and location types are supported
- region
- dual-region
- multi-region
- Retrieval fees are calulated
π Hybrid Connectivity
- VPN tunnel
- Interconnect is currently not calculated
π Cloud NAT
- NAT gateway
- Data processing (both egress and ingress)
π¦ Cloud Monitoring (Operations Suite)
- Monitoring data
πΈοΈ Network
- Premium Tier internet egress
- Worldwide destinations (excluding China & Australia, but including Hong Kong)
- China destinations (excluding Hong Kong)
- Australia destinations
ποΈ TODO
The following services are not currently supported, but are on the TODO list:
- BigQuery
- Cloud SQL
Please suggest other resources worth covering by upvoting existing issue or opening new issue.
This guide is available as an interactive Cloud Shell tutorial. To get started, please click the following button:
Download the ready complied and executable gcosts CLI program for your operating system and architecture.
Linux
Download:
- x86_64 Intel or AMD 64-Bit CPU
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-linux-x86_64" \ -o "gcosts" && \ chmod +x "gcosts"
- arm64 Arm-based 64-Bit CPU (i.e. in Raspberry Pi)
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-linux-arm64" \ -o "gcosts" && \ chmod +x "gcosts"
To determine your OS version, run getconf LONG_BIT or uname -m at the command line.
Execute gcosts:
./gcosts helpmacOS
Download:
- x86_64 Intel 64-bit
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-macos-x86_64" \ -o "gcosts" && \ chmod +x "gcosts"
- arm64 Apple silicon 64-bit
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-macos-arm64" \ -o "gcosts" && \ chmod +x "gcosts"
To determine your OS version, run uname -m at the command line.
Execute gcosts:
./gcosts helpWindows
Download:
- x86_64 Intel or AMD 64-Bit CPU
Invoke-WebRequest -Uri "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-windows-x86_64.exe" -OutFile "gcosts.exe"
- arm64 Arm-based 64-Bit CPU
Invoke-WebRequest -Uri "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-windows-arm64.exe" -OutFile "gcosts.exe"
To determine your OS version, run echo %PROCESSOR_ARCHITECTURE% at the command line.
Execute gcosts.exe:
.\gcosts.exe helpDownload the latest and tested price information file pricing.yml.
The price information is automatically regenerated on a weekly basis.
Download the updated pricing file regularly.
Linux
Download pricing.yml:
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml" \
-o "pricing.yml"macOS
Download pricing.yml:
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml" \
-o "pricing.yml"Windows
Download pricing.yml:
Invoke-WebRequest -Uri "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml" -OutFile "pricing.yml"Prepare a separate directory (i.e. usage) just for your YAML usage files and create your first YAML usage file (resources.yml) in this directory:
region: europe-west4
project: my-first-project
instances:
- name: app-server
type: e2-standard-8
os: rhel
commitment: 3
disks:
- name: disk-boot
type: ssd
data: 75Warning If the price list (
pricing.yml) is in the same directory, errors occur because the YAML file is also parsed.
Execute the CLI program:
Linux
Execute gcosts:
./gcosts calc --pricing YML-PRICING-PATHmacOS
Execute gcosts:
./gcosts calc --pricing YML-PRICING-PATHWindows
Execute gcosts.exe:
.\gcosts.exe calc --pricing YML-PRICING-PATHWithout extra specification of the directory all YAML files (*.yml) of the current directory are imported and the costs of the resources are calculated.
You can specify the directory:
gcosts calc --dir DIRECTORY-PATH --pricing YML-PRICING-PATHThe calculated costs are exported to one CSV (comma-separated values) file.
Without specifying the file location, the file is named costs.csv and is saved in the current directory.
You can specify the CSV export file:
gcosts calc --csv CSV-EXPORT-FILE-PATH --pricing YML-PRICING-PATHYou can import the CSV file with MS Excel, Apple Numbers, LibreOffice or Google Sheets.
Continue to familiarize yourself with the options. The following documentations are prepared for this purpose:
π€ Tip
Add gcosts to your Shell aliases with absolute pathnames.
You can then execute gcosts anywhere.
Alias (~/.aliases):
alias gcosts='/your-pathname/gcosts --pricing /your-pathname/pricing.yml'Have a patch that will benefit this project? Awesome! Follow these steps to have it accepted.
- Please read how to contribute.
- Fork this Git repository and make your changes.
- Create a Pull Request.
- Incorporate review feedback to your changes.
- Accepted!
All files in this repository are under the Apache License, Version 2.0 unless noted otherwise.
Portions of this repository are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.