Runtime-Seite in der Jitterbit Management Console

Übersicht

Einführung

Die Seite Runtime ist eine Tabelle mit Betriebsprotokollen. Wenn ein Vorgang ausgeführt wird, entsteht ein Betriebsprotokoll. Ein Betriebsprotokoll enthält Informationen darüber, wann und wo ein Vorgang ausgeführt wurde, den Vorgangsstatus, die Anzahl der verarbeiteten Quell- und Zieldatensätze sowie alle Protokollmeldungen. Ob detaillierte Protokollmeldungen angezeigt werden, hängt von den Berechtigungen und Zugriffsstufen sowie davon ab, ob Cloud-Protokollierung aktiviert ist.

Statuswerte

Bei Custom API-, Proxy API- und OData API-Protokolleinträgen wird der Status als HTTP-Statuscode angezeigt (siehe w3.org-Statuscodedefinitionen). Bei Operation-Protokolleinträgen ist der Status einer der folgenden:

Steuerelemente der Runtime-Seite

Die Symbolleiste der Runtime-Seite enthält Steuerelemente zum Suchen, Filtern, Herunterladen und Aktualisieren der Protokolldaten.

Suchleiste

Eine Abfrage besteht aus einem oder mehreren Schlüssel-Wert-Paaren. Mehrere Begriffe werden durch Semikola getrennt. Ein Begriff hat die Form <key><operator><value>. Für die Schlüssel operation, project, environment, agent, status und apiServiceUrl können Werte ein Platzhalterzeichen (% oder *) enthalten, um eine beliebige Zeichenkette zu vergleichen. Der Platzhalterabgleich ist am Anfang des Werts verankert, daher geben nur Suchen nach Präfixen Ergebnisse zurück: Verwende value% oder value*, um Werte zu vergleichen, die mit dem Text beginnen. Ein führendes Platzhalterzeichen erweitert den Abgleich nicht: %value% und *value* werden beide als value% (beginnt mit) behandelt, daher liefert die Suche nach Text, der nur in der Mitte oder am Ende eines Werts vorkommt, keine Ergebnisse mehr. Ein Platzhalterzeichen innerhalb des Werts (z. B. abc%d oder abc*d) funktioniert weiterhin.

Um eine Abfrage zu verwenden, gib eine gültige Abfragespezifikation in die Suchleiste ein und drücke die Eingabetaste:

Wenn der Umschalter Execution Tree View aktiviert ist, gibt eine Abfrage Ergebnisse für die vollständige Ausführungskette eines beliebigen übereinstimmenden Eintrags zurück: Bei einer Abfrage mit dem Schlüssel operation enthalten die Ergebnisse die vollständige Hierarchie der übergeordneten und untergeordneten Operationen, die mit der Operation verknüpft sind, sowie den übergeordneten API-Protokolleintrag, wenn die Operation durch einen API-Aufruf ausgelöst wurde. Die Suchzeichenkette wird in den Ergebnissen blau hervorgehoben. Wenn der Umschalter Execution Tree View deaktiviert ist, werden nur die Einträge zurückgegeben, die direkt mit der Abfrage übereinstimmen.

Die folgende Tabelle zeigt die verfügbaren Komponenten für Abfrageterme:

Abfragebeispiele

Die folgenden sind Beispiele für Abfrageterme:

Gespeicherte Abfragen

Abfragen können wie folgt gespeichert, verwendet, bearbeitet oder gelöscht werden:

• Um eine Abfrage zu speichern, klicke auf Abfrage speichern. Das Abfrageformular wird geöffnet:

  

  Gib Werte für die folgenden Felder ein oder wähle sie aus, und klicke dann auf Speichern:

  • Name: Ein Name für die Abfrage.
  • Abfrage: Ein oder mehrere Abfrageterme mit der gleichen Syntax wie die Suchleiste. Du kannst Terme auf folgende Weise hinzufügen:
    • Klicke auf das Feld, um eine Liste der verfügbaren Suchterme anzuzeigen. Wähle einen aus, um ihn in das Abfragefeld einzugeben, und füge dann einen Operator und einen Wert hinzu.
    • Wähle einen der Abfragevorschläge aus.
    • Gib einen Abfrageterm gefolgt von einem Semikolon ein.

  • Spalten: Wähle die Spalten aus, die in den Suchergebnissen angezeigt werden sollen.

    

  Nach dem Speichern wird das Formular Gespeicherte Abfragen geöffnet:

  

  Klicke auf Gespeicherte Abfragen, um es zu schließen.

