https://github.com/iamfrench/terraform-google-billing-billboard
Terraform Module for Google Cloud billing billboard.
https://github.com/iamfrench/terraform-google-billing-billboard
gcp google-billing google-cloud looker-studio terraform terraform-module
Last synced: 3 months ago
JSON representation
Terraform Module for Google Cloud billing billboard.
- Host: GitHub
- URL: https://github.com/iamfrench/terraform-google-billing-billboard
- Owner: IAmFrench
- License: apache-2.0
- Created: 2023-03-25T00:16:01.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-04-28T16:04:10.000Z (about 2 years ago)
- Last Synced: 2024-12-26T03:22:35.388Z (5 months ago)
- Topics: gcp, google-billing, google-cloud, looker-studio, terraform, terraform-module
- Language: HCL
- Homepage: https://registry.terraform.io/modules/IAmFrench/billing-billboard/google/latest
- Size: 11.7 KB
- Stars: 2
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# Google Cloud billing billboard Terraform Module
This module for GCP will create dataset used by the Google billboard and provide link to create the associated Looker Studio dashboard.
> source: https://cloud.google.com/billing/docs/how-to/visualize-data
This work is based on [GoogleCloudPlatform/professional-services/examples/billboard](https://github.com/GoogleCloudPlatform/professional-services/tree/main/examples/billboard).
For a guided deployment using Cloud Shell (not Terraform), you can use the walkthrough tutorial available in the previous link.
This Terraform module use the `http` Terraform provider to retrieve BigQuery billing table. You will need to provide an application token to authenticate to Google Cloud REST API. You can acheve this using the following command: `gcloud auth application-default print-access-token`.
This Terraform Module will produce a Looker Studio Link, you will need to open it and click on the "Edit and Share" top right button to save this dashboard.
## Sources
- [Visualize your costs with Looker Studio](https://cloud.google.com/billing/docs/how-to/visualize-data)
- [DEMO - Billing usage and cost insights dashboard](https://lookerstudio.google.com/c/reporting/64387229-05e0-4951-aa3f-e7349bbafc07/page/p_l3qef1s8rc)
- [GoogleCloudPlatform/professional-services/examples/billboard](https://github.com/GoogleCloudPlatform/professional-services/blob/main/examples/billboard/billboard.py)
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.1.0 |
| [google](#requirement\_google) | >= 4.58.0 |
| [http](#requirement\_http) | >= 3.2.1 |
## Providers
| Name | Version |
|------|---------|
| [google](#provider\_google) | >= 4.58.0 |
| [http](#provider\_http) | >= 3.2.1 |
## Modules
No modules.
## Resources
| Name | Type |
|------|------|
| [google_bigquery_dataset.billboard](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/bigquery_dataset) | resource |
| [google_bigquery_table.billboard_detailed_table](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/bigquery_table) | resource |
| [google_bigquery_table.billboard_standard_table](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/bigquery_table) | resource |
| [http_http.billing_detailed_tables](https://registry.terraform.io/providers/hashicorp/http/latest/docs/data-sources/http) | data source |
| [http_http.billing_standard_tables](https://registry.terraform.io/providers/hashicorp/http/latest/docs/data-sources/http) | data source |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [billboard\_dataset\_id](#input\_billboard\_dataset\_id) | Dataset ID used for the Looker Studio billboard v3.0. | `string` | `"billboard"` | no |
| [billboard\_dataset\_location](#input\_billboard\_dataset\_location) | Location used for BigQuery billboard datasets. | `string` | n/a | yes |
| [billboard\_detailed\_table\_id](#input\_billboard\_detailed\_table\_id) | Table ID used for the Looker Studio billboard v3.0 with detailed billing data. | `string` | `"detailed_billboard"` | no |
| [billboard\_project\_id](#input\_billboard\_project\_id) | Project ID used for hosting BigQuery billing datasets. | `string` | n/a | yes |
| [billboard\_standard\_table\_id](#input\_billboard\_standard\_table\_id) | Table ID used for the Looker Studio billboard v3.0 with standard billing data. | `string` | `"standard_billboard"` | no |
| [billing\_project\_id](#input\_billing\_project\_id) | Project ID used for hosting BigQuery billing datasets. | `string` | n/a | yes |
| [detailed\_billing\_export\_dataset\_id](#input\_detailed\_billing\_export\_dataset\_id) | Dataset ID used for the detailed billing export. | `string` | `"detailed_billing_export"` | no |
| [google\_application\_credentials](#input\_google\_application\_credentials) | Google application crendentials used to fetch BigQuery tables REST API. use the folowing command: gcloud auth application-default print-access-token. | `string` | n/a | yes |
| [looker\_studio\_billboard\_name](#input\_looker\_studio\_billboard\_name) | Name of the Looker Studio billboard dashboard. | `string` | `"Google Cloud Billboard v3.0"` | no |
| [standard\_billing\_export\_dataset\_id](#input\_standard\_billing\_export\_dataset\_id) | Dataset ID used for the standard billing export. | `string` | `"standard_billing_export"` | no |
## Outputs
| Name | Description |
|------|-------------|
| [billboard\_dataset\_id](#output\_billboard\_dataset\_id) | BigQuery billboard dataset id. |
| [billboard\_standard\_template\_link](#output\_billboard\_standard\_template\_link) | Pre-configured template link to deploy the Looker Studio billboard v3.0 dashboard. |