Monitoraggio dell'utilizzo

Questa pagina descrive come creare grafici per monitorare il consumo di risorse di calcolo e archiviazione di Earth Engine utilizzando Cloud Monitoring.

Esistono altri modi per monitorare l'utilizzo di Earth Engine da Cloud Console, che non sono oggetto del documento, ma includono:

  • La pagina API e servizi > Metriche, che mostra le metriche di base, tra cui traffico (numero di richieste), errori e latenza (per metodo API, codice di risposta o credenziali).
  • Pagina API e servizi > Quote e limiti di sistema, che mostra la quantità di asset archiviati in byte e il numero di richieste di lettura per gli asset.
  • La pagina API e servizi > Credenziali, che mostra le credenziali (ad es.gli account di servizio) utilizzate per accedere all'API.

Visualizzare il consumo in Cloud Monitoring

Grafici delle metriche in Esplora metriche

  1. Vai alla pagina Monitoraggio > Esplora metriche in Cloud Console.

    Vai a Esplora metriche

  2. Seleziona il nome del progetto se non è già selezionato nella parte superiore della pagina.

  3. Fai clic su Seleziona una metrica per scegliere una metrica da aggiungere al grafico.

    • Le metriche di Earth Engine si trovano nella risorsa Earth Engine Cloud Project.
    • Per impostazione predefinita, sono visibili solo le risorse e le metriche attive nell'ultima ora. Modifica l'intervallo di tempo o deseleziona il filtro "Attivo" per visualizzare più metriche.
  4. Dopo aver selezionato una metrica, fai clic su Applica.

  5. Nel riquadro superiore, configura i filtri a discesa per impostare la modalità di visualizzazione dei dati.

    • Per impostazione predefinita, l'esploratore mostra un'aggregazione delle tariffe per le metriche di calcolo. Consulta la sezione Unità e allineatori per dettagli su come scegliere un allineatore diverso e mostrare unità esplicite.
    • Ad esempio, per visualizzare il calcolo batch completato totale utilizzato per workload_tag (vedi la sezione Tag dei carichi di lavoro) nell'ultima settimana, puoi scegliere le seguenti impostazioni. Qui, ogni punto di dati rappresenta la quantità totale di ore EECU utilizzate da ogni attività batch completata.

      Configurazione di esempio di Esplora metriche

La documentazione di Cloud Monitoring fornisce altre guide sull'utilizzo di Cloud Monitoring. In particolare, la pagina Seleziona le metriche da includere nel grafico fornisce una panoramica dettagliata dei diversi modi per creare query, mentre la pagina Filtro e aggregazione fornisce ulteriori informazioni sulla configurazione della serie temporale.

Metriche disponibili

Metrica Descrizione Etichette disponibili
EECU in secondi completati Utilizzo di calcolo di Earth Engine delle richieste riuscite in secondi EECU. L'utilizzo viene registrato al termine di una richiesta e non viene registrato per le richieste non riuscite. compute_type: il tipo di calcolo, in base all' ambiente di elaborazione della richiesta. Uno di [online, batch, highvolume].

client_type: il tipo di cliente (se noto), ad esempio: ee-js/latest o python/v0.1.300. Il tipo di client non è impostato per il calcolo batch.

workload_tag: il tag del carico di lavoro (se fornito nel client), ad esempio: my-export1. Per informazioni su come impostare questa etichetta, consulta la sezione Tag del carico di lavoro .
EECU in secondi in corso Utilizzo di calcolo di Earth Engine di tutte le richieste in secondi EECU. L'utilizzo viene registrato periodicamente durante l'esecuzione di una richiesta. compute_type: il tipo di calcolo, in base all' ambiente di elaborazione della richiesta. Uno di [online, batch, highvolume].

client_type: il tipo di cliente (se noto), ad esempio: ee-js/latest o python/v0.1.300. Il tipo di client non è impostato per il calcolo batch.

