Nutzung überwachen

Auf dieser Seite wird beschrieben, wie Sie Diagramme erstellen, um die Nutzung von Rechen- und Speicherressourcen in Earth Engine mit Cloud Monitoring zu überwachen.

Es gibt noch andere Möglichkeiten, die Earth Engine-Nutzung über die Cloud Console zu überwachen. Diese werden in diesem Dokument nicht behandelt, sind aber:

• Auf der Seite APIs und Dienste > Messwerte werden grundlegende Messwerte wie Traffic (Anzahl der Anfragen), Fehler und Latenz (pro API-Methode, Antwortcode oder Anmeldedaten) angezeigt.
• Auf der Seite APIs und Dienste > Kontingente und Systemlimits sehen Sie die Menge der gespeicherten Assets in Byte und die Anzahl der Leseanfragen für die Assets.
• Auf der Seite APIs & Dienste > Anmeldedaten sehen Sie, welche Anmeldedaten (z. B. Dienstkonten) für den Zugriff auf die API verwendet wurden.

Verbrauch in Cloud Monitoring ansehen

Messwerte im Metrics Explorer in Diagrammen darstellen

1. Rufen Sie in der Cloud Console die Seite Monitoring > Metrics Explorer auf.

   Zum Metrics Explorer

2. Wählen Sie den Namen Ihres Projekts aus, wenn er nicht bereits oben auf der Seite ausgewählt ist.

   • Hinweis: Sie benötigen die entsprechenden IAM-Berechtigungen (Identity and Access Management), um auf Monitoringdaten zugreifen zu können.

3. Klicken Sie auf Messwert auswählen, um einen Messwert auszuwählen, der dem Diagramm hinzugefügt werden soll.

   • Earth Engine-Messwerte finden Sie unter der Ressource Earth Engine-Cloud-Projekt.
   • Standardmäßig sind nur Ressourcen und Messwerte sichtbar, die in der letzten Stunde aktiv waren. Passen Sie den Zeitraum an oder entfernen Sie das Häkchen aus dem Filter „Aktiv“, um mehr Messwerte zu sehen.

4. Klicken Sie nach der Auswahl des Messwerts auf Übernehmen.

5. Konfigurieren Sie im oberen Bereich die Drop-down-Filter, um festzulegen, wie die Daten visualisiert werden sollen.

   • Standardmäßig wird im explorativen Analysetool eine Ratenaggregation für Rechenmesswerte angezeigt. Im Abschnitt Einheiten und Aligner finden Sie weitere Informationen dazu, wie Sie einen anderen Aligner auswählen und explizite Einheiten anzeigen.
   • Wenn Sie beispielsweise die Gesamtzahl der abgeschlossenen Batch-Rechenvorgänge pro workload_tag (siehe Abschnitt Arbeitslast-Tags) in der letzten Woche sehen möchten, können Sie die folgenden Einstellungen auswählen. Hier steht jeder Datenpunkt für die Gesamtzahl der EECU-Stunden, die für jeden abgeschlossenen Batch-Auftrag verwendet wurden.
     
     

Weitere Anleitungen zur Verwendung von Cloud Monitoring finden Sie in der Cloud Monitoring-Dokumentation. Insbesondere die Seite Messwerte für das Diagramm auswählen bietet eine detaillierte Übersicht über die verschiedenen Möglichkeiten zum Erstellen von Abfragen. Auf der Seite Filtern und aggregieren finden Sie weitere Informationen zur Konfiguration der Zeitreihe.

Verfügbare Messwerte

Earth Engine-Messwerte befinden sich in der Vorabversion und können sich ändern.

Messwert	Beschreibung	Verfügbare Labels
Abgeschlossene EECU-Sekunden	In Earth Engine wird die Nutzung erfolgreicher Anfragen in EECU-Sekunden berechnet. Die Nutzung wird erfasst, wenn eine Anfrage abgeschlossen wird. Bei fehlgeschlagenen Anfragen wird sie nicht erfasst.	compute_type: Der Typ der Berechnung, basierend auf der Verarbeitungsumgebung der Anfrage. Einer der folgenden Werte: [online, batch, highvolume]. client_type: Der Kundentyp (falls bekannt), z. B.: ee-js/latest oder python/v0.1.300. Der Kundentyp ist für die Batch-Berechnung nicht festgelegt. workload_tag: Das Arbeitslast-Tag (falls im Client angegeben), z. B. my-export1. Wie Sie dieses Label festlegen, wird im Abschnitt Arbeitslast-Tags beschrieben.
Laufende EECU-Sekunden	Earth Engine-Rechennutzung aller Anfragen in EECU-Sekunden. Die Nutzung wird während der Ausführung einer Anfrage regelmäßig erfasst.	compute_type: Der Typ der Berechnung, basierend auf der Verarbeitungsumgebung der Anfrage. Einer der folgenden Werte: [online, batch, highvolume]. client_type: Der Kundentyp (falls bekannt), z. B.: ee-js/latest oder python/v0.1.300. Der Kundentyp ist für die Batch-Berechnung nicht festgelegt. workload_tag: Das Arbeitslast-Tag (falls im Client angegeben), z. B. my-export1. Wie Sie dieses Label festlegen, wird im Abschnitt Arbeitslast-Tags beschrieben.
Verwendete Bytes	Die Anzahl der Byte des verwendeten Earth Engine-Asset-Speichers. Alle 30 Minuten wird eine Stichprobe erstellt.	–

Eine vollständige Liste der verfügbaren Messwerte in Cloud Monitoring finden Sie unter Google Cloud-Messwerte.

Einheiten und Aligner

Standardmäßig werden Compute-Messwerte als einheitenlose Rate der durchschnittlichen EECU-Sekunden pro Sekunde im Min-Intervall (Standard: 1 Minute) angezeigt.

Wenn Sie die Rohzeit in EECU mit expliziten Einheiten sehen möchten, klicken Sie in Ihrer Abfrage auf das Feld Aggregation und wählen Sie im angezeigten Menü „Ausrichter konfigurieren“ aus. Dadurch wird der Aggregationsvorgang durch zwei neue Vorgänge ersetzt: Gruppierung und Ausrichtungsfunktion. Wenn Sie „Gruppierung: Sum“ und „Ausrichtungsfunktion: Sum“ auswählen, wird ein Diagramm mit expliziten Einheiten erstellt, die die gesamte EECU-Zeit darstellen, die an jedem Datenpunkt verwendet wird. Eine Liste der möglichen Aligner finden Sie in der Referenz für Aligner.

Arbeitslast-Tags

Arbeitslast-Tags sind Labels zum Überwachen bestimmter Berechnungen in Earth Engine. Verwenden Sie setDefaultWorkloadTag, um alle Berechnungen im Script an ein Standard-Arbeitslast-Tag zu binden, es sei denn, eines wird explizit mit ee.data.setWorkloadTag festgelegt. In diesem Fall wird der Standardwert überschrieben. Mit diesen Methoden wird das Label workload_tag für bestimmte Berechnungen und Exportaufgaben festgelegt.

Sie können getaggte Berechnungen dann im Metrics Explorer mit dem Messwert Earth Engine Cloud Project > Project > Used EECUs überwachen und nach workload_tag gruppieren oder filtern.

Hinweis: Der an ee.data.setWorkloadTag übergebene Name darf maximal 64 Zeichen lang sein, muss mit einem alphanumerischen Zeichen ([a-zA-Z0-9]) beginnen und enden und dazwischen Bindestriche (-), Unterstriche (_) und alphanumerische Zeichen enthalten. Er darf nicht leer sein.

So überwachen Sie beispielsweise die EECUs, die für die Bildberechnung und/oder den Export verwendet werden:

Code-Editor (JavaScript)Colab (Python)

// 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

Python einrichten

Auf der Seite Python-Umgebung finden Sie Informationen zur Python API und zur Verwendung von geemap für die interaktive Entwicklung.

import ee
import geemap.core as geemap

# 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 diesem Beispiel sind alle Berechnungen mit dem Tag landsat-compositing (als Standard festgelegt) versehen. Der Export erhält ein eigenes Arbeitslast-Tag, da ee.data.setWorkloadTag vor der Ausführung aufgerufen wird. Mit ee.data.resetWorkloadTag können Sie das Standard-Tag wiederherstellen oder auf einen leeren String zurücksetzen.