• Um eine gespeicherte Abfrage zu verwenden, klicke auf Gespeicherte Abfragen und dann auf die Abfrage, die du ausführen möchtest. Die Abfrageterme werden in die Abfrageleiste kopiert und die Abfrage wird automatisch ausgeführt.

• Um eine gespeicherte Abfrage zu bearbeiten, klicke auf Gespeicherte Abfragen, klicke auf das Symbol Bearbeiten für die Abfrage, die du bearbeiten möchtest. Die Abfrage wird in der Schublade Abfrage bearbeiten geöffnet:

  

  Bearbeite die Abfrage und klicke dann auf Speichern, um sie zu speichern, oder auf Abbrechen, um abzubrechen.

• Um eine gespeicherte Abfrage zu löschen, klicke auf Gespeicherte Abfragen und dann auf das Symbol Löschen für die Abfrage, die du löschen möchtest. Ein Dialog Gespeicherte Abfrage löschen fordert dich auf, den Vorgang zu bestätigen. Klicke auf Löschen, um fortzufahren, oder auf Abbrechen, um abzubrechen.

Zeitbereich

Die Seite Runtime gibt den im Menü „Zeitbereich" angezeigten Zeitraum zurück:

Um den Zeitraum zu ändern, öffne das Menü und wähle eine der folgenden Optionen:

• Letzte 24 Stunden

• Letzte 48 Stunden

• Letzte 72 Stunden

• Benutzerdefinierte Zeit: Wähle diese Option, um das Dialogfeld Benutzerdefinierte Zeit zu öffnen. Damit kannst du Vorgänge basierend auf den Daten der Felder Gestartet und Beendet filtern:

  

  Klicke auf ein Kalendersymbol, um eine Datumsauswahl für ein Feld zu öffnen:

  

  Lege die Daten von oder bis oder beide mithilfe des Kalenders fest. Das Gebietsschema deines Browsers bestimmt, wie Daten angezeigt werden.

  Die Datumsauswahl ermöglicht es dir nur, Daten innerhalb der letzten 30 Tage auszuwählen. Daten außerhalb dieses Bereichs können nicht ausgewählt werden.

  Um eine Zeit festzulegen, gib die Stunde und Minute im Format HH:MM und den Zeitraum (AM oder PM) ein.

  Klicke an einer beliebigen Stelle im Dialogfeld Benutzerdefinierte Zeit, um die Datumsauswahl zu schließen.

  Wenn Datumsbereiche in einem oder beiden Feldern festgelegt sind, klicke auf Anwenden. Um den Bereich zu löschen, klicke auf Löschen. Um die Daten eines Feldes zu löschen, klicke auf das Symbol .

Als CSV herunterladen

Klicke auf Als CSV herunterladen, um das Dialogfeld Protokolle herunterladen zu öffnen. Der Export hat die folgenden Eigenschaften:

• Umfang: Der Export verwendet die angewendete Suchabfrage, Filter und den Zeitbereich und spiegelt alle übereinstimmenden Protokolleinträge wider. Dies entspricht dem vollständigen Ergebnis, das auf allen Seiten der Tabelle angezeigt wird.
• Hierarchie: Der Export behält die Eltern-Kind-Hierarchie von Vorgangsketten bei und hält verwandte Einträge zusammenhängend.
• Reihenfolge: Datensätze werden nach der Gestartet-Zeit des übergeordneten Elements (absteigend) sortiert, wobei untergeordnete Datensätze nach der Ausführungsreihenfolge (aufsteigend) sortiert werden.
• Zeitzone: Die Zeitstempel Gestartet und Beendet verwenden die lokale Zeitzone deines Browsers.
• Verpackung: Wenn der Export mehrere Dateien umfasst, werden alle Dateien in einem einzelnen ZIP-Archiv zum Download verpackt.

Der Dialog enthält die folgende Option:

• Include messages: Wählen Sie diese Option, um vollständige Protokollmeldungen in den Export einzubeziehen. Diese Option ist standardmäßig deaktiviert. Das Einbeziehen von Meldungen kann die Dateigröße und Generierungszeit erheblich erhöhen.

Klicken Sie auf Download, um den Export zu starten, oder auf Cancel, um den Vorgang abzubrechen.

Aktualisierung

Die Tabelle wird automatisch aktualisiert. Um das Aktualisierungsintervall zu ändern, klicken Sie auf Settings. Die Schublade Settings wird geöffnet:

Wählen Sie ein Aktualisierungsintervall aus – entweder Never (Standard), 1 minute, 5 minutes, 15 minutes oder 30 minutes – und klicken Sie dann auf die Schaltfläche Save.

Um die Tabelle jederzeit zu aktualisieren, klicken Sie auf Refresh.

Spalten filtern

Um die Anordnung und Sichtbarkeit von Spalten zu ändern, klicken Sie auf Filter Columns. Die Schublade Columns wird geöffnet:

Die Schublade enthält die folgenden Steuerelemente:

• Show All: Alle Spalten sichtbar machen.
• Move: Ziehen Sie die Spalte per Drag-and-Drop, um ihre Position relativ zu anderen zu ändern.
• Hide: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.
• Show: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.
• Save: Speichern Sie die Spalten.
• Cancel: Schließen Sie die Spaltenschublade, ohne Änderungen zu speichern.

Tabelle mit Operationsdetails

Um die Tabelle nach einer Spalte zu sortieren, klicken Sie auf die Spaltenüberschrift. Klicken Sie erneut, um die Reihenfolge umzukehren. Die verfügbaren Spalten sind wie folgt:

• Name: Der Name der API oder Operation, die dem Protokolleintrag zugeordnet ist. Klicken Sie für Operationseinträge mit untergeordneten Elementen auf das Symbol Expand, um die gesamte Kette anzuzeigen. Klicken Sie auf das Symbol Minimize, um eine Operation und ihre untergeordneten Elemente zu reduzieren. (Gilt für alle Protokolltypen.)

• Log Type: Der Typ des Protokolleintrags: Custom API, Proxy API oder OData API für Operationen, die durch einen API-Aufruf ausgelöst werden, oder Operation für direkt ausgeführte Operationen. (Gilt für alle Protokolltypen.)

• Environment: Der Name der Umgebung, in der die Operation bereitgestellt wurde. (Gilt für alle Protokolltypen.)

• Status: Der Status des Protokolleintrags. Siehe Statuswerte.

• Started: Der Zeitpunkt, zu dem die Operationsausführung angefordert wurde. (Gilt für alle Protokolltypen.)

• Finished: Der Zeitpunkt, zu dem sich der Status der Operation zuletzt geändert hat. (Gilt für alle Protokolltypen.)

• Duration: Die verstrichene Zeit zwischen Started und Finished. (Gilt für alle Protokolltypen.)

• ID: Der eindeutige Bezeichner für den Protokolleintrag. (Gilt für alle Protokolltypen.)

• API Service URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Service Root, der Version und aller Pfadparameter. Diese Spalte wird nur für Protokolleinträge vom Typ Custom API, Proxy API und OData API ausgefüllt.

• Agent: Der Name des Agenten. Diese Spalte wird nur für Protokolleinträge vom Typ Operation ausgefüllt.

• Project: Der Name des Projekts, in dem die Operation ausgeführt wird. Diese Spalte wird nur für Protokolleinträge vom Typ Operation ausgefüllt.

• Root Operation Instance GUID: Der global eindeutige Bezeichner (GUID) der Root-Operation (Operation auf oberster Ebene) der Operation. Dieses Feld ist für Root-Operationen leer, und die Spalte ist standardmäßig ausgeblendet. Diese Spalte wird nur für Protokolleinträge vom Typ Operation ausgefüllt. Um den Wert zu kopieren, zeigen Sie darauf und klicken Sie auf Copy content.

• Operation ID: Der global eindeutige Bezeichner (GUID) der Operation. Diese Spalte wird nur für Protokolleinträge vom Typ Operation ausgefüllt. (Diese Spalte ist standardmäßig ausgeblendet.)

• Actions: Zeigen Sie auf eine Operation, um verfügbare Aktionen anzuzeigen. Die Aktionen unterscheiden sich je nach Protokolltyp:

  Für Protokolleinträge vom Typ Custom API, Proxy API und OData API:

  • View: Öffnen Sie die Protokolldetails.
  • Open API: Öffnen Sie die API im API Manager.

Für Operation-Protokolleinträge:

• Anzeigen: Öffnet die Protokolldetails.

• Operation abbrechen: Aktiviert für Operationen mit dem Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt. Operation abbrechen sendet eine Anfrage an den Agent, um die Operation zu stoppen. Nach dem Klick wird der Status Abbruch angefordert neben dem Echtzeit-Operationsstatus angezeigt.

  Hinweis

  Das Senden einer Abbruchanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen mit dem Status Abbruch angefordert können je nach aktuellem Ausführungszustand des Agents weiterhin ausgeführt werden.

• Zur Operation wechseln: Öffnet das Projekt in Studio und wählt die Operation aus. Diese Aktion ist nur für Studio-Operationen verfügbar, nicht für Design Studio-Operationen.

Bei mehr als 100 Operationen werden diese in Seiten mit jeweils etwa 100 Einträgen aufgeteilt. Um verknüpfte Operationsketten intakt zu halten, werden alle untergeordneten Operationen der letzten auf einer Seite angezeigten übergeordneten Operation auf dieser Seite einbezogen, auch wenn die Gesamtzahl 100 überschreitet. Sie können mit diesen Navigationstasten am unteren Ende der Tabelle zwischen Seiten wechseln:

• Vorherige Seite: Wechselt zur vorherigen Seite.
• Nächste Seite: Wechselt zur nächsten Seite.

Protokolleintrag-Details

Um die Details eines Protokolleintrags anzuzeigen, wählen Sie einen in der Tabelle aus. Die Schublade Meldungen und Protokolle öffnet sich am unteren Ende des Fensters mit den folgenden Registerkarten, je nach Protokolltyp:

• Custom API-, Proxy API- und OData API-Protokolleinträge: Meldungen und Debug-Protokollierung.
• Operation-Protokolleinträge: Meldungen, Aktivitätsprotokolle, Debug-Dateien und Debug-Protokollierung.

Registerkarte „Meldungen"

Der Inhalt der Registerkarte Meldungen unterscheidet sich je nach Protokolltyp des ausgewählten Eintrags.

API-Protokolleinträge

Wenn ein Custom API-, Proxy API- oder OData API-Protokolleintrag ausgewählt ist, zeigt die Registerkarte Meldungen Details zum API-Aufruf in den folgenden ausklappbaren Abschnitten an: API-Informationen, Aufrufinformationen, Aufrufen-Protokoll und API-Nutzlast (falls aktiviert).

API-Informationen

Der Abschnitt API-Informationen zeigt die folgenden Details an:

• API: Der Name der API, die die Operation ausgelöst hat. Klicken Sie auf , um die API-Konfiguration in einer neuen Registerkarte im API Manager zu öffnen.

• Version: Die Versionsnummer der API.

• API-Typ: Der Typ der API, einer der folgenden:

  • CUSTOM_API: Eine benutzerdefinierte API, die im API Manager erstellt wurde.
  • ODATA: Eine OData API, die im API Manager erstellt wurde.

• Anfragemethode: Die HTTP-Methode, die für den API-Aufruf verwendet wird. Mögliche Werte sind GET, POST, PUT, DELETE, PATCH und MERGE.

• API-Anfrage-ID: Ein eindeutiger Bezeichner für die API-Anfrage. Sie können diese ID verwenden, um Protokolle über verschiedene Systeme hinweg zu korrelieren und nach bestimmten Anfragen zu suchen. Klicken Sie auf , um den Wert zu kopieren.

• Quell-IP: Die IP-Adresse der Clientanwendung oder des Servers, der die API-Anfrage gestellt hat.

• API-Gateway: Das API-Gateway, das die Anfrage verarbeitet hat. Dieses Feld zeigt den Domänennamen des Cloud-API-Gateways oder privaten API-Gateways, das den API-Aufruf verarbeitet hat.

• API-Service-URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Service-Root, der Version und aller Pfadparameter. Dies ist die vollständige API-Service-URL, wie sie vom Client verwendet wird.

• Quellapplikation: Die Applikation oder der Browser, der die API-Anfrage gestellt hat.

Anrufinformationen

Der Bereich Anrufinformationen zeigt die HTTP-Request-Header an, die mit dem API-Aufruf unter einer Bezeichnung Request headers gesendet werden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, z. B. accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungs-Header. Header, die Anmeldedaten oder Sitzungsdaten enthalten, werden maskiert, wie unter Maskierte Header beschrieben.

Anrufprotokoll

Der Bereich Anrufprotokoll zeigt Protokollmeldungen auf Systemebene an, die während der Verarbeitung des API-Aufrufs generiert werden. Klicken Sie auf , um das Protokoll in die Zwischenablage zu kopieren.

API-Payload

Der Bereich API-Payload zeigt die Request- und Response-Payload-Daten für den API-Aufruf an. Dieser Bereich ist sichtbar, wenn eines oder beide der folgenden Elemente in der Registerkarte „Einstellungen" der API aktiviert sind: Debug-Modus aktivieren bis oder Request & Response Payloads in Logs anzeigen.

Der Bereich ist in zwei Bereiche unterteilt:

• Request-Text: Die Payload, die mit dem API-Aufruf gesendet wird.

• Response-Text: Die Payload, die von der API zurückgegeben wird. Wenn die Response-Payload das Anzeigelimit überschreitet, wird sie mit einer Bezeichnung (Truncated) angezeigt.

Jeder Bereich bietet die folgenden Steuerelemente:

• Suche: Durchsuchen Sie die Payload nach einer bestimmten Zeichenfolge.

• Kopieren: Kopieren Sie die Payload in die Zwischenablage.

• Herunterladen: Laden Sie die Payload als Datei herunter.

Einträge im Operationsprotokoll

Wenn ein Operation-Protokolleintrag ausgewählt ist, zeigt die Registerkarte Meldungen Folgendes an:

• Quelldatensätze: Bei Verwendung einer FTP- oder Datenbank-Aktivität als Quelle wird die Anzahl der aus dem Quellsystem gelesenen Datensätze angezeigt. Bei anderen Konnektoren wird die Anzahl unabhängig von der Anzahl der Quelldatensätze als 0 angezeigt.

• Zieldatensätze: Bei Verwendung einer FTP- oder Datenbank-Aktivität als Ziel wird die Anzahl der Datensätze angezeigt, die an das Zielsystem übertragen wurden. Bei anderen Konnektoren wird die Anzahl unabhängig von der Anzahl der Zieldatensätze als 0 angezeigt.

• Meldung: Protokolldetails einschließlich eines der folgenden:

  • Vom System generierte Meldungen, die angeben, dass der Vorgang ohne Fehler abgeschlossen wurde.
  • Informations- und Warnmeldungen, die von den Quell- oder Zielsystemen zurückgegeben werden.
  • Validierungswarnungen, die von den Jitterbit-Transformations-, Validierungs- und Scripting-Services zurückgegeben werden.
  • Benutzerdefinierte Meldungen, die vom Tool Operation aufrufen (wenn Fehler auslösen, wenn Operation fehlschlägt aktiviert ist) oder der Funktion WriteToOperationLog() generiert werden.

  Protokollmeldungen werden als einzelne Blöcke angezeigt, die nach Meldungstyp gekennzeichnet sind (z. B. Meldung, Fehler oder Schwerwiegender Fehler bei der Verarbeitung der Operation). Jeder Block bietet zum Kopieren oder zum Herunterladen seines Inhalts.

  Hinweis

  • Daten und Uhrzeiten in Protokollmeldungen werden in ihrem ursprünglichen Format aus der Quelle angezeigt und nicht in die lokale Browserzeit konvertiert.
  • Protokollmeldungen, die ~100 KB (~99.000 Zeichen) überschreiten, werden gekürzt, was durch message truncated am Ende des Protokolls angezeigt wird.

• Meldungen, die in Vor-Transformations-Skripten protokolliert wurden: Meldungen, die während der Ausführung von Vor-Transformations-Skripten generiert werden. Klicken Sie auf , um zu kopieren, oder auf , um herunterzuladen.

Um die Protokollmeldungen einer Operation in der Registerkarte Meldungen anzuzeigen, muss Folgendes erfüllt sein:

• Sie müssen Mitglied einer Rolle mit mindestens Lese-Organisationsberechtigung und Protokolle anzeigen-Umgebungszugriff sein.
• Cloud-Protokollierung ist auf der Private-Agent-Gruppe aktiviert. (Cloud-Protokollierung ist auf Cloud-Agent-Gruppen immer aktiviert.) Wenn diese deaktiviert ist und Ihre Netzwerkkonfiguration es Ihnen ermöglicht, sich direkt mit dem Agent-Host zu verbinden, können Protokollmeldungen sicher angezeigt werden, indem Sie auf den Link Protokollmeldungen vom Agent anzeigen klicken.

Registerkarte „Activity Logs"

Diese Registerkarte enthält Links zu Erfolgs- oder Fehlerdateien, die von den Aktivitäten Salesforce, Salesforce Service Cloud oder ServiceMax erstellt werden, die auf einem privaten Agent ausgeführt werden.

Die Dateien liegen im CSV-Format vor. Um eine Datei herunterzuladen, klicken Sie auf ihren Link.

Activity-Log-Dateien werden nach 14 Tagen automatisch vom Datenbereinigungs-Service des privaten Agenten gelöscht. Sie können dieses Verhalten im Abschnitt [ResultFiles] der Datei jitterbit.conf des privaten Agenten ändern oder die Regeln des Datenbereinigungs-Service anpassen.

Activity-Log-Downloads sind für Cloud-Agenten deaktiviert. Möglicherweise werden Download-Links für Activity Logs von Cloud-Agenten angezeigt, aber der Versuch, Logs herunterzuladen, erzeugt eine Fehlermeldung.

Registerkarte „Debug Files"

Wenn Debug-Logging für private Agenten aktiviert ist, enthält diese Registerkarte einen Link zum Herunterladen von Operation-Debug-Log-Dateien. Die Debug-Dateien werden standardmäßig nach 1 Tag oder wie in den Bereinigungsregeln eines privaten Agenten konfiguriert entfernt.

Registerkarte „Debug Logging"

Wenn Debug-Logging auf Operationsebene aktiviert ist (für Cloud-Agenten oder für private Agenten) und die Operation auf einem Agent der Version 10.48 oder später ausgeführt wurde, zeigt diese Registerkarte die Details der vollständigen Ausführungshierarchie einer Studio-Operation. Die Operationsprotokoll-Ansicht zeigt eine geteilte Ansicht mit Operationsprotokollen im linken Bereich und detaillierten Protokollinformationen für die ausgewählte Operation im rechten Bereich. Die Ansicht verwendet die ausgewählten Tabellensteuerelemente zum Filtern von Ergebnissen. Wenn Operationen mit Operationsaktionen oder der Funktion RunOperation verkettet sind, werden diese Operationen unter der übergeordneten Operation aufgelistet.

Wenn Operation-Debug-Logging aktiviert ist, kann diese Registerkarte auch Komponenteneingabe- und -ausgabedaten und API-Anfrage- und Antwortdaten anzeigen (wenn die Operation durch eine API Manager-API ausgelöst wird). Die Anfrage- und Antwort-Payload wird nur eingebunden, wenn Show Request & Response Payloads in Logs auch in der Registerkarte Settings der API aktiviert ist.

Übergeordnete Operationen (und alle untergeordneten Operationen darunter) werden in aufsteigender Reihenfolge nach Started sortiert. Die Tabelle kann (nur für Operationen auf oberster Ebene) nach Name, Started, Finished, Duration oder Status sortiert werden, indem Sie auf die jeweilige Kopfzeile klicken.

Wenn Sie die Operationsprotokoll-Ansicht öffnen, wird das erste Operationsprotokoll in der Liste standardmäßig ausgewählt. Die detaillierten Protokollinformationen für diese Operation werden im rechten Bereich angezeigt.

• Name: Der Name der Operation oder des Operationsschritts. Die Carets, die zum Erweitern oder Reduzieren zusätzlicher Zeilen verwendet werden können, werden auf übergeordneten Operationen und auf Operationen angezeigt, für die Komponenteneingabe- und -ausgabedaten verfügbar sind:

  • Übergeordnete Operationen: Wenn eine übergeordnete Operation erweitert wird, werden zusätzliche Zeilen für ihre untergeordneten Operationen in der Reihenfolge ihrer Ausführung angezeigt. Standardmäßig sind alle übergeordneten Operationen erweitert. Verwenden Sie die Symbole zum Reduzieren oder zum Erweitern, um alle übergeordneten Operationen zu reduzieren oder zu erweitern.

• Gestartet: Das Datum und die Uhrzeit, zu denen die Operation oder der Operationsschritt ausgeführt wurde, angezeigt als lokale Browserzeit.

• Beendet: Das Datum und die Uhrzeit, zu denen die Operation oder der Operationsschritt beendet wurde, angezeigt als lokale Browserzeit.

• Dauer: Die verstrichene Zeit zwischen Gestartet und Beendet, angegeben in Sekunden für Operationen und in Millisekunden für Operationsschritte.

• Status: Der Status der Operation oder des Operationsschritts. Für einen Logeintrag siehe Statuswerte. Für einen Operationsschritt ist dies einer der folgenden:

  • Abgeschlossen: Der Operationsschritt wurde ausgeführt und ohne Fehler abgeschlossen.
  • Fehler: Der Operationsschritt wurde ausgeführt, konnte aber aufgrund eines Fehlers nicht abgeschlossen werden.
  • Unvollständig: Der Operationsschritt wurde nicht ausgeführt oder abgeschlossen. Mögliche Gründe für diesen Status sind, dass der Operationsschritt auf die Ausführung wartet oder dass ein Fehler in einem vorherigen Operationsschritt die Ausführung des folgenden Schritts verhindert hat.

• Aktionen: Diese Aktionen sind für Operationsschritte nicht verfügbar und unterscheiden sich je nach Zeilentyp:

  • API-Logeinträge: Diese Aktion ist in Zeilen für den API-Logeintrag verfügbar, der die Operation ausgelöst hat.

    • Zur API: Öffnet die Detailseite der entsprechenden API im API Manager mit automatisch geöffneter Schublade.

  • Operationszeilen: Diese Aktionen sind in Zeilen für die Operation selbst verfügbar, einschließlich aller verketteten untergeordneten Operationen.

    • Operation abbrechen: Aktiviert für Operationen mit dem Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt. Operation abbrechen sendet eine Anfrage an den Agent, um die Operation zu beenden. Nach dem Klick wird der Status Abbruch angefordert neben dem Echtzeit-Operationsstatus angezeigt.

      Hinweis

      Das Senden einer Abbruchanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen mit dem Status Abbruch angefordert können je nach aktuellem Ausführungszustand des Agenten weiterhin ausgeführt werden.

    • Zur Operation: Öffnet das Projekt in Studio und wählt die Operation aus.

• Aktualisieren: Klicken Sie, um die Liste der Operationsprotokolle zu aktualisieren.

• Spalten filtern: Klicken Sie, um eine Schublade zu öffnen, mit der Sie die Spalten neu anordnen oder deren Sichtbarkeit im Operationslisten-Panel anpassen können:

  

  • Alle anzeigen: Alle Spalten sichtbar machen.

  • Verschieben: Ziehen Sie per Drag-and-Drop, um die Position der Spalte relativ zu anderen zu ändern.

  • Ausblenden: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.

  • Anzeigen: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.

• Spalten vergrößern: Ziehen Sie die Größe ändern-Leiste einer Spalte, um sie zu vergrößern.

• Operationsprotokoll: Um das Protokoll für eine einzelne Operation anzuzeigen oder auszublenden, klicken Sie auf eine Operation aus der Liste.

  • Logmeldungen: Logmeldungen enthalten die Protokolldetails für die ausgewählte Operation. Ob Logmeldungen angezeigt werden, hängt von den Berechtigungen und Zugriffsstufen des aktuellen Benutzers und davon ab, ob Cloud-Protokollierung aktiviert ist. Weitere Informationen finden Sie unter Registerkarte „Meldungen" weiter oben auf dieser Seite.

    Hinweis

    Datum und Uhrzeit, die in den Logmeldungen selbst angezeigt werden, werden nicht in die lokale Browserzeit konvertiert, sondern im ursprünglichen Format aus der Quelle der Logmeldung gemeldet.

  • Kopieren: Kopiert die Protokolldaten in die Zwischenablage.

  • Herunterladen: Lädt die Logmeldungen als Textdatei herunter.
  • Anzeigen / Ausblenden: Zeigt die Logmeldungen an oder blendet sie aus.

Komponenteneingabe- und -ausgabedaten

Komponenteneingabe- und -ausgabedaten werden generiert, wenn eine Operation das Operationsprotokoll zum Debuggen auf Operationsebene aktiviert hat (für Cloud-Agenten oder für private Agenten) und die Operation auf einem Agent der Version 10.48 oder später ausgeführt wurde.

Wenn Komponenteneingabe- und -ausgabedaten vorhanden sind, wird eine grafische Darstellung des Vorgangs oder des Vorgangsschritts im Vorgangslisten-Panel angezeigt.

Symbole für Aktivitäten und Transformationen, die als Vorgangsschritte verwendet werden, werden angezeigt. Sie können auf einen Vorgangsschritt klicken, um die Komponenteneingabe- und -ausgabedaten für diesen einzelnen Vorgangsschritt anzuzeigen oder auszublenden. Jeder Eingabe- und Ausgabeprotokolleintrag ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eingabe- oder Ausgabeprotokolleintrag 100 MB überschreiten, werden keine Daten angezeigt.

• Suchen: Durchsuchen Sie die Daten nach dem eingegebenen Text.
• Kopieren: Kopiert die Protokolldaten in die Zwischenablage.
• Herunterladen: Lädt die Eingabe- oder Ausgabedaten als Datei im entsprechenden Datenformat herunter. Die Datei wird mit dem Namen des Vorgangsschritts gefolgt von _input oder _output benannt.

API-Request- und Response-Daten

Wenn ein Vorgang durch eine API Manager benutzerdefinierte API oder OData API ausgelöst wird, hängen die in Vorgangsprotokollen angezeigten Informationen davon ab, welche Einstellungen aktiviert sind. Fehlgeschlagene Vorgänge werden immer protokolliert. Erfolgreiche Ausführungen werden in Studio-Vorgangsprotokollen nur angezeigt, wenn Debug-Modus aktivieren bis (eine API Manager-Einstellung) oder Vorgangs-Debug-Protokollierung (eine Agent-Einstellung) aktiv ist. zeigt an, dass die Einstellung diese Funktion hinzufügt; zeigt an, dass dies nicht der Fall ist:

API-Informationen

Das Operationsprotokoll kann die folgenden Informationen für API-Aufrufe anzeigen:

• API: Der Name der API, die die Operation ausgelöst hat.

  • API in neuem Tab öffnen: Klicken Sie, um die API in einem neuen Tab im API Manager zu öffnen.

• API-Typ: Dieses Feld kann einen der folgenden Typen haben:

  • CUSTOM_API: Eine benutzerdefinierte API, die im API Manager erstellt wurde.
  • ODATA: Eine OData-API, die im API Manager erstellt wurde.

• Request-Methode: Die HTTP-Methode, die für den API-Aufruf verwendet wird. Mögliche Werte sind GET, POST, PUT, DELETE, PATCH und MERGE.

• API-Request-ID: Ein eindeutiger Bezeichner für den API-Request. Sie können diese ID verwenden, um Protokolle systemübergreifend zu korrelieren und nach bestimmten Requests zu suchen. Klicken Sie auf das Kopiersymbol, um den Wert zu kopieren.

• Quell-IP: Die IP-Adresse der Clientanwendung oder des Servers, der den API-Request gestellt hat.

• API-Gateway: Das API-Gateway, das die Anfrage verarbeitet hat. Dieses Feld zeigt den Domänennamen des Cloud-API-Gateways oder privaten API-Gateways, das den API-Aufruf verarbeitet hat.

• API-Service-URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Service-Root, der Version und aller Pfadparameter. Dies ist die vollständige API-Service-URL, wie sie vom Client verwendet wird.

• Quellapplikation: Die Applikation oder der Browser, der den API-Request gestellt hat.

Aufrufinformationen

Das Operationsprotokoll zeigt einen Abschnitt Aufrufinformationen mit den HTTP-Request-Headern an, die mit dem API-Aufruf gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, z. B. accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungs-Header. Header, die Anmeldedaten oder Sitzungsdaten enthalten, werden maskiert, wie unter Maskierte Header beschrieben.

Aufrufsprotokoll

Das Operationsprotokoll zeigt auch einen Abschnitt Aufrufsprotokoll mit detaillierten Trace-Informationen zur Verarbeitung des API-Requests an. Diese Informationen können zur Behebung von API-Gateway-Problemen, Timeout-Problemen oder zum Verständnis des internen Verarbeitungsflusses der API verwendet werden. Der spezifische Inhalt des Aufrusprotokolls variiert je nach API-Konfiguration, Gateway-Einstellungen und ob während der Request-Verarbeitung Probleme aufgetreten sind.