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.

Capturas de exportación de la Huella de carbono las emisiones estimadas de gases de efecto invernadero asociadas al uso de servicios de Google Cloud cubiertos 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 lo siguiente: Roles de IAM:

• Propietario del proyecto o Editor del proyecto en el proyecto de Google Cloud al que deseas exportar.
• Visor 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, una regla de entrada necesita que se definirá para la API de BigQuery y la API del Servicio de transferencia de datos de BigQuery.

Para tu regla de política de Ingress, haz lo siguiente:

• Establece la fuente en el campo 'De' a "Todas las fuentes lo permiten".
• 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 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 creada la configuración de transferencia de la huella de carbono, exportar automáticamente informes de carbono futuros el día 15 de cada mes. Lo que harás ejecutar un reabastecimiento para solicitar datos históricos hasta 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 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 la Fuente esté configurada como “Huella de carbono de Google Cloud”. Exportaciones".
   2. En Nombre de la configuración de transferencia, ingresa un nombre visible.
   3. En Configuración de destino, haz clic en el campo ID del conjunto de datos y, luego, Selecciona Crear nuevo conjunto de datos si deseas crear un nuevo conjunto de datos. Conjunto de datos de BigQuery para alojar la tabla exportada; De manera alternativa, seleccionar un conjunto de datos existente de BigQuery.
   4. En Detalles de la fuente de datos, confirma el ID de la cuenta de Facturación de Cloud para exportar. De manera opcional, agrega IDs de cuenta adicionales como una lista separada por comas. Todos los IDs de las cuentas 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 carbono de la empresa”.
• BILLING_ACCOUNT_IDS es el ID de tu cuenta de facturación o una 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 objeto google_bigquery_dataset de Terraform recurso para usarlo como conjunto de datos de destino para la exportación.

• BILLING_ACCOUNT_IDS es el ID de tu cuenta de facturación o una una lista de IDs de cuentas de facturación separados por comas. Por ejemplo: XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX

La configuración de transferencia ya se creó y los datos se exportarán el día 15 de los próximos meses.

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. Entonces, usa Inscribir la API de 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 las 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 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 rango al 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 rango al que se debe reabastecer. Por ejemplo: 2022-09-15T00:00:00Z. Puedes usar la fecha actual.
• TRANSFER_CONFIG es el identificador de la transferencia creada en del paso anterior. Por ejemplo: projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000.

Una vez exportados los datos, puedes usar BigQuery para ver y consultar los datos. Obtén más información sobre el esquema de datos.

Para compartir los datos exportados con otras personas de tu organización, otorga el Rol de IAM de usuario de BigQuery en el proyecto seleccionado anteriormente. Por otro lado, puedes otorgar acceso de lectura acceso a nivel de conjunto de datos o tabla con la Rol de IAM de visualizador de datos de BigQuery.

Cómo administrar las exportaciones de la huella de carbono

Puedes administrar tus exportaciones de tu huella de carbono a través de la 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

Después de configurar la exportación de la huella de carbono a BigQuery y se completó la exportación programada, puedes exportar los datos de BigQuery a Google Sheets o CSV.

1. Ir a BigQuery
2. En el panel Explorador, expande tu proyecto y conjunto de datos y, luego, selecciona 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

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