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 cubiertos de Google Cloud para 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 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 de Google Cloud al que deseas exportar.
• Visualizador de Huella de carbono o Visualizador de cuentas 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 de 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 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:

• Establece la fuente en la sección "De" en "Se permiten todas las fuentes".
• Otorga permiso a la identidad, [e-mail].

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 mensual 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 haya creado una configuración de transferencia de Huella de carbono, se exportarán automáticamente los informes de carbono futuros el 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:

1. Ir a Huella de carbono
2. Selecciona la cuenta de Facturación de Cloud que deseas exportar en el menú Cuenta de facturación.
3. Haz clic en Exportar para habilitar el Servicio de transferencia de datos de BigQuery y abrir la página del Servicio de transferencia de datos de BigQuery.
4. En la página del Servicio de transferencia de datos de BigQuery, haz lo siguiente:
   1. Asegúrate de que Fuente esté configurada en “Exportaciones de la huella de carbono de Google Cloud”.
   2. En Nombre de la configuración de transferencia (Transfer config name), ingresa un nombre visible.
   3. En Configuración de destino, haz clic en el campo ID de conjunto de datos y, luego, selecciona Crear conjunto de datos nuevo si deseas crear un conjunto de datos de BigQuery nuevo para alojar la tabla exportada. Como alternativa, selecciona un conjunto de datos de BigQuery existente.
   4. En Detalles de la fuente de datos, confirma el ID de la cuenta de Facturación de Cloud que quieres exportar. De manera opcional, agrega IDs de cuenta adicionales como una lista separada por comas. Todos los IDs de cuenta de facturación deben tener el formato XXXXXX-XXXXXX-XXXXXX.
5. Haz clic en Guardar.
6. 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 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 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 emisiones de carbono de la empresa".

• DATASET es el nombre del recurso google_bigquery_dataset de Terraform que se usará como 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 exportará datos el día 15 de cada mes en el futuro.

Nota: Si usas un método que no sea la consola para exportar los datos, la fuente de datos no se inscribirá automáticamente en tu proyecto. Por lo tanto, usa la API de Enroll Data Sources para inscribir la fuente de datos en tu proyecto antes de ejecutar la operación de exportación.

La configuración de transferencia no exporta automáticamente los datos históricos. Para solicitar datos históricos desde enero de 2021, programa un reabastecimiento de datos siguiendo estos pasos.

Console

Sigue estos pasos para programar el reabastecimiento de datos:

1. Ve a los detalles de la transferencia que acabas de crear.
2. Haz clic en Programar reabastecimiento (Schedule Backfill).
3. Selecciona Ejecutar durante un período.
4. Selecciona el 15 de febrero de 2021 como la fecha de inicio y la fecha de hoy 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.
5. Haz clic en Aceptar para solicitar el reabastecimiento de datos.

Se crearán reabastecimientos de datos para el período seleccionado, y se exportarán 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 intervalo que se reabastecerá. 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 rango que se reabastecerá. 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 exporten los datos, puedes usar BigQuery para visualizarlos y consultarlos. Obtén más información sobre el esquema de datos.

Para compartir los datos exportados con otras personas de tu organización, otórgales el rol de IAM de usuario de BigQuery en el proyecto que seleccionaste antes. Como alternativa, puedes otorgar acceso detallado a nivel del conjunto de datos o la tabla con el rol de IAM de visualizador de datos de BigQuery.

Cómo administrar las exportaciones de la huella de carbono

Puedes administrar tus exportaciones de Huella de carbono a través del Servicio de transferencia de datos de BigQuery. Obtén más información sobre cómo trabajar con transferencias.

Exportación a Hojas de cálculo de Google o archivo CSV

Después de configurar la exportación de la 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.

1. Ir a BigQuery
2. En el panel Explorador, expande el proyecto y el conjunto de datos y, luego, selecciona la tabla que contiene los datos de huella de carbono exportados.
3. Haz clic en Consulta.
4. Ingresa una consulta para mostrar los datos que deseas exportar. Consulte el ejemplo que aparece a continuación.
5. Después de ejecutar la consulta, en Resultados de la consulta, haz clic en Guardar resultados.
6. 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 consola de Google Cloud.
• Crear paneles personalizados con los datos exportados
• Comprende la metodología detrás de la Huella de carbono.