Exporter votre empreinte carbone
Vous pouvez exporter vos données Empreinte carbone vers BigQuery afin de les analyser ou de créer des tableaux de bord et des rapports personnalisés.
L'exportation de l'empreinte carbone capture les estimations des émissions de gaz à effet de serre associées à l'utilisation des services couverts Google Cloud pour le compte de facturation sélectionné.
Une fois l'exportation configurée, les ressources BigQuery utilisées pour stocker et interroger les données exportées vous sont facturées.
Avant de commencer
Pour créer une exportation de l'empreinte carbone, nous vous recommandons de disposer des rôles IAM suivants :
- Propriétaire de projet ou Éditeur de projet sur le projet Google Cloud vers lequel exporter.
- Lecteur de l'empreinte carbone ou Lecteur de compte de facturation sur le compte de facturation dont les données sur l'empreinte carbone seront exportées.
Plus précisément, vous devez disposer des autorisations IAM suivantes sur le projet Google Cloud :
resourcemanager.projects.update
serviceusage.services.enable
bigquery.transfers.update
et l'autorisation IAM suivante sur le compte de facturation :
billing.accounts.getCarbonInformation
Si vous utilisez VPC Service Controls
Si votre organisation utilise VPC Service Controls, une règle d'entrée doit être définie pour l'API BigQuery et l'API BigQuery Data Transfer Service.
Pour votre règle de stratégie dIngress :
- Dans la section "De", définissez la source sur "Toutes les sources autorisées".
- Accorder l'autorisation à l'identité,
els-da-carbon@gcp-carbon-footprint-exports.iam.gserviceaccount.com
.
Configurer une exportation de l'empreinte carbone vers BigQuery
Les données sur l'empreinte carbone sont exportées via le service de transfert de données BigQuery.
Le transfert de données crée une table partitionnée mensuellement appelée carbon_footprint
dans l'ensemble de données BigQuery de votre choix.
L'exportation de l'empreinte carbone fournit les données de chaque mois le 15e jour du mois suivant. Par exemple, les données sur les émissions de carbone de septembre 2022 seront exportées le 15 octobre 2022.
Une fois qu'une configuration de transfert d'empreinte carbone a été créée, elle exporte automatiquement les futurs rapports sur les émissions de carbone le 15 de chaque mois. Vous pourrez également exécuter un remplissage pour demander des données historiques remontant jusqu'à janvier 2021.
Console
Pour lancer l'exportation, procédez comme suit :
- Accéder à Empreinte carbone
- Sélectionnez le compte de facturation Cloud que vous souhaitez exporter dans le menu Compte de facturation.
- Cliquez sur Exporter les données pour ouvrir le panneau latéral permettant de configurer l'exportation.
- Sélectionnez un projet pour l'exportation de vos données d'empreinte carbone, puis cliquez sur Créer une exportation.
- Sur la page du service de transfert de données BigQuery :
- Assurez-vous que Source est défini sur "Google Cloud Carbon Footprint Exports".
- Dans Nom de la configuration de transfert, saisissez un nom à afficher.
- Dans Paramètres de destination, cliquez sur le champ ID de l'ensemble de données, puis sélectionnez Créer un ensemble de données si vous souhaitez créer un ensemble de données BigQuery pour héberger la table exportée. Vous pouvez également sélectionner un ensemble de données BigQuery existant.
- Dans Détails de la source de données, confirmez l'ID du compte de facturation Cloud à exporter. Vous pouvez également ajouter d'autres ID de compte sous forme de liste d'éléments séparés par une virgule. Tous les ID de compte de facturation doivent être au format
XXXXXX-XXXXXX-XXXXXX
.
- Cliquez sur Enregistrer.
- Dans la fenêtre de demande d'accès, cliquez sur Autoriser.
bq
Exécutez la commande bq mk --transfer_config
pour lancer l'exportation :
bq mk \ --transfer_config \ --target_dataset=DATASET \ --display_name=NAME \ --params='{"billing_accounts":"BILLING_ACCOUNT_IDS"}' \ --data_source='61cede5a-0000-2440-ad42-883d24f8f7b8'
Où :
- DATASET est l'ensemble de données cible de la configuration de transfert.
- NAME est le nom à afficher pour la configuration de transfert. Par exemple : "Rapport sur les émissions de carbone de l'entreprise".
- BILLING_ACCOUNT_IDS correspond à l'ID de votre compte de facturation ou à une liste d'ID de comptes de facturation séparés par une virgule. Exemple :
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
.
Terraform
Utilisez la ressource Terraform bigquery_data_transfer_config
pour créer une exportation :
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" } }
Où :
- RESOURCE_NAME est le nom de la ressource Terraform.
Exemple :
carbon_export
. - NAME est le nom à afficher pour la configuration de transfert. Par exemple : "Rapport sur les émissions de carbone de l'entreprise".
DATASET correspond au nom de la ressource Terraform
google_bigquery_dataset
à utiliser comme ensemble de données cible pour l'exportation.BILLING_ACCOUNT_IDS correspond à l'ID de votre compte de facturation ou à une liste d'ID de comptes de facturation séparés par une virgule. Exemple :
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
.
La configuration du transfert a été créée et exportera les données le 15 de chaque mois à venir.
La configuration du transfert n'exporte pas automatiquement les données historiques. Pour demander des données historiques remontant à janvier 2021, planifiez un remplissage des données en procédant comme suit.
Console
Pour planifier le remplissage des données, procédez comme suit :
- Accédez aux détails du transfert que vous venez de créer.
- Cliquez sur Schedule Backfill (Programmer un remplissage).
- Sélectionnez Exécuter pour une plage de dates.
- Sélectionnez le 15 février 2021 comme date de début et la date du jour comme date de fin. Notez que l'exportation du 15 février 2021 contient les données de janvier 2021. Il s'agit donc du mois le plus ancien pour lequel vous pouvez demander des données.
- Cliquez sur OK pour demander le remplissage des données.
Des remplissages de données seront créés pour la plage sélectionnée, ce qui exportera les données mensuelles historiques vers l'ensemble de données de destination.
bq
Utilisez la commande bq mk --transfer_run
pour créer un remplissage :
bq mk \ --transfer_run \ --start_time=START_TIME \ --end_time=END_TIME \ CONFIG
Où :
- START_TIME est un horodatage qui spécifie l'heure de début de la plage à compléter.
Par exemple :
2021-02-15T00:00:00Z
. Notez que le 15 février 2021 est la date la plus ancienne que vous pouvez spécifier ici, car elle contient les données de janvier 2021. - END_TIME est un code temporel qui spécifie l'heure de fin de la plage à compléter.
Par exemple :
2022-09-15T00:00:00Z
. Vous pouvez utiliser la date actuelle. - TRANSFER_CONFIG est l'identifiant du transfert créé à l'étape précédente.
Exemple :
projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000
.
Une fois les données exportées, vous pouvez utiliser BigQuery pour les afficher et les interroger. En savoir plus sur le schéma de données
Vous pouvez partager les données exportées avec d'autres membres de votre organisation en leur accordant le rôle IAM Utilisateur BigQuery sur le projet sélectionné précédemment. Vous pouvez également accorder un accès précis au niveau de l'ensemble de données ou de la table à l'aide du rôle IAM Lecteur de données BigQuery.
Gérer les exportations d'empreinte carbone
Pour afficher toutes les exportations d'empreinte carbone existantes, cliquez sur Exporter les données et ouvrez le panneau latéral.
Vous pouvez ensuite gérer chaque exportation d'empreinte carbone en cliquant sur le nom du transfert pour accéder au service de transfert de données BigQuery ou sur le nom de l'ensemble de données pour afficher l'ensemble de données de destination. En savoir plus sur l'utilisation des transferts
Exporter vers Google Sheets ou au format CSV
Une fois que vous avez configuré l'exportation de votre empreinte carbone vers BigQuery et que l'exportation planifiée est terminée, vous pouvez exporter ces données de BigQuery vers Google Sheets ou au format CSV.
- Accéder à BigQuery
- Dans le panneau Explorateur, développez votre projet et votre ensemble de données, puis sélectionnez la table contenant les données d'empreinte carbone exportées.
- Cliquez sur Requête.
- Saisissez une requête pour renvoyer les données que vous souhaitez exporter. Un exemple est donné ci-dessous.
- Une fois la requête exécutée, sous Résultats de la requête, cliquez sur Enregistrer les résultats.
- Sélectionnez le format souhaité, puis cliquez sur Enregistrer.
La requête suivante vous permet d'enregistrer l'intégralité du contenu de la table exportée :
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
Étape suivante
- En savoir plus sur le schéma de données utilisé dans l'exportation
- Explorez votre empreinte carbone brute dans la console Google Cloud .
- Créez des tableaux de bord personnalisés à partir des données exportées.
- Comprendre la méthodologie de l'outil Empreinte carbone