workload_tag: il tag del carico di lavoro (se fornito nel client), ad esempio: my-export1. Per informazioni su come impostare questa etichetta, consulta la sezione Tag del carico di lavoro .
Byte utilizzati Il numero di byte di spazio di archiviazione delle risorse di Earth Engine utilizzati. Campionamento eseguito ogni 30 minuti. N/D

Per un elenco completo delle metriche disponibili in Cloud Monitoring, consulta le metriche di Google Cloud.

Unità e allineatori

Per impostazione predefinita, le metriche di calcolo vengono visualizzate come una frequenza senza unità dei secondi EECU medi utilizzati al secondo nell'intervallo minimo (1 minuto per impostazione predefinita).

Per visualizzare il valore EECU-time non elaborato utilizzato con unità esplicite, fai clic sul campo Aggregazione nella query e scegli "Configura allineatore" dal menu visualizzato. L'operazione di aggregazione viene sostituita da due nuove operazioni: Raggruppamento e Funzione di allineamento. Se scegli "Raggruppamento: Sum" e "Funzione di allineamento: Sum", verrà creato un grafico con unità esplicite che rappresentano il tempo EECU totale utilizzato in ogni punto dati. Consulta la documentazione di riferimento sull'allineatore per un elenco di possibili allineatori.

Tag dei carichi di lavoro

I tag del carico di lavoro sono etichette per il monitoraggio di calcoli specifici in Earth Engine. Utilizza setDefaultWorkloadTag per associare tutti i calcoli nello script a un tag del carico di lavoro predefinito, a meno che non ne sia impostato uno esplicitamente con ee.data.setWorkloadTag, nel quale caso il valore predefinito viene sostituito. Questi metodi impostano l'etichetta workload_tag per calcoli e attività di esportazione specifici.

Puoi quindi monitorare e tenere traccia dei calcoli con tag in Esplorazione metriche utilizzando la metrica Progetto cloud Earth Engine > Progetto > EECU utilizzati e raggruppando o filtrando per workload_tag.

Ad esempio, per monitorare le EECU utilizzate per il calcolo e/o l'esportazione di un'immagine:

Editor di codice (JavaScript)

// Set a default workload tag.
ee.data.setDefaultWorkloadTag('landsat-compositing')
var composite = ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
                     .filterDate('2020-01-01', '2021-01-01')
                     .median();

// Set a workload tag for export.
ee.data.setWorkloadTag('export-jobs');
Export.image.toAsset(composite);
ee.data.resetWorkloadTag(); // Reset to landsat-compositing

ee.data.resetWorkloadTag(true); // Reset back to empty

Configurazione di Python

Per informazioni sull'API Python e sull'utilizzo di geemap per lo sviluppo interattivo, consulta la pagina Ambiente Python.

import ee
import geemap.core as geemap

Colab (Python)

# Authenticate, then initialize with your Cloud Project.
ee.Initialize(project='your-project')

# Set a default workload tag.
ee.data.setDefaultWorkloadTag('landsat-compositing')
composite = (
    ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
    .filterDate('2020-01-01', '2021-01-01')
    .median()
)

# Set a workload tag for export.
ee.data.setWorkloadTag('export-jobs')
ee.batch.Export.image.toAsset(composite).start()
ee.data.resetWorkloadTag()  # Reset to landsat-compositing

ee.data.resetWorkloadTag(True)  # Reset back to empty

# Alternatively, use a workload tag with the `with` context manager.
with ee.data.workloadTagContext('export-jobs'):
  ee.batch.Export.image.toAsset(composite).start()

In questo esempio, tutti i calcoli sono annotati con il tag landsat-compositing (impostato come predefinito) e l'esportazione riceve il proprio tag del carico di lavoro poiché ee.data.setWorkloadTag viene chiamato prima di eseguirlo. Utilizza ee.data.resetWorkloadTag per ripristinare il tag predefinito o per impostare il tag predefinito su una stringa vuota.