Panoramica

Le etichette ti consentono di allegare metadati coppia chiave-valore alle tue risorse Google Cloudper organizzare l'inventario e categorizzare gli asset. Puoi utilizzare queste coppie chiave-valore per filtrare le risorse, monitorare i costi fatturati granulari e analizzare i pattern di utilizzo tra i team.

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare alle risorse Google Cloud . Ti aiutano a organizzare queste risorse e a gestire i costi su larga scala, con la granularità di cui hai bisogno. Puoi collegare un'etichetta a ogni risorsa e poi filtrare le risorse in base alle relative etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione, che ti consente di suddividere gli addebiti fatturati in base all'etichetta. Con i report sulla fatturazione integrati, puoi filtrare e raggruppare i costi in base alle etichette delle risorse.

Requisiti per le etichette

Le etichette applicate a una risorsa devono soddisfare i seguenti requisiti:

  • Ogni risorsa può avere fino a 64 etichette.
  • Ogni etichetta deve essere una coppia chiave/valore.
  • Le chiavi hanno una lunghezza minima di 1 carattere e una lunghezza massima di 63 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
  • Chiavi e valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8; sono consentiti i caratteri internazionali. Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.
  • La parte della chiave di un'etichetta deve essere univoca all'interno di una singola risorsa. Tuttavia, puoi utilizzare la stessa chiave con più risorse.

Questi limiti si applicano alla chiave e al valore di ogni etichetta e alle singole risorse Google Cloud con etichette. Non esiste un limite al numero di etichette che puoi applicare a tutte le risorse all'interno di un progetto.

Utilizzi comuni delle etichette

Ecco alcuni casi d'uso comuni per le etichette:

  • Etichette per team o centro di costo: aggiungi etichette basate su team o centro di costo per distinguere le risorse di proprietà di team diversi (ad esempio, team:research e team:analytics). Puoi utilizzare questo tipo di etichetta per la contabilità dei costi o la definizione del budget.

  • Etichette dei componenti: ad esempio component:redis, component:frontend, component:ingest e component:dashboard.

  • Etichette di ambiente o fase: ad esempio, environment:production e environment:test.

  • Etichette di stato: ad esempio state:active, state:readytodelete e state:archive.

  • Etichette di proprietà: utilizzate per identificare i team responsabili delle operazioni, ad esempio: team:shopping-cart.

  • Etichette di rete: un'etichetta può essere collegata a una macchina virtuale. I tag di rete definiti in precedenza verranno visualizzati come etichetta senza valore.

Sconsigliamo di creare un numero elevato di etichette univoche, ad esempio per i timestamp o i singoli valori per ogni chiamata API. Il problema di questo approccio è che quando i valori cambiano di frequente o con chiavi che ingombrano il catalogo, diventa difficile filtrare e generare report sulle risorse in modo efficace.

Etichette e tag

Le etichette possono essere utilizzate come annotazioni per le risorse su cui è possibile eseguire query, ma non per impostare condizioni sulle policy. I tag forniscono un modo per consentire o negare in modo condizionale le policy a seconda che una risorsa abbia un tag specifico, fornendo un controllo granulare sulle policy. Per saperne di più, consulta la panoramica dei tag.

Autorizzazioni

Per aggiungere, modificare e visualizzare le etichette dei progetti sono necessarie le seguenti autorizzazioni:

  • Puoi aggiungere o modificare un'etichetta chiamando il metodo projects.patch(). È richiesta l'autorizzazione resourcemanager.projects.update.
  • Puoi visualizzare l'etichetta di un progetto chiamando il metodo projects.get(). È richiesta l'autorizzazione resourcemanager.projects.get.

Comprendi i costi utilizzando le etichette

Puoi collegare un'etichetta a una risorsa e poi filtrare le risorse in base alle relative etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione, che ti consente di suddividere gli addebiti fatturati per etichetta.

Ecco alcuni modi in cui puoi utilizzare le etichette per comprendere i costi:

  • Puoi aggiungere etichette come costcenter=cost_center_name, service=service_name e environment=environment_name alle tue VM o ai tuoi bucket Cloud Storage. In questo modo puoi capire dove vengono eseguite il deployment delle risorse, per quale scopo e il centro di costo a cui devono essere addebitate.
  • Puoi abilitare l'esportazione dei dati di fatturazione in BigQuery. Le etichette vengono esportate in BigQuery con le risorse Google Cloud corrispondenti e il relativo utilizzo. In questo modo puoi monitorare aspetti come il costo di esecuzione del servizio del carrello acquisti nell'applicazione o il costo delle macchine di test degli sviluppatori.
  • Puoi utilizzare BigQuery in combinazione con le etichette per comprendere il costo di tutte le risorse del sistema di test rispetto alle risorse di produzione o il costo di un determinato servizio.

Esempio

In questo esempio, il costo dei servizi playlist per un progetto viene determinato esportando l'utilizzo e le etichette in BigQuery. Per farlo, inizia abilitando l'esportazione della fatturazione in BigQuery. labels-demo-prj è l'origine dell'utilizzo delle risorse e labels_demo_bqexport è il set di dati di destinazione in cui vengono archiviati i dati di utilizzo. Dopo aver esportato l'utilizzo e le etichette in BigQuery, puoi determinare i costi del servizio playlist.

Ecco i dettagli dell'utilizzo di Compute Engine e del costo associato in BigQuery.