Organizzare le istanze e visualizzare i costi utilizzando le etichette

Questa pagina descrive come utilizzare le Google Cloud etichette per organizzare le istanze Spanner e visualizzare una suddivisione dettagliata dei costi.

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

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

Casi d'uso comuni per le etichette

Alcuni casi d'uso comuni per le etichette includono:

  • Etichette di 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: specificano gli ambienti di sviluppo, test o produzione (ad esempio, env:dev, env:test e env:prod).
  • Etichette di componenti: classificano 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: etichettano 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 di 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 avere una lunghezza massima di 63 caratteri.
  • Le chiavi e i 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.

Aggiungere e gestire le etichette sulle 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.

Aggiungere, aggiornare o rimuovere le etichette

Console

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

    Vai a Istanze Spanner

  2. Seleziona la casella di controllo accanto all'istanza a cui vuoi aggiungere un'etichetta. Viene visualizzato il riquadro Informazioni.

  3. Seleziona Etichette nel riquadro Informazioni.

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

gcloud

Per creare un'istanza Spanner con le 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 di 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 nella 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.

Visualizzare i costi raggruppati per etichette nei report di fatturazione

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

  1. Nella Google Cloud console, 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. In 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 per ogni valore dell'etichetta (ad esempio, environment:prod e environment:dev o instance_id:my-instance-1 e instance_id:my-instance-2).