Connectez Google Cloud

Enable the FOCUS BigQuery export, run the IAM grants CostGlass prints, verify, and a Terraform version.

Connectez Google Cloud

Turn on Google's FOCUS billing export to BigQuery, then give CostGlass's service account read access to it. No stack to deploy and no key file to create.

Where in CostGlassSettings → Cloud Accounts → Google Cloud (GCP)
PlanAll plans
Who can do thisA Billing Account Administrator (to enable the export) and someone who can grant IAM roles on the hosting project
Time neededAbout 15 minutes
En bref
  • Vous activez l'exportation FOCUS dans votre console Cloud Billing. Google le répertorie comme fonctionnalité d'aperçu.
  • Vous exécutez une poignée de commandes d'octroi IAM en lecture seule que CostGlass imprime pour votre projet. Aucun fichier de clé n'est créé.
  • Les requêtes BigQuery s'exécutent dans votre propre projet, donc Google vous facture le coût (généralement faible) de la requête, et non à CostGlass.
  • CostGlass lit jusqu'à 13 mois lors de la première synchronisation, puis uniquement les 35 derniers jours lors de chaque synchronisation de 6 heures pour maintenir le coût de votre requête à un faible niveau.
  • Un compte de facturation dans une devise que CostGlass ne peut pas convertir est signalé comme non pris en charge plutôt que deviné.
Avant de commencer
  • Votre identifiant de compte Cloud Billing, au format XXXXXX-XXXXXX-XXXXXX.
  • Un projet pour héberger l'exportation et un emplacement de données pour celui-ci (par exemple us ou eu).
  • Cloud Shell, ou tout terminal avec gcloud et bq connecté au bon compte.
  • Autorisation de modifier les paramètres d'exportation de facturation et d'accorder des rôles IAM.

Étape 1 : activez l'export FOCUS

FOCUS (FinOps Open Cost and Usage Spécification) est un format ouvert et indépendant du fournisseur pour les données de facturation. Google peut l'écrire dans BigQuery pour vous.

1
Exportation de facturation ouverte
Dans la console Google Cloud, ouvrez Facturation, choisissez votre compte de facturation et accédez à Exportation de facturation.
2
Activer l'exportation FOCUS
Activez l'exportation FOCUS et choisissez le projet et l'emplacement des données qui hébergeront l'ensemble de données BigQuery. Google currently lists this as a Preview feature, so menu names may change; follow Google's own current instructions for enabling it.
3
Attendre les données
Google crée le tableau lorsqu'il fournit des données pour la première fois et ne le remplit pas instantanément. L'ensemble de données se remplit dès sa première livraison.
Fonctionnalité d'aperçu
L'exportation est une fonctionnalité de Google Preview. Sa disponibilité et son comportement sont contrôlés par Google.

Étape 2 : indiquez à CostGlass où il se trouve

Comptes Cloud → Google Cloud : trois champs et une case à cocher de planificateur facultative.
1
Ouvrez l'onglet
Go to Settings → Cloud Accounts and open Google Cloud (GCP).
2
Remplissez le formulaire
Voir le tableau ci-dessous.
3
Continuer
Click Next: Grant IAM Roles →. CostGlass crée une connexion en attente et imprime les commandes de votre projet.
ChampQue saisirPar défaut
ID de compte de facturation cloud *Affiché en haut de Facturation → Aperçu. Format XXXXXX-XXXXXX-XXXXXX.Aucun
ID du projet hébergeant l'exportation FOCUS *Le projet que vous avez sélectionné lors de l'activation de l'exportation. L'ID du projet, pas son nom d'affichage.Aucun
Emplacement des donnéesL'emplacement que vous avez choisi pour l'ensemble de données d'exportation, par exemple us ou eu.nous
Activez également Instance Scheduler (facultatif – accès en écriture)Ajoute un rôle personnalisé limité au démarrage et à l'arrêt des instances Compute Engine.Désactivé

CostGlass calcule les noms des ensembles de données et des tables à partir de l'ID et de l'emplacement du compte de facturation, afin que vous ne les saisissiez jamais.

Étape 3 : exécutez les commandes IAM

