Organizzare le istanze e visualizzare i costi utilizzando le etichette

Questa pagina descrive come utilizzare le etichette Google Cloud per organizzare le istanze Spanner e visualizzare un'analisi dettagliata dei costi.

Un'Google Cloud etichetta è una coppia chiave-valore che puoi assegnare a singole Google Cloud risorse, come le istanze Spanner.

Le etichette ti aiutano a organizzare queste risorse e a visualizzare i costi con la granularità che ti serve. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione, che ti consente di suddividere gli addebiti fatturati per etichetta. Per saperne di più sulle etichette, consulta Panoramica delle etichette.

Casi d'uso comuni per le etichette

Alcuni casi d'uso comuni per le etichette includono:

  • Etichette per team o centro di costo:distinguono le risorse di proprietà di team diversi (ad esempio team:research e team:analytics) per la contabilità dei costi o la definizione del budget.
  • Etichette di ambiente:specifica gli ambienti di sviluppo, test o produzione (ad esempio env:dev, env:test e env:prod).
  • Etichette dei componenti:classifica le risorse in base al componente dell'applicazione o al tipo di carico di lavoro (ad esempio component:frontend e component:backend).
  • Monitoraggio granulare a livello di istanza:etichetta le istanze Spanner con il proprio ID o un identificatore specifico (ad esempio, instance_id:my-instance-1) per suddividere direttamente i costi per istanza nei report sulla fatturazione o nelle query BigQuery.

Requisiti e vincoli

Le etichette applicate alle istanze Spanner devono soddisfare i seguenti requisiti:

  • Ogni istanza può avere fino a 64 etichette.
  • Le chiavi e i valori devono contenere al massimo 63 caratteri.
  • Chiavi e valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi (_) e trattini (-).
  • Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale. Le chiavi non possono essere vuote.
  • La parte della chiave di un'etichetta deve essere univoca all'interno di una singola istanza.

Aggiungi e gestisci le etichette nelle istanze Spanner

Puoi aggiungere etichette quando crei un'istanza Spanner o aggiornare le etichette di un'istanza esistente.

Autorizzazioni obbligatorie

Per visualizzare e gestire le etichette sulle istanze Spanner, devi disporre delle seguenti autorizzazioni IAM:

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

Queste autorizzazioni sono incluse nel ruolo roles/spanner.admin.

Aggiungi, aggiorna o rimuovi le etichette

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai a Istanze Spanner

  2. Seleziona la casella di controllo accanto all'istanza che vuoi etichettare. Viene visualizzato il riquadro informazioni.

  3. Seleziona Etichette nel riquadro Informazioni.

  4. Aggiungi, aggiorna o elimina le etichette per l'istanza, poi fai clic su Salva.

gcloud

Per creare un'istanza Spanner con etichette, esegui il comando gcloud spanner instances create con il flag --labels:

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

Per aggiungere o aggiornare le etichette in un'istanza esistente, esegui il comando gcloud spanner instances update con il flag --update-labels:

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

Per rimuovere etichette specifiche da un'istanza esistente, utilizza il flag --remove-labels:

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

Per cancellare tutte le etichette da un'istanza esistente, utilizza il flag --clear-labels:

gcloud spanner instances update INSTANCE_ID --clear-labels

Analizzare i costi di Spanner per etichette in Fatturazione Cloud

Dopo aver applicato le etichette alle istanze Spanner, puoi utilizzarle per analizzare i costi. Le etichette vengono inoltrate ai dati di costo, consentendoti di filtrare e raggruppare gli addebiti.

Visualizza i costi raggruppati per etichette nei report sulla fatturazione

Puoi visualizzare e analizzare i costi di Spanner raggruppati per chiavi di etichetta direttamente nella console Google Cloud :

  1. Nella console Google Cloud , vai alla sezione Fatturazione.
  2. Seleziona il tuo account di fatturazione e fai clic su Report nel riquadro di navigazione.
  3. Nel riquadro Filtri:
    1. Nella sezione Servizi, seleziona Spanner per isolare i costi del database Spanner.
    2. In Raggruppa per, seleziona Chiavi di etichetta e scegli la chiave di etichetta che vuoi analizzare (ad esempio, environment o instance_id).
  4. Il grafico e la tabella dei costi vengono aggiornati per mostrare una suddivisione dettagliata dei costi raggruppati in base a ogni valore dell'etichetta (ad esempio, environment:prod e environment:dev oppure instance_id:my-instance-1 e instance_id:my-instance-2).