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 ottenere una visualizzazione più granulare di come vengono fatturate le risorse per i tuoi servizi App Engine. Puoi anche sfruttare funzionalità come il filtro nidificato per eseguire ricerche più precise delle tue 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 tuoi servizi App Engine, puoi confrontare il modo in cui questi diversi servizi 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 di proprietà di team diversi. Può essere utilizzato nella contabilità dei costi o nella definizione del budget. Ad esempio, team:marketing e team:research.

  • Etichetta l'ambiente in cui è in esecuzione un servizio. Ad esempio, environment:prod e environment:test.

  • Etichetta per proprietario o contatto principale se esiste una persona fisica responsabile di una risorsa.

  • Etichettare lo 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, ad esempio Metrics Explorere.

Limitazioni

  • Puoi assegnare fino a 64 etichette a ogni risorsa.
  • Puoi etichettare i servizi solo in modo esplicito. Le versioni e le istanze ereditano le etichette dal servizio padre.
  • L'ambiente flessibile di App Engine non supporta le etichette di fatturazione per l'utilizzo di Firestore in modalità Datastore (Datastore).

Aggiunta o modifica di etichette

Per aggiungere etichette ai servizi App Engine:

Console

  1. Vai alla pagina Servizi App Engine.

    Vai a Servizi

  2. Seleziona le caselle di controllo accanto ai servizi che vuoi etichettare.

  3. Fai clic su Mostra riquadro informazioni e seleziona la scheda Etichette per espandere la colonna delle etichette.

  4. 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 la chiave e prod per il valore.

  5. Salva le modifiche.

API Admin

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

Visualizzazione dei dati di fatturazione associati ai servizi etichettati

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

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

  1. Esportare i dati di fatturazione in BigQuery.

    Dopo aver attivato l'esportazione BigQuery, potrebbero essere necessarie alcune ore prima che i dati vengano visualizzati.

  2. Nella pagina BigQuery della console Google Cloud , seleziona il progetto e il set di dati di fatturazione.

  3. 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 allegare più etichette a una singola riga nel set di dati sui costi. Per eseguire facilmente query per etichetta, ti consigliamo di FLATTEN la tabella nel campo delle etichette.

Ad esempio, la seguente query estrae i dati di costo, la chiave dell'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 appiattito:

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

Periodi di tempo nei report sulla fatturazione

Per assicurarti che ogni giorno del report copra un periodo di 24 ore completo, i dati di fatturazione che esporti contengono solo i dati fino alla mezzanotte più recente, ora del Pacifico. Ad esempio, se esporti i dati di fatturazione a mezzogiorno del 3 dicembre, l'esportazione include i dati fino alle 23:59 del 2 dicembre.

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

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

Visualizzazione delle etichette nella console Google Cloud

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

  1. Vai alla pagina Servizi App Engine.

    Vai a Servizi

  2. Per ogni servizio, puoi visualizzare tutte le etichette nella colonna Etichette.

Rimozione di etichette

Per rimuovere le etichette dai servizi:

  1. Vai alla pagina Servizi App Engine.

    Vai a Servizi App Engine

  2. Seleziona le caselle di controllo accanto ai servizi per i quali vuoi rimuovere le etichette.

  3. Fai clic su Mostra riquadro informazioni e seleziona la scheda Etichette per espandere la colonna delle etichette.

  4. Fai clic sulla X accanto a tutte le etichette che vuoi rimuovere.

  5. Salva le modifiche.