Under Run the Google Cloud CLI grant commands CostGlass shows the commands filled in with your project and CostGlass's service account. Run them in Cloud Shell, then click I've run them — Verify & Connect. Les commandes ressemblent à ceci (espaces réservés en majuscules) :

Accorder des commandes (forme uniquement ; copier les vraies depuis CostGlass)
AccorderObjectifRequis?
bigquery.dataViewer sur l'ensemble de donnéesLire le tableau FOCUSOui
bigquery.jobUser sur le projetExécuter des requêtes dans votre projet (facturé)Oui
API d'actifs cloud, cloudasset.viewer, serviceusage.serviceUsageConsumerInventaire des ressources en lecture seule (VM, disques, GKE, Cloud SQL, buckets, règles de transfert). L'API est gratuite.Affiché dans le cadre de la connexion
recommander.viewerGoogle's own cost recommendations on the Savings pageFacultatif
Rôle personnalisé Instance Schedulercalculate.instances.start, stop, get, listFacultatif, écrivez
Remarque
The connection details also contain two further read-only grants, compute.viewer on the project and billing.viewer on the billing account, that are used for commitment tracking. L'écran ne les répertorie pas aujourd'hui. Le Terraform ci-dessous les propose en option.

Lors de la vérification, CostGlass exécute une petite requête sur la table FOCUS avant de l'activer. On success a message shows the first sync's record count. Ensuite, un inventaire des ressources est effectué ; si cette pièce échoue, les données de coût ne sont pas affectées et l'inventaire est réessayé toutes les 6 heures.

Équivalent Terraform

Click Next: Grant IAM Roles → first, so CostGlass shows the service account e-mail (the value after serviceAccount: in the commands). L'activation de l'exportation FOCUS elle-même n'a aucune ressource Terraform ; faites-le dans la console. Le reste peut être du code :

main.tf (google ~> 6.0)

Variables: project_id, billing_account_id, costglass_service_account are required; dataset_location par défaut nous. If your dataset name differs from the one CostGlass shows, set dataset_id. After applying, click I've run them — Verify & Connect.

Entretenu à la main
Cela reflète les commandes imprimées par l'écran de connexion. S'ils changent, cette page peut prendre du retard. Les commandes à l'écran sont la référence.

Qui paie, à quelle fréquence il se synchronise et limites

  • Coût de la requête : chaque requête s'exécute dans le cadre de votre projet, le traitement BigQuery est donc facturé sur votre facture Google. La première synchronisation indique 13 mois ; après cela, toutes les 6 heures, ne lit que les 35 derniers jours.
  • Devise: les montants sont convertis dans les devises d’affichage aux taux de change en vigueur. Une devise de facturation sans taux disponible est stockée comme non prise en charge et affichée avec un message d'état.
  • Plusieurs projets : vous pouvez connecter plusieurs projets (chacun compte dans la limite de votre forfait).
  • Non couvert : l'ancien format d'exportation à utilisation détaillée.

After connecting, the Google Cloud tab shows Connected Google Cloud Projects with last sync, status and records synced, plus Disconnect.

The tab says "Not available yet".
Les connexions Google Cloud ne sont pas activées sur ce déploiement CostGlass. Contactez l'assistance. Il n'y a rien de mal avec votre compte.
Verify indique qu'il n'a pas pu interroger la table d'exportation FOCUS.
Vérifiez que l'exportation est activée, que les données ont été livrées (un tableau n'apparaît qu'après la première livraison par Google), que les deux subventions IAM ont été appliquées et que les ID de projet et de compte de facturation sont corrects. Attendez un moment et réessayez si vous venez juste d'activer l'exportation.
Pourquoi la commande bq utilise-t-elle GRANT au lieu de add-iam-policy-binding ?
La sous-commande bq pour l'ensemble de données IAM n'est pas disponible sur les projets ordinaires, CostGlass utilise donc l'instruction GRANT standard, qui fonctionne partout.
CostGlass créera-t-il un fichier clé dans mon projet ?
Non. CostGlass s'authentifie avec son propre compte de service via une fédération sans clé. Vous accordez à ce compte des rôles ; aucune clé ne vous quitte.
Comment puis-je me déconnecter ?
Cliquez sur Déconnecter sur la fiche du projet, puis supprimez les subventions IAM si vous souhaitez être minutieux.

Guides associés