Organiser les instances et afficher les coûts à l'aide de libellés

Cette page explique comment utiliser les étiquettes Google Cloud pour organiser vos instances Spanner et afficher une répartition détaillée des coûts.

Une étiquetteGoogle Cloud est une paire clé-valeur que vous pouvez attribuer à des ressources Google Cloud individuelles, telles que des instances Spanner.

Les étiquettes vous aident à organiser ces ressources et à afficher vos coûts avec la précision dont vous avez besoin. Les informations sur les étiquettes sont transmises au système de facturation. Ainsi, vous pouvez trier vos frais facturés par étiquette. Pour en savoir plus sur les libellés, consultez la page Présentation des libellés.

Cas d'utilisation courants des étiquettes

Voici quelques cas d'utilisation courants des étiquettes :

  • Étiquettes d'équipe ou de centre de coûts : distinguez les ressources appartenant à différentes équipes (par exemple, team:research et team:analytics) pour la comptabilité analytique ou la budgétisation.
  • Libellés d'environnement : spécifiez les environnements de développement, de test ou de production (par exemple, env:dev, env:test et env:prod).
  • Libellés de composants : catégorisez les ressources par composant d'application ou par type de charge de travail (par exemple, component:frontend et component:backend).
  • Suivi précis au niveau des instances : attribuez à chaque instance Spanner son propre ID ou un identifiant spécifique (par exemple, instance_id:my-instance-1) pour répartir directement les coûts par instance dans les rapports de facturation ou les requêtes BigQuery.

Exigences et contraintes

Les libellés appliqués aux instances Spanner doivent répondre aux exigences suivantes :

  • Chaque instance peut comporter jusqu'à 64 étiquettes.
  • Les clés et les valeurs ne doivent pas comporter plus de 63 caractères.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des chiffres, des traits de soulignement (_) et des tirets (-).
  • Les clés doivent commencer par une lettre minuscule ou un caractère international. Les clés ne peuvent pas être vides.
  • La partie clé d'un libellé doit être unique au sein d'une instance spécifique.

Ajouter et gérer des libellés sur des instances Spanner

Vous pouvez ajouter des libellés lorsque vous créez une instance Spanner ou mettre à jour les libellés d'une instance existante.

Autorisations requises

Pour afficher et gérer les libellés sur les instances Spanner, vous avez besoin des autorisations IAM suivantes :

  • spanner.instances.get
  • spanner.instances.update

Ces autorisations sont incluses dans le rôle roles/spanner.admin.

Ajouter, modifier ou supprimer des libellés

Console

  1. Dans la console Google Cloud , accédez à la page Instances Spanner.

    Accéder à la page "Instances Spanner"

  2. Cochez la case à côté de l'instance à laquelle vous souhaitez ajouter un libellé. Le panneau d'informations s'affiche.

  3. Sélectionnez Libellés dans le panneau d'informations.

  4. Ajoutez, modifiez ou supprimez des libellés pour l'instance, puis cliquez sur Enregistrer.

gcloud

Pour créer une instance Spanner avec des libellés, exécutez la commande gcloud spanner instances create avec le flag --labels :

gcloud spanner instances create INSTANCE_ID \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_NAME \
    --nodes=NODE_COUNT \
    --labels=KEY=VALUE,KEY=VALUE

Pour ajouter ou mettre à jour des libellés sur une instance existante, exécutez la commande gcloud spanner instances update avec l'option --update-labels :

gcloud spanner instances update INSTANCE_ID \
    --update-labels=KEY=VALUE,KEY=VALUE

Pour supprimer des libellés spécifiques d'une instance existante, utilisez l'option --remove-labels :

gcloud spanner instances update INSTANCE_ID \
    --remove-labels=KEY1,KEY2

Pour effacer tous les libellés d'une instance existante, utilisez l'option --clear-labels :

gcloud spanner instances update INSTANCE_ID --clear-labels

Analyser les coûts Spanner par libellés dans Cloud Billing

Une fois que vous avez appliqué des libellés à vos instances Spanner, vous pouvez les utiliser pour analyser vos coûts. Les étiquettes sont transmises à vos données de coût, ce qui vous permet de filtrer et de regrouper les frais.

Afficher les coûts regroupés par libellé dans les rapports sur la facturation

Vous pouvez afficher et analyser vos coûts Spanner regroupés par clés de libellé directement dans la console Google Cloud  :

  1. Dans la console Google Cloud , accédez à la section Facturation.
  2. Sélectionnez votre compte de facturation, puis cliquez sur Rapports dans le volet de navigation.
  3. Dans le panneau Filtres :
    1. Sous Services, sélectionnez Spanner pour isoler les coûts de votre base de données Spanner.
    2. Sous Critère de regroupement, sélectionnez Clés de libellé, puis choisissez la clé de libellé que vous souhaitez analyser (par exemple, environment ou instance_id).
  4. Le graphique et le tableau des coûts sont mis à jour pour afficher une répartition détaillée des coûts regroupés par valeur de libellé (par exemple, environment:prod et environment:dev, ou instance_id:my-instance-1 et instance_id:my-instance-2).