Etichettatura delle risorse App Engine

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

Ecco alcuni modi per 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.

  • Applica un'etichetta in base al team o al centro di costo per distinguere i progetti di proprietà di team diversi. Questo tipo di etichetta può essere utilizzato per la contabilità dei costi o la 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 un individuo 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, come Metrics Explorer.

Limitazioni

  • Puoi assegnare fino a 64 etichette a ogni risorsa.
  • Puoi etichettare esplicitamente solo 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 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 informativo 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. Per 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 di una risorsa specifica, come la larghezza di banda in uscita, suddivisi per giorno e per servizio. In questo modo puoi avere informazioni 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 query su di essi:

  1. Esportare i dati di fatturazione in BigQuery.

    Dopo aver attivato BigQuery Export, potrebbero essere necessarie alcune ore per visualizzare i dati.

  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 associare più etichette a una singola riga del 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 se 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 07/10/2017 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 07/10/2017 19:00:00 2017-10-07 20:00:00 servizio frontend 0,020725
App Engine Larghezza di banda in uscita 08/10/2017 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 07/10/2017 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 completo di 24 ore, i dati di fatturazione che esporti contengono solo i dati fino alla mezzanotte più recente, nel fuso orario del Pacifico. Ad esempio, se esporti i dati di fatturazione alle 12:00 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 alle 12:00 Pacific Time del 3 dicembre, il report del 3 dicembre non attribuirà i dati all'etichetta perché 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 verranno attribuiti dati.

Visualizzazione delle etichette nella console Google Cloud

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

  1. Vai alla pagina Servizi App Engine.

    Vai a Servizi

  2. Per ogni servizio, puoi vedere 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 informativo 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.