Exporta tu huella de carbono

Puedes exportar los datos de tu 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 cobra por los recursos de BigQuery que se usan para almacenar y consultar los datos exportados.

Antes de comenzar

Para crear una exportación de huella de carbono, te recomendamos tener los siguientes roles de IAM:

• Propietario 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.

Para ser más precisos, 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 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 la regla de tu política de entrada, haz lo siguiente:

• Establece la fuente en la sección "De" como "Todas las fuentes permitidas".
• 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 por mes 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 la configuración de transferencia de la Huella de carbono, se exportarán automáticamente los futuros informes de carbono 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:

1. Ir a Huella de carbono
2. Selecciona la cuenta de Facturación de Cloud que deseas exportar desde el menú Cuenta de facturación.
3. Haz clic en Exportar para habilitar el Servicio de transferencia de datos de BigQuery y abre la página Servicio de transferencia de datos de BigQuery.
4. En la página Servicio de transferencia de datos de BigQuery, haz lo siguiente:
   1. Asegúrate de que la Fuente esté configurada como “Exportaciones de 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 del 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 deseas exportar. De manera opcional, agrega IDs de cuenta adicionales en 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 sobre emisiones de carbono de la empresa”.
• BILLING_ACCOUNT_IDS es el ID de tu cuenta de facturación o una lista separada por comas de los IDs de las cuentas de facturación. 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 sobre 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 separada por comas de los IDs de las cuentas de facturación. Por ejemplo: XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX

La configuración de transferencia se creó y exportará datos el día 15 de cada mes.

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 el proyecto antes de ejecutar la operación de exportación.

La configuración de transferencia no exporta los datos históricos de forma automática. Para solicitar datos históricos desde enero de 2021, programa un reabastecimiento de datos mediante los siguientes pasos.

Console

Sigue estos pasos para programar el reabastecimiento de datos:

1. Dirígete 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 primer mes disponible para solicitar.
5. Haz clic en Aceptar para solicitar el reabastecimiento de datos.

Se crearán reabastecimientos de datos para el rango 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 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 reabastecimiento. Por ejemplo: 2021-02-15T00:00:00Z. Ten en cuenta que el 15 de febrero de 2021 es la fecha más temprana 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 para el reabastecimiento. 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 exportados los datos, puedes usar BigQuery para verlos y consultarlos. Obtén más información acerca del esquema de datos.

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

Administra las exportaciones de la huella de carbono

Puedes administrar las exportaciones de tu 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.

Exportando a Hojas de cálculo de Google o CSV

Una vez que configures tu exportación de huella de carbono a BigQuery y se haya completado 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 tu proyecto y conjunto de datos y, luego, selecciona la tabla que contiene los datos exportados de la huella de carbono.
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. Una vez ejecutada 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 en bruto en la consola de Google Cloud.
• Crea paneles personalizados con los datos exportados.
• Comprende la metodología detrás de la Huella de carbono.