Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Ausführungslogs ansehen

Application Integration generiert detaillierte Ausführungslogs für jede Ausführung einer Integration. Mit den Ausführungslogs können Sie Fehler bei fehlgeschlagenen Integrationsausführungen beheben, den Ausführungsstatus der einzelnen Schritte einer Integration ermitteln und den Ausführungsstatus von Haupt- und Subintegrationen überwachen. Weitere Informationen zum Logging in Application Integration finden Sie unter Einführung in Logs.

Ausführungslogs der Integration aufrufen

Sie können die Ausführungslogs in der Google Cloud Console oder über die API aufrufen.

Hinweis: Wenn die Größe der Ausführungslogs größer als 300 MB ist, löst Application Integration den Fehler Response size too large aus und Logs werden nicht auf der Seite Ausführungslogs geladen. Verwenden Sie in diesem Fall die Methode projects.locations.integrations.executions.list, wie auf dem Tab API beschrieben.

Console

So rufen Sie die Ausführungslogs in der Google Cloud Console auf:

Rufen Sie in der Google Cloud Console die Seite „Application Integration“ auf.
Zu Application Integration
Klicken Sie im Navigationsmenü auf Logs.
Die Seite Ausführungslogs wird angezeigt. Dort werden die Ausführungslogs aufgeführt, die für die Integrationen in der Standardregion generiert wurden. Die folgenden Attribute werden für jeden Ausführungs-Logeintrag angezeigt:
- Name der Integration: Name der Integration.
- Ausführungs-ID: Eine eindeutige Kennung, die für jede Ausführung einer Integration generiert wird.
- Status: Status der Integrationsausführung.
  - In Bearbeitung: Gibt an, dass die Integration gerade ausgeführt wird.
  - Erfolgreich: Gibt an, dass die Integration erfolgreich ausgeführt wurde.
  - Fehlgeschlagen: Gibt an, dass die Integration nicht ausgeführt werden konnte.
  - Abgebrochen: Gibt an, dass die Integrationsausführung vom Nutzer abgebrochen wurde.
  - Auf „Hold“ gesetzt: Gibt an, dass die Integrationsausführung vorübergehend pausiert ist und auf den Abschluss eines Ereignisses oder einer Aktion wartet.
  - Wiederholen bei Hold: Gibt an, dass die Integrationsausführung fehlgeschlagen ist und auf eine Wiederholung wartet.
  - Gesperrt: Gibt an, dass die Integrationsausführung vorübergehend pausiert ist und ein manuelles Eingreifen erforderlich ist, um die Integration fortzusetzen.
- Beginn: Zeitstempel für den Beginn der Integrationsausführung.
- Dauer: Für die Integrationsausführung benötigte Zeit.
  Hinweis: Verwenden Sie den Wert Dauer nicht, um die End-to-End-Ausführungslatenz einer Integration zu berechnen. Die in der Spalte Dauer angezeigte Zeit spiegelt nicht die gesamte Ausführungszeit einer Integration wider, da die zusätzliche Zeit, die von der Integration vor oder nach der Integration verbraucht wurde, nicht berücksichtigt wird. Beispielsweise wird die für die Erzwingung oder Authentifizierung von Kontingenten benötigte Zeit nicht im Wert Dauer berücksichtigt.
- Integrationsversion: Version der ausgeführten Integration.
- Trigger-ID: ID-Wert des Triggers.
- Cloud Logging: Gibt an, ob die Integration für das Logging in Cloud Logging konfiguriert ist. Wenn Cloud Logging aktiviert ist, enthält dieses Feld einen Link zum Aufrufen von Logs in Cloud Logging. Wenn Cloud Logging nicht aktiviert ist, wird dieses Feld auf Deaktiviert gesetzt.
- Wiederholt von: Wenn die Integrationsausführung wiederholt wird, enthält dieses Feld die Ausführungs-ID der wiederholten Ausführung. Sie können eine veröffentlichte Integrationsausführung wiederholen, wenn Sie eine Integration mit denselben Parametern wie die vorherige Ausführung noch einmal ausführen möchten. Sie können eine Ausführung beispielsweise wiederholen, wenn eine Integration aufgrund eines Zeitüberschreitungsfehlers fehlgeschlagen ist oder die Ausgabe einer Integration nicht den Erwartungen entspricht. Informationen zum Wiederholen von Ausführungen finden Sie unter Ausführungen wiederholen.
Wenn Sie regionsspezifische Ausführungslogs aufrufen möchten, ändern Sie die Region in der Liste Region.
Optional können Sie auf Logs aktualisieren klicken, um die aktuelle Logliste zu aktualisieren.

Die folgende Abbildung zeigt ein Beispiel für die Application Integration-Seite Ausführungslogs.

API

Wenn die Größe der Ausführungslogs größer als 300 MB ist, löst Application Integration den Fehler Response too large error aus und Logs werden nicht auf die Seite Ausführungslogs geladen. In diesem Fall müssen Sie die Methode projects.locations.integrations.executions.list zum Abrufen der Logs verwenden. So rufen Sie Logs mithilfe der API-Methode auf:

Um die Ausführungs-ID abzurufen, für die Sie die Ausführungslogs aufrufen möchten, erstellen Sie eine GET-Anfrage mit der Methode projects.locations.integrations.executions.list, wobei Sie den Parameter snapshotMetadataWithoutParams auf TRUE setzen:
```
curl -v -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions' \
    -d "snapshotMetadataWithoutParams=true"
```
Ersetzen Sie Folgendes:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts.
- LOCATION: die Region der Integration.
- INTEGRATION_NAME: der Name der Integration.
Ausführungs-IDs werden in der Antwort zurückgegeben. Kopieren Sie die Ausführungs-ID, für die Sie Logs aufrufen möchten.
Um das Ausführungslog für die Ausführungs-ID abzurufen, erstellen Sie eine GET-Anfrage mit der Methode projects.locations.integrations.executions.list und einem Filter für die Ausführungs-ID, die Sie im vorherigen Schritt kopiert haben:
```
curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=execution_id="EXECUTION_ID"'
```
Ersetzen Sie Folgendes:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts.
- LOCATION: die Region der Integration.
- EXECUTION_ID: die Ausführungs-ID, die Sie im vorherigen Schritt kopiert haben.
In der Antwort finden Sie im Feld ExecutionDetails die Logdetails.

Alternativ können Sie in der Google Cloud Console Ausführungslogs nach der Ausführungs-ID filtern.

Beispiel: Logs filtern

Verwenden Sie das folgende Format, wenn Sie die Antwort filtern möchten, um Logs für alle Integrationen aufzulisten, die eine Integration erwarten:

curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=workflow_name!="INTEGRATION_NAME"'

Ersetzen Sie Folgendes:

PROJECT_ID ist die ID Ihres Google Cloud-Projekts.
LOCATION: die Region der Integration.
INTEGRATION_NAME: der Name der Integration.

Sie können nach den folgenden Feldern filtern:

execution_id, workflow_name und trigger_id: Setzen Sie diese Stringwerte in doppelte Anführungszeichen.
state: Akzeptiert einen ExecutionDetails-Statuswert, z. B. FAILED oder SUCCEEDED. Verwenden Sie keine Anführungszeichen (z. B. state=FAILED).
create_timestamp und update_time: Erfordern einen RFC 3339-Zeitstempel in UTC, der auf Z endet. Verwenden Sie keine Anführungszeichen (z. B. create_timestamp>=2026-10-01T00:00:00Z).

Details zur Taskausführung aufrufen

Sie können detaillierte Logs zur Ausführung jeder Aufgabe in einer Integration oder Subintegration aufrufen. Wenn Sie die Details zur Aufgabenausführung aufrufen möchten, rufen Sie die Seite Ausführungslogs auf und maximieren Sie den Namen der Integration, für die Sie die Details zur Aufgabenausführung aufrufen möchten.

Auf der Seite Ausführungslogs wird eine Liste der Ausführungslogs für die Integration angezeigt. Jedes Ausführungslog entspricht einer bestimmten Ausführung der Integration.

Klicken Sie auf den Namen der Aufgabe, um die Ausführungsdetails einer bestimmten Aufgabe aufzurufen. Der Bereich Details zur Aufgabenausführung wird angezeigt. Darin finden Sie die Ausführungsdetails der Aufgabe.
Wichtig: Im Bereich Details zur Aufgabenausführung werden die vollständigen, nicht gekürzten Werte von Aufgabenvariablen angezeigt, sodass Sie effektiv Fehler beheben können.
Wenn Sie die Anfrage- und Antwortparameter der Aufgabe aufrufen möchten, klicken Sie auf Anfrageparameter oder Antwortparameter.
Wenn Sie die Ausführungslogs einer Subintegration aufrufen möchten, maximieren Sie den Aufgabennamen und klicken Sie auf den Namen der Subintegration. Dies gilt für die Aufgabe „Integrationsaufruf“, die Aufgabe „Für alle parallel“, die Aufgabe „Für jede Schleife“ und die Aufgabe „While-Schleife“.

Logs filtern

Sie können die Logs anhand von Kriterien wie Integrationsname, Ausführungs-ID, Datum oder Zeitraum, Ausführungsstatus, Variablentyp und Variablenname oder -wert filtern. Verwenden Sie das folgende Format, um einen Filter für die Testlauf-Ausführungen hinzuzufügen:

Integration name:INTEGRATION_NAME:TEST_CASE_NAME.

Ersetzen Sie Folgendes:

INTEGRATION_NAME: der Name der Integration, die Funktionstests enthält.
TEST_CASE_NAME: der Name des Testlauf, für den Sie die Testausführungen auflisten möchten.

Beispiel: Integration name:example-integration-name:example-test-case.

Protokolle zur Fehlerbehebung verwenden

Im folgenden Abschnitt wird erläutert, wie Sie Fehler für die folgenden Anwendungsfälle beheben:

Fehlerbehebung bei Integrationsfehlern
Stacktrace-Ausnahmen aufrufen
Connector-Fehler verfolgen

Integrationsfehler beheben

Ausführungslognachrichten können wertvolle Ressourcen für die Fehlerbehebung bei fehlgeschlagenen Integrationsausführungen sein.

Wenn eine Integration beispielsweise in einem bestimmten Zeitraum nicht ausgeführt werden konnte, führen Sie die folgenden Schritte aus, um die Logs aufzurufen und zu filtern, um den Fehler zu beheben:

Suchen Sie in der Liste Integrationen nach der Integration, um den Fehler zu beheben, oder wählen Sie sie aus. Klicken Sie darauf, um den Integrationseditor zu öffnen.
Klicken Sie in der Symbolleiste des Integrationseditors auf Logs, um sich die Logeinträge anzusehen.
Wählen Sie im Feld Ausführungslogfilter die Option Integrationsname aus und geben Sie den Namen der Integration ein, für die Sie die Logs aufrufen möchten.
Drücken Sie die Eingabetaste.
Wenn Sie fehlgeschlagene Integrationen anzeigen möchten, wählen Sie im Feld Ausführungslogfilter die Option Ausführungsstatus aus, um die Statusliste aufzurufen, und wählen Sie dann Fehlgeschlagen aus.
Wenn Sie fehlgeschlagene Integrationen in einem bestimmten Zeitraum anzeigen möchten, wählen Sie im Feld Ausführungslogfilter die Option Startdatum nach aus und geben Sie die gewünschte Zeit im gültigen Format ein. Wählen Sie dann Enddatum vor aus und geben Sie die gewünschte Zeit ein. Mehrere Filter werden standardmäßig mit der AND-Bedingung kombiniert.

Wenn die Integration im gefilterten Zeitraum fehlgeschlagen ist, wird auf der Seite Ausführungslogs eine Liste von Logeinträgen angezeigt. Jeder Logeintrag entspricht einer bestimmten fehlgeschlagenen Ausführung der Integration.

Informationen zur Fehlerbehebung bei fehlgeschlagenen Ausführungslogs mithilfe von KI finden Sie unter Fehlerbehebung bei fehlgeschlagenen Ausführungslogs mithilfe von KI.

Stacktrace-Ausnahmen aufrufen

Zum Aufrufen einer Liste der Ausnahmen klicken Sie auf einen beliebigen Logeintrag. Klicken Sie auf die Links in jeder Ausnahmenachricht, um sich den vollständigen Stacktrace der Ausnahme anzusehen.

Abbildung mit eingeblendeten Logausnahmefehlern

Connector-Fehler verfolgen

Mit den Ausführungslogeinträgen können Sie Fehler beheben und fehlgeschlagene Ausführungen von Connectors-Aufgaben verfolgen. Die Logdaten einer fehlgeschlagenen Connector-Aufgabe werden mit Cloud Logging gespeichert und können im Log-Explorer aufgerufen werden.

Führen Sie die folgenden Schritte aus, um über Application Integration auf die Logdaten einer fehlgeschlagenen Connector-Aufgabe zuzugreifen:

Rufen Sie die Seite Ausführungslogs der gewünschten Integration auf.
Maximieren Sie den Logeintrag Ihrer fehlgeschlagenen Ausführung und suchen Sie die Zeile mit der fehlgeschlagenen Connectors-Aufgabe.
Klicken Sie in der Spalte Status auf Fehlgeschlagen.

Application Integration führt automatisch die erforderliche Abfrage für die fehlgeschlagene Connectors-Aufgabe aus und öffnet die Seite „Log-Explorer“, um die detaillierten Ausführungslogdaten anzuzeigen.

Führen Sie die folgende Abfrage auf der Abfrageseite im Log-Explorer aus, um die Logdaten einer fehlgeschlagenen Connectors-Aufgabe manuell abzurufen. Weitere Informationen zur Verwendung des Log-Explorers finden Sie unter Oberfläche des Log-Explorers.

Abfrageformat

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

Beispiel

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

Logs herunterladen

Sie können Logs für eine bestimmte Integrationsausführung herunterladen, um die Fehlerbehebung und Analyse zu erleichtern. Die Logs enthalten detaillierte Informationen zum Ausführungsprozess, einschließlich Zeitstempeln, Ereignissen und aufgetretenen Fehlern.

Führen Sie die folgenden Schritte aus, um die Ausführungsprotokolle einer Integration herunterzuladen:

Rufen Sie die Seite Ausführungslogs auf.
Klicken Sie in der Zeile, die der Integrationsausführung entspricht, für die Sie die Logs herunterladen möchten, auf (Aktionsmenü) und wählen Sie Herunterladen aus.

Die Ausführungsprotokolle werden als JSON-Datei in den Standardordner Ihres Browsers für Downloads heruntergeladen.

Beschränkung

Wenn das lokale Logging für eine Integration deaktiviert ist, werden für diese Integration keine Ausführungslogs generiert.

Nächste Schritte

Informationen zu Logs in Application Integration finden Sie unter Einführung in Logs.
Weitere Informationen zu Testläufen