Exporta tu huella de carbono
Puedes exportar tus datos de Huella de carbono a BigQuery para realizar análisis de datos o crear informes y paneles personalizados.
La exportación de Huella de carbono captura las emisiones estimadas de gases de efecto invernadero asociadas con el uso de los servicios Google Cloud cubiertos para la cuenta de facturación seleccionada.
Después de configurar una exportación, se te cobrarán los recursos de BigQuery que se usen para almacenar y consultar los datos exportados.
Antes de comenzar
Para crear una exportación de Huella de carbono, te recomendamos que tengas los siguientes roles de IAM:
- Propietario del proyecto o Editor del proyecto en el proyecto Google Cloud al que se exportará
- Visualizador de la Huella de carbono o Visualizador de la cuenta de facturación en la cuenta de facturación cuyos datos de carbono se exportarán
Más precisamente, debes tener los siguientes permisos de IAM en el proyecto Google Cloud :
resourcemanager.projects.update
serviceusage.services.enable
bigquery.transfers.update
Y el siguiente permiso de IAM en la cuenta de facturación:
billing.accounts.getCarbonInformation
Si usas los Controles del servicio de VPC
Si tu organización usa los Controles del servicio de VPC, se debe definir una regla de entrada para la API de BigQuery y la API del Servicio de transferencia de datos de BigQuery.
Para tu regla de política de entrada, haz lo siguiente:
- En la sección "De", establece la fuente en "Se permiten todas las fuentes".
- Otorga permiso a la identidad,
els-da-carbon@gcp-carbon-footprint-exports.iam.gserviceaccount.com
.
Configura una exportación de Huella de carbono a BigQuery
Los datos de la huella de carbono se exportan a través del Servicio de transferencia de datos de BigQuery.
La transferencia de datos crea una tabla particionada mensualmente llamada carbon_footprint
en el conjunto de datos de BigQuery que elijas.
La Huella de carbono exporta los datos de cada mes el día 15 del mes siguiente. Por ejemplo, los datos de carbono de septiembre de 2022 se exportarán el 15 de octubre de 2022.
Una vez que se crea una configuración de transferencia de Huella de carbono, se exportarán automáticamente los informes de carbono futuros el día 15 de cada mes. También podrás ejecutar un reabastecimiento para solicitar datos históricos desde enero de 2021.
Console
Sigue estos pasos para iniciar la exportación:
- Ir a Huella de carbono
- Selecciona la cuenta de facturación de Cloud que deseas exportar en el menú Cuenta de facturación.
- Haz clic en Exportación de datos para abrir el panel lateral y configurar la exportación.
- Selecciona un proyecto para la exportación de datos de tu huella de carbono y, luego, haz clic en Crear exportación.
- En la página del Servicio de transferencia de datos de BigQuery, haz lo siguiente:
- Asegúrate de que Fuente esté configurado como "Google Cloud Exportaciones de huella de carbono".
- En Nombre de la configuración de transferencia, ingresa un nombre visible.
- En Configuración de destino, haz clic en el campo ID del conjunto de datos y, luego, selecciona Crear conjunto de datos nuevo si deseas crear un nuevo conjunto de datos de BigQuery para alojar la tabla exportada o, de lo contrario, selecciona un conjunto de datos de BigQuery existente.
- En Detalles de la fuente de datos, confirma el ID de la cuenta de Facturación de Cloud que se exportará. De manera opcional, agrega IDs de cuentas adicionales como una lista separada por comas. Todos los IDs de las cuentas 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'
Aquí:
- DATASET es el conjunto de datos de destino para la configuración de la transferencia.
- NAME es el nombre visible de la configuración de transferencia. Por ejemplo, "Informe 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 bigquery_data_transfer_config
de Terraform 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" } }
Aquí:
- 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 carbono de la empresa".
DATASET es el nombre del recurso de
google_bigquery_dataset
Terraform que se usará como el conjunto de datos de destino para 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
Se creó la configuración de transferencia y se exportarán datos el día 15 de cada mes futuro.
La configuración de transferencia no exporta automáticamente los datos históricos. Para solicitar datos históricos desde enero de 2021, programa un relleno de datos siguiendo estos pasos.
Console
Sigue estos pasos para programar el reabastecimiento de datos:
- Ve a los detalles de la transferencia que acabas de crear.
- Haz clic en Programar reabastecimiento (Schedule Backfill).
- Selecciona Ejecutar durante un período.
- Selecciona el 15 de febrero de 2021 como la fecha de inicio y la fecha actual como la fecha de finalización. Ten en cuenta que la exportación del 15 de febrero de 2021 contiene los datos de enero de 2021 y, por lo tanto, es el mes más antiguo disponible para solicitar.
- Haz clic en Aceptar para solicitar el reabastecimiento de datos.
Se crearán cargas históricas de datos para el período seleccionado, y se exportarán los datos históricos mensuales al conjunto de datos de destino.
bq
Usa el comando bq mk --transfer_run
para crear un reabastecimiento:
bq mk \ --transfer_run \ --start_time=START_TIME \ --end_time=END_TIME \ CONFIG
Aquí:
- START_TIME es una marca de tiempo que especifica la hora de inicio del rango para el que se realizará el reabastecimiento.
Por ejemplo:
2021-02-15T00:00:00Z
. Ten en cuenta que el 15 de febrero de 2021 es la fecha más antigua que puedes especificar aquí, ya que contiene los datos de enero de 2021. - END_TIME es una marca de tiempo que especifica la hora de finalización del período para el que se completarán los datos faltantes.
Por ejemplo:
2022-09-15T00:00:00Z
. Puedes usar la fecha actual. - TRANSFER_CONFIG es el identificador de la transferencia que se creó en el paso anterior.
Por ejemplo:
projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000
.
Una vez que se exportan los datos, puedes usar BigQuery para verlos y consultarlos. Obtén más información sobre el esquema de datos.
Puedes compartir los datos exportados con otras personas de tu organización otorgándoles el rol de IAM de usuario de BigQuery en el proyecto seleccionado anteriormente. Como alternativa, puedes otorgar acceso detallado a nivel del conjunto de datos o de la tabla con el rol de IAM de visualizador de datos de BigQuery.
Administra las exportaciones de la huella de carbono
Para ver todas las exportaciones existentes de Huella de carbono, haz clic en Exportación de datos y abre el panel lateral.
Luego, puedes administrar cada exportación de la huella de carbono haciendo clic en el nombre de la transferencia para visitar el Servicio de transferencia de datos de BigQuery o el nombre del conjunto de datos para ver el conjunto de datos de destino. Obtén más información para trabajar con transferencias.
Exportar a Hojas de cálculo de Google o CSV
Después de configurar la exportación de tu huella de carbono a BigQuery y de que se complete la exportación programada, puedes exportar esos datos de BigQuery a Hojas de cálculo de Google o CSV.
- Ir a BigQuery
- En el panel Explorador, expande tu proyecto y conjunto de datos y, luego, selecciona la tabla que contiene los datos de la huella de carbono exportados.
- Haz clic en Consulta.
- Ingresa una consulta para devolver los datos que deseas exportar. Consulte el ejemplo que aparece a continuación.
- Después de ejecutar la consulta, en Resultados de la consulta, haz clic en Guardar resultados.
- Selecciona el formato deseado 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
Próximos pasos
- Obtén información sobre el esquema de datos que se usa en la exportación.
- Explora tu huella de carbono bruta en la Google Cloud consola.
- Crea paneles personalizados con los datos exportados.
- Comprende la metodología detrás de la Huella de carbono.