Etichettatura delle risorse App Engine

Le etichette sono un modo semplice per raggruppare le risorse correlate o associate tra loro. Puoi utilizzare le etichette per avere una visione più granulare delle modalità di fatturazione delle risorse per i servizi App Engine. Puoi anche sfruttare funzionalità come i filtri nidificati per eseguire ricerche più precise delle risorse.

Ecco alcuni modi in cui puoi utilizzare le etichette:

Etichetta i tipi di servizi che crei. Ad esempio, se aggiungi etichette come service:default, service:backend e service:frontend ai servizi App Engine, puoi confrontare il modo in cui questi servizi diversi utilizzano la larghezza di banda in uscita, le ore di istanza e altre risorse.
Etichetta per team o centro di costo per distinguere i progetti appartenenti a team diversi. Questa opzione può essere utilizzata nella contabilità dei costi o nel budget. Ad esempio, team:marketing e team:research.
Etichettare l'ambiente in cui è in esecuzione un servizio. Ad esempio, environment:prod e environment:test.
Assegna un'etichetta in base al proprietario o al contatto principale se esiste una persona responsabile di una risorsa.
Assegna un'etichetta allo stato di un servizio. Ad esempio, state:inuse e state:readyfordeletion.

Le etichette possono essere utilizzate solo per i dati di fatturazione e non per altri strumenti, come Metrics Explorer.

Limitazioni

Puoi assegnare fino a 64 etichette a ciascuna risorsa.
Puoi etichettare esplicitamente i servizi. Le versioni e le istanze ereditano le etichette dal servizio principale.
L'ambiente flessibile di App Engine non supporta le etichette di fatturazione per Firestore in modalità Datastore (Datastore).

Aggiungere o modificare le etichette

Per aggiungere etichette ai servizi App Engine:

Console

Vai alla pagina Servizi App Engine.

Vai a Servizi
Seleziona le caselle di controllo accanto ai servizi che vuoi etichettare.
Fai clic su Mostra riquadro informazioni e seleziona la scheda Etichette per espandere la colonna delle etichette.
Fai clic su Aggiungi etichetta per aggiungere una coppia chiave-valore ai servizi selezionati. Ad esempio, per aggiungere l'etichetta env:prod, inserisci env per Chiave e prod per Valore.
Salva le modifiche.

API Admin

Puoi aggiungere e impostare le etichette tramite la risorsa Service. Consulta la documentazione di riferimento dell'API Admin:

Visualizzare i dati di fatturazione associati ai servizi etichettati

Puoi aggiungere granularità ai dati di fatturazione della tua applicazione utilizzando le etichette. Ad esempio, puoi visualizzare i costi di una risorsa specifica, come la larghezza di banda in uscita, suddivisi per giorno e servizio. In questo modo puoi ottenere insight sui costi giornalieri dell'applicazione e ottimizzare l'utilizzo delle risorse dell'applicazione.

Per visualizzare le etichette per la fatturazione, esporta i dati in BigQuery ed esegui una query sui dati:

Esporta i dati di fatturazione in BigQuery.

Dopo aver abilitato l'esportazione in BigQuery, potrebbero essere necessarie alcune ore per visualizzare i dati.
Dalla pagina BigQuery nella console Google Cloud, seleziona il progetto e il set di dati di fatturazione.
Esegui una query sulla tabella creata dall'esportazione BigQuery.

Le etichette vengono aggiunte al set di dati come campi ripetuti, il che significa che è possibile associare più etichette a una singola riga del set di dati dei costi. Per eseguire facilmente query in base all'etichetta, potresti voler FLATTEN la tabella nel campo delle etichette.

Ad esempio, la seguente query estrae i dati di costo, la chiave di etichetta e il valore dell'etichetta per la larghezza di banda in uscita in cui esiste un'etichetta:

SELECT
  product,
  resource_type,
  start_time,
  end_time,
  labels.key,
  labels.value,
  cost
FROM (FLATTEN([YOUR_DATASET.TABLEID], labels))
WHERE
  cost > 0.0
  and labels.key is not null
  and resource_type = 'Out Bandwidth'
LIMIT 100

BigQuery restituisce i dati con un output suddiviso:

prodotto	resource_type	start_time	end_time	labels_key	labels_value	costo
App Engine	Larghezza di banda in uscita	07-10-2017 22:00:00	07-10-2017 23:00:00	servizio	predefinito	0,020033
App Engine	Larghezza di banda in uscita	07-10-2017 13:00:00	07-10-2017 14:00:00	servizio	frontend	0,016042
App Engine	Larghezza di banda in uscita	07-10-2017 06:00:00	07-10-2017 07:00:00	servizio	backend_task	0,013125
App Engine	Larghezza di banda in uscita	07-10-2017 21:00:00	07-10-2017 22:00:00	servizio	predefinito	0,020722
App Engine	Larghezza di banda in uscita	07-10-2017 19:00:00	07-10-2017 20:00:00	servizio	frontend	0,020725
App Engine	Larghezza di banda in uscita	08-10-2017 04:00:00	08-10-2017 05:00:00	servizio	backend_task	0,02072
App Engine	Larghezza di banda in uscita	08/10/2017 02:00:00	08-10-2017 03:00:00	servizio	predefinito	0,020723
App Engine	Larghezza di banda in uscita	07-10-2017 14:00:00	07-10-2017 15:00:00	servizio	frontend	0,020724
App Engine	Larghezza di banda in uscita	07-10-2017 23:00:00	08-10-2017 00:00:00	servizio	backend_task	0,021417

Periodi di tempo nei report di fatturazione

Per fare in modo che ogni giorno del report copra un periodo completo di 24 ore, i dati di fatturazione esportati contengono solo i dati fino alla mezzanotte del fuso orario del Pacifico più recente. Ad esempio, se esporti i dati di fatturazione a mezzogiorno del 3 dicembre, l'esportazione includerà i dati fino al 2 dicembre, alle 23:59.

Per ogni giorno nel report, i dati di fatturazione vengono attribuiti alle etichette esistenti all'inizio della giornata. Ad esempio, se crei un'etichetta a mezzogiorno (ora del Pacifico USA) del 3 dicembre, il report relativo al 3 dicembre non attribuirà dati all'etichetta poiché l'etichetta non esisteva all'inizio della giornata. I dati verranno attribuiti all'etichetta a partire dal 4 dicembre.

Alle etichette create a mezzogiorno e rimosse nello stesso periodo di 24 ore non saranno attribuiti dati.

Visualizzazione delle etichette nella console Google Cloud

Dopo aver etichettato le risorse, puoi visualizzarle nella console Google Cloud.

Vai alla pagina Servizi App Engine.

Vai a Servizi
Per ciascun servizio, puoi visualizzare tutte le etichette nella colonna Etichette.

Rimozione di etichette

Per rimuovere le etichette dai servizi:

Vai alla pagina Servizi App Engine.

Vai ai servizi App Engine
Seleziona le caselle di controllo accanto ai servizi per i quali vuoi rimuovere le etichette.
Fai clic su Mostra riquadro informazioni e seleziona la scheda Etichette per espandere la colonna delle etichette.
Fai clic sulla X accanto a tutte le etichette da rimuovere.
Salva le modifiche.