Exporta tu huella de carbono
Puedes exportar tus datos de Huella de carbono a BigQuery para analizar los datos o crear paneles de control e informes personalizados.
La exportación de la huella de carbono registra las emisiones de gases de efecto invernadero estimadas asociadas al uso de los servicios cubiertos Google Cloud de la cuenta de facturación seleccionada.
Después de configurar una exportación, se te cobrará por los recursos de BigQuery que se usen para almacenar y consultar los datos exportados.
Antes de empezar
Para crear una exportación de huella de carbono, le recomendamos que tenga los siguientes roles de gestión de identidades y accesos:
- Propietario o Editor del Google Cloud proyecto al que quieras exportar.
- Lector de Huella de carbono o Lector de cuenta de facturación en la cuenta de facturación cuyos datos de carbono se exportarán.
En concreto, debes tener los siguientes permisos de gestión de identidades y accesos en el Google Cloud proyecto:
resourcemanager.projects.update
serviceusage.services.enable
bigquery.transfers.update
Y el siguiente permiso de gestión de identidades y accesos en la cuenta de facturación:
billing.accounts.getCarbonInformation
Si usas Controles de Servicio de VPC
Si tu organización usa Controles de Servicio de VPC, debes definir una regla de entrada para la API de BigQuery y la API de BigQuery Data Transfer Service.
En la regla de la política de entrada:
- En la sección "De", seleccione "Permitir todas las fuentes".
- Concede permiso a la identidad
els-da-carbon@gcp-carbon-footprint-exports.iam.gserviceaccount.com
.
Configurar una exportación de huella de carbono a BigQuery
Los datos de huella de carbono se exportan a través de BigQuery Data Transfer Service.
La transferencia de datos crea una tabla con particiones mensuales llamada carbon_footprint
en el conjunto de datos de BigQuery que elijas.
Las exportaciones de huella de carbono incluyen los datos de cada mes el día 15 del mes siguiente. Por ejemplo, los datos de emisiones de carbono de septiembre del 2022 se exportarán el 15 de octubre del 2022.
Una vez que se haya creado una configuración de transferencia de huella de carbono, se exportarán automáticamente los futuros informes de carbono el día 15 de cada mes. También podrás hacer un relleno para solicitar datos históricos desde enero del 2021.
Consola
Sigue estos pasos para iniciar la exportación:
- Ir a Huella de carbono
- En el menú Cuenta de facturación, selecciona la cuenta de facturación de Cloud que quieras exportar.
- Haz clic en Exportación de datos para abrir el panel lateral y configurar la exportación.
- Selecciona un proyecto para exportar los datos de tu huella de carbono y, a continuación, haz clic en Crear exportación.
- En la página BigQuery Data Transfer Service, haz lo siguiente:
- Asegúrate de que Fuente tenga el valor "Google Cloud Exportaciones de huella de carbono".
- En Nombre de la configuración de transferencia, introduce un nombre visible.
- En Configuración de destino, haga clic en el campo ID de conjunto de datos y, a continuación, seleccione Crear conjunto de datos si quiere crear un conjunto de datos de BigQuery para alojar la tabla exportada. También puede seleccionar un conjunto de datos de BigQuery que ya tenga.
- En Detalles de la fuente de datos, confirma el ID de la cuenta de facturación de Cloud que quieres exportar. También puedes añadir más IDs de cuenta en una lista separada por comas. Todos los IDs de cuenta de facturación deben tener el formato
XXXXXX-XXXXXX-XXXXXX
.
- Haz clic en Guardar.
- En la ventana de solicitud de acceso, haz clic en Permitir.
bq
Usa el comando bq mk --transfer_config
para iniciar la exportación:
bq mk \ --transfer_config \ --target_dataset=DATASET \ --display_name=NAME \ --params='{"billing_accounts":"BILLING_ACCOUNT_IDS"}' \ --data_source='61cede5a-0000-2440-ad42-883d24f8f7b8'
Donde:
- DATASET es el conjunto de datos de destino de la configuración de transferencia.
- NAME es el nombre visible de la configuración de transferencia. Por ejemplo, "Informe de emisiones de carbono de la empresa".
- BILLING_ACCOUNT_IDS es el ID de tu cuenta de facturación o una lista de IDs de cuentas de facturación separados por comas. Por ejemplo:
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
Terraform
Usa el recurso de Terraform bigquery_data_transfer_config
para crear una exportación:
resource "google_bigquery_data_transfer_config" "RESOURCE_NAME" { display_name = "NAME" data_source_id = "61cede5a-0000-2440-ad42-883d24f8f7b8" destination_dataset_id = google_bigquery_dataset.DATASET.dataset_id params = { billing_accounts = "BILLING_ACCOUNT_IDS" } }
Donde:
- RESOURCE_NAME es el nombre del recurso de Terraform.
Por ejemplo:
carbon_export
. - NAME es el nombre visible de la configuración de transferencia. Por ejemplo, "Informe de emisiones de carbono de la empresa".
DATASET es el nombre del recurso de
google_bigquery_dataset
Terraform que se va a usar como conjunto de datos de destino de la exportación.BILLING_ACCOUNT_IDS es el ID de tu cuenta de facturación o una lista de IDs de cuentas de facturación separados por comas. Por ejemplo:
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
La configuración de la transferencia se ha creado y exportará datos el día 15 de cada mes.
La configuración de transferencia no exporta automáticamente el historial de datos. Para solicitar datos históricos desde enero del 2021, programa un relleno de datos siguiendo estos pasos.
Consola
Sigue estos pasos para programar la carga retroactiva de datos:
- Ve a los detalles de la transferencia que acabas de crear.
- Haz clic en Programar reposición.
- Selecciona Ejecutar en un periodo.
- Selecciona el 15 de febrero del 2021 como fecha de inicio y la fecha de hoy como fecha de finalización. Ten en cuenta que la exportación del 15 de febrero del 2021 contiene los datos de enero del 2021 y, por lo tanto, es el mes más antiguo que se puede solicitar.
- Haz clic en Aceptar para solicitar el relleno de datos.
Se crearán rellenos de datos para el periodo seleccionado y se exportarán los datos mensuales históricos al conjunto de datos de destino.
bq
Usa el comando bq mk --transfer_run
para crear un relleno:
bq mk \ --transfer_run \ --start_time=START_TIME \ --end_time=END_TIME \ CONFIG
Donde:
- START_TIME es una marca de tiempo
que especifica la hora de inicio del intervalo que se va a rellenar.
Por ejemplo:
2021-02-15T00:00:00Z
. Ten en cuenta que el 15 de febrero del 2021 es la fecha más antigua que puedes especificar aquí, ya que contiene los datos de enero del 2021. - END_TIME es una marca de tiempo
que especifica la hora de finalización del intervalo que se va a rellenar.
Por ejemplo:
2022-09-15T00:00:00Z
. Puedes usar la fecha actual. - TRANSFER_CONFIG es el identificador de la transferencia creada en el paso anterior.
Por ejemplo:
projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000
.
Una vez que se hayan exportado los datos, podrá usar BigQuery para verlos y consultarlos. Consulta más información sobre el esquema de datos.
Puedes compartir los datos exportados con otros usuarios de tu organización concediéndoles el rol de gestión de identidades y accesos Usuario de BigQuery en el proyecto seleccionado anteriormente. También puede conceder acceso granular a nivel de conjunto de datos o de tabla mediante el rol de gestión de identidades y accesos Lector de datos de BigQuery.
Gestionar exportaciones de Huella de carbono
Para ver todas las exportaciones de huella de carbono, haz clic en Exportación de datos y abre el panel lateral.
A continuación, puede gestionar cada exportación de huella de carbono haciendo clic en el nombre de la transferencia para visitar BigQuery Data Transfer Service o en el nombre del conjunto de datos para ver el conjunto de datos de destino. Más información sobre cómo trabajar con transferencias
Exportar a Hojas de cálculo de Google o a CSV
Una vez que hayas configurado la exportación de tu huella de carbono a BigQuery y se haya completado la exportación programada, podrás exportar esos datos de BigQuery a Hojas de cálculo de Google o a un archivo CSV.
- Ir a BigQuery
- En el panel Explorador, despliega tu proyecto y tu conjunto de datos, y selecciona la tabla que contiene los datos de huella de carbono exportados.
- Haz clic en Consulta.
- Introduce una consulta para devolver los datos que quieras exportar. Consulta el ejemplo que aparece a continuación.
- Una vez que se haya ejecutado la consulta, en Resultados de la consulta, haga clic en Guardar resultados.
- Selecciona el formato que quieras y haz clic en Guardar.
La siguiente consulta te permite guardar todo el contenido de la tabla exportada:
SELECT
usage_month,
billing_account_id,
project.number AS project_number,
project.id AS project_id,
service.id AS service_id,
service.description AS service_description,
location.location AS location,
location.region AS region,
carbon_model_version,
carbon_footprint_kgCO2e.scope1 AS carbon_footprint_scope1,
carbon_footprint_kgCO2e.scope2.location_based AS carbon_footprint_scope2_location_based,
carbon_footprint_kgCO2e.scope3 AS carbon_footprint_scope3,
carbon_footprint_total_kgCO2e.location_based AS carbon_footprint_total_location_based
FROM
`PROJECT.DATASET.carbon_footprint`
ORDER BY
usage_month DESC,
carbon_footprint_total_location_based DESC
Siguientes pasos
- Consulta el esquema de datos que se usa en la exportación.
- Consulta tu huella de carbono bruta en la Google Cloud consola.
- Crea paneles de control personalizados con los datos exportados.
- Consulta la metodología de Huella de carbono.