Informationen zu den unterstützten Connectors für Application Integration.

Ausführungsprotokolle in Application Integration ansehen

Application Integration generiert Ausführungsprotokollmeldungen für jede Ausführung einer Integration. Die Lognachrichten enthalten Informationen, die Ihnen bei der Ermittlung des Status der einzelnen Schritte einer Integration oder bei der Fehlerbehebung für eine fehlgeschlagene Integration, Aufgabe oder ein Ereignis helfen können. Weitere Informationen zum Logging in Application Integration finden Sie unter Einführung in Logs.

Hinweis:Application Integration speichert die Ausführungsprotokolle einer Integration für einen Zeitraum von maximal 32 Tagen.

Ausführungslogs der Integration aufrufen

Wählen Sie eine der Optionen aus, um die Seite Ausführungslogs aufzurufen:

Console

1. Rufen Sie in Anwendungsintegration die Seite Logs auf.

   Zu den Anwendungsintegrationslogs

2. Klicken Sie im Navigationsmenü auf Logs. Alternativ können Sie im Navigationsmenü auf Integration klicken und die Integration auswählen, für die Sie Logs aufrufen möchten. Klicken Sie dann auf Ausführungsprotokolle für diese Integration ansehen. Die Seite Ausführungslogs wird angezeigt.
   Hinweis:Wenn die Ausführungsprotokolle größer als 300 MB sind, gibt Application Integration den Fehler Response size too large aus und es werden keine Protokolle auf der Seite Ausführungsprotokolle geladen. Verwenden Sie in diesem Fall die Methode projects.locations.integrations.executions.list, wie auf dem Tab „API“ beschrieben.
3. Wählen Sie in der Liste Region die Region aus, um regionsspezifische Ausführungslogs der Integration anzuzeigen. Sie können auch auf Logs aktualisieren klicken, um die aktuelle Logliste zu aktualisieren.

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

   

   Die folgenden Attribute werden für jede Ausführungslognachricht 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 in Hold:Gibt an, dass die Integration der Integration fehlgeschlagen ist und auf einen erneuten Versuch wartet.
     • Gesperrt: Gibt an, dass die Integration 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.

4. Fügen Sie im Feld Filter Filter hinzu. Sie können die Logs anhand von Kriterien wie Integrationsname, Ausführungs-ID, Datum oder Zeitraum, Ausführungsstatus, Variablentyp und Variablenname oder -wert filtern. Für eine benutzerdefinierte Suche verwenden Sie die Methode projects.locations.integrations.executions.list, wie auf dem Tab "API" erläutert.

API

Wenn die Ausführungsprotokolle größer als 300 MB sind, gibt Application Integration den Fehler Response too large error aus und es werden keine Protokolle auf der Seite Ausführungsprotokolle 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:

1. 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 -G GET
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'snapshotMetadataWithoutParams=true'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   In der Antwort werden Ausführungs-IDs zurückgegeben. Kopieren Sie die Ausführungs-ID, für die Sie Logs ansehen möchten.

2. Zum Abrufen des Ausführungslogs für die Ausführungs-ID erstellen Sie eine POST-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 -v -X -G GET
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'filter=execution_id="EXECUTION_ID"'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   Sehen Sie sich in der Antwort das Feld ExecutionDetails an, um die Logdetails aufzurufen.

   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 -v -X -G GET
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter= workflowName!="INTEGRATION_NAME"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'

Protokolle zur Fehlerbehebung verwenden

Im folgenden Abschnitt wird erläutert, wie Sie Fehler mithilfe des Ausführungsprotokolls von Application Integration beheben.

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:

1. 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.
2. Klicken Sie in der Symbolleiste des Integrationseditors auf Logs, um sich die Lognachrichten anzusehen.
3. Klicken Sie auf Filter hinzufügen, um die Liste der verfügbaren Filter aufzurufen.
4. Wählen Sie Integrationsname aus.
5. Geben Sie den Namen der Integration ein und klicken Sie auf Anwenden.
6. Klicken Sie auf Filter hinzufügen, um die Liste der verfügbaren Filter aufzurufen.
7. Wählen Sie Ausführungsstatus aus, um die Statusliste aufzurufen.
8. Klicken Sie auf das Kästchen FEHLGESCHLAGEN und dann auf Anwenden, um fehlgeschlagene Integrationen aufzurufen.
9. Klicken Sie auf Filter hinzufügen, um die Liste der verfügbaren Filter aufzurufen.
10. Wählen Sie Datums-/Uhrzeitbereich aus und geben Sie den gewünschten Zeitraum ein, um ihn auf Fehler zu prüfen. Geben Sie beispielsweise ein:
    • Ab Datum: Wählen Sie 2020-12-16 aus.
    • Ab Uhrzeit: Wählen Sie 04:00:00 PM aus.
    • Bis Datum: Wählen Sie 2019-12-16 aus.
    • Bis Uhrzeit: Wählen Sie 05:00:00 PM aus.
    Mehrere Filter werden standardmäßig mithilfe der UND-Bedingung kombiniert.
    • Klicken Sie auf Anwenden.

Wenn die Integration im gefilterten Zeitraum fehlgeschlagen ist, wird auf der Seite Ausführungslogs eine Liste von Lognachrichten angezeigt. Jede Lognachricht entspricht einer bestimmten fehlgeschlagenen Ausführung der Integration.

Stacktrace-Ausnahmen ansehen

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

Hinweis: Parameter der Ausführungslognachrichten (String oder JSON) werden mit einem Limit von 2.000 Zeichen gekürzt.

Trace-Connector-Fehler

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.

Hinweis: Logdaten einer fehlgeschlagenen Connectors-Aufgabe sind nur im Log-Explorer verfügbar, wenn Cloud Logging für die jeweilige Verbindung in Integrations-Connectors aktiviert ist. Weitere Informationen finden Sie unter Connector-Logs ansehen.

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

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

   

Application Integration führt die erforderliche Abfrage für die fehlgeschlagene Connector-Aufgabe automatisch aus und öffnet die Seite „Log-Explorer“, um die detaillierten Daten des Ausführungsprotokolls 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"

Beschränkung

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

Nächste Schritte

• Informationen zu Logs in Application Integration finden Sie unter Einführung in Logs.