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

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

Une Google Cloud étiquette est une paire clé-valeur que vous pouvez attribuer à des Google Cloud ressources, 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 étiquettes, consultez la page Présentation des étiquettes.

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.
  • Étiquettes d'environnement : spécifiez des environnements de développement, de test ou de production (par exemple, env:dev, env:test et env:prod).
  • Étiquettes de composant : catégorisez les ressources par composant d'application ou type de charge de travail (par exemple, component:frontend et component:backend).
  • Suivi précis au niveau de l'instance : étiquetez les instances Spanner avec leur 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 étiquettes appliquées aux instances Spanner doivent répondre aux exigences suivantes :

  • Chaque instance peut comporter jusqu'à 64 étiquettes.
  • Les clés et les valeurs doivent comporter 63 caractères ou moins.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des caractères numériques, 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'une étiquette doit être unique dans une seule instance.

Ajouter et gérer des étiquettes sur des instances Spanner

Vous pouvez ajouter des étiquettes lors de la création d'une instance Spanner ou mettre à jour les étiquettes d'une instance existante.

Autorisations requises

Pour afficher et gérer les étiquettes sur les instances Spanner, vous devez disposer 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 étiquettes

Console

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

    Accéder aux instances Spanner

  2. Cochez la case à côté de l'instance que vous souhaitez étiqueter. Le panneau d'informations s'affiche.

  3. Sélectionnez Étiquettes dans le panneau d'informations.

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

gcloud

Pour créer une instance Spanner avec des étiquettes, exécutez la commande gcloud spanner instances create avec l'option --labels :

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

Pour ajouter ou modifier des étiquettes 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 étiquettes spécifiques d'une instance existante, utilisez l'option --remove-labels :

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

Pour effacer toutes les étiquettes d'une instance existante, utilisez l'option --clear-labels :

gcloud spanner instances update INSTANCE_ID --clear-labels

Analyser les coûts Spanner par étiquette dans Cloud Billing

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

Afficher les coûts regroupés par étiquette dans les rapports de facturation

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

  1. Dans la Google Cloud console, 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 d'étiquette, puis choisissez la clé d'étiquette 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 chaque valeur d'étiquette (par exemple, environment:prod et environment:dev, ou instance_id:my-instance-1 et instance_id:my-instance-2).