Runtime-Seite in der Jitterbit Management Console

Übersicht

Einführung

Die Seite Runtime ist eine Tabelle von Betriebsprotokollen. Wenn ein Vorgang ausgeführt wird, wird ein Betriebsprotokoll generiert. 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.

Runtime-Seitensteuerelement

Die Symbolleiste der Seite Runtime 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 Starts-with-Suchen (Präfix) Ergebnisse zurück: Verwenden Sie value% oder value*, um Werte zu vergleichen, die mit dem Text beginnen. Ein führender Platzhalter 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 Platzhalter innerhalb des Werts (z. B. abc%d oder abc*d) wird weiterhin abgeglichen.

Um eine Abfrage zu verwenden, geben Sie eine gültige Abfragespezifikation in die Suchleiste ein und drücken Sie die Eingabetaste:

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

Die folgende Tabelle zeigt die verfügbaren Abfragebegriffkomponenten:

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 mit dem Kalender fest. Die Gebietsschema-Einstellung deines Browsers bestimmt, wie Daten angezeigt werden.

  Die Datumsauswahl ermöglicht dir nur, Daten aus den letzten 30 Tagen 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 Herunterladen 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 die 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. Bei Custom API-, Proxy API- und OData API-Protokolleinträgen ist dies der HTTP-Statuscode (siehe w3.org-Statuscodedefinitionen). Bei Operation-Protokolleinträgen ist dies einer der folgenden:

  • Submitted: Eine Operation wurde in die Harmony-Warteschlange eingereicht, wurde aber noch nicht von einem Agent zur Ausführung akzeptiert.
  • Received: Ein Agent bestätigt den Empfang der Anforderung zur Ausführung einer Operation.
  • Pending: Eine Operation steht in der Warteschlange zur Ausführung auf einem Agent.
  • Running: Ein Agent führt die Operation aus.
  • Cancel Requested: Eine Anforderung zum Abbrechen der Operation wurde gestellt. Operationen können diesen Status anzeigen und nach dem Abbrechen weiterhin ausgeführt werden.
  • Canceled: Die Operation wurde abgebrochen.
  • Success: Die Operation wurde erfolgreich abgeschlossen.
  • Success With Info: Die Operation wurde erfolgreich mit nicht kritischen Problemen abgeschlossen.

  • Success With Warning: Die Operation wurde erfolgreich mit Warnungen abgeschlossen, wie in den Protokollmeldungen angezeigt.

    Tipp

    Eine Warnung extra subelement in den Protokollmeldungen kann in der Regel ignoriert werden. Diese Warnung zeigt an, dass die API-Nutzlast eines Connectors mehr Knoten oder Felder von Daten zurückgegeben hat als in dem Antwortdatenschema definiert.

  • Success With Child Error: Die Operation wurde erfolgreich abgeschlossen, aber eine oder mehrere untergeordnete Operationen sind auf kritische Fehler gestoßen. (Gilt für synchrone Operationen.)

  • Error: Die Operation ist fehlgeschlagen.
  • Soap Fault: Die Operation ist mit einem SOAP-Fehler fehlgeschlagen. (Gilt für Operationen mit Studio-Endpunkten SOAP oder Salesforce oder Design Studio-Endpunkten Web Services oder Salesforce.)

Wenn ein Vorgang Vorgangs-Debug-Logging auf Vorgangsebene aktiviert hat und der Vorgang auf einem Agent der Version 10.48 oder später ausgeführt wurde, zeigt die Spalte Status in der Registerkarte „Debug-Logging" den Status des Vorgangsschritts an:

• Abgeschlossen: Der Vorgangsschritt wurde ausgeführt und ohne Fehler abgeschlossen.
• Fehler: Der Vorgangsschritt wurde ausgeführt, konnte aber aufgrund eines Fehlers nicht abgeschlossen werden.

• Unvollständig: Der Vorgangsschritt wurde nicht ausgeführt oder abgeschlossen. Mögliche Gründe für diesen Status sind, dass der Vorgangsschritt auf die Ausführung wartet oder dass ein Fehler in einem vorherigen Vorgangsschritt die Ausführung des nächsten Schritts verhindert hat.

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

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

• Dauer: Die verstrichene Zeit zwischen Gestartet und Beendet. (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 Custom API-, Proxy API- und OData API-Protokolleinträge ausgefüllt.

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

• Projekt: Der Name des Projekts, in dem der Vorgang ausgeführt wird. Diese Spalte wird nur für Vorgangs-Protokolleinträge ausgefüllt.

• Root Operation Instance GUID: Der global eindeutige Bezeichner (GUID) des Root-Vorgangs (oberster Ebene) des Vorgangs. Dieses Feld ist für Root-Vorgänge leer, und die Spalte ist standardmäßig ausgeblendet. Diese Spalte wird nur für Vorgangs-Protokolleinträge ausgefüllt. Um den Wert zu kopieren, fahren Sie darüber und klicken Sie auf Inhalt kopieren.

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

• Aktionen: Fahren Sie über einen Vorgang, um verfügbare Aktionen anzuzeigen. Aktionen unterscheiden sich je nach Protokolltyp:

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

  • Anzeigen: Öffnen Sie die Protokolldetails.
  • API öffnen: Öffnen Sie die API im API Manager.

  Für Vorgangs-Protokolleinträge:

  • Anzeigen: Öffnen Sie die Protokolldetails.

  • Vorgang abbrechen: Aktiviert für Vorgänge mit dem Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt. Vorgang abbrechen sendet eine Anfrage an den Agent, um den Vorgang zu beenden. Nach dem Klicken wird der Status Abbruch angefordert neben dem Echtzeit-Vorgangsstatus angezeigt.

    Hinweis

    Das Senden einer Abbruchanfrage garantiert nicht, dass der Vorgang abgebrochen wird. Vorgänge mit dem Status Abbruch angefordert können je nach aktuellem Ausführungszustand des Agenten weiterhin ausgeführt werden.

  • Zum Vorgang wechseln: Öffnen Sie das Projekt in Studio und wählen Sie den Vorgang aus. Diese Aktion ist nur für Studio-Vorgänge verfügbar, nicht für Design Studio-Vorgänge.

Wenn mehr als 100 Vorgänge vorhanden sind, werden diese in Seiten mit jeweils etwa 100 Einträgen aufgeteilt. Um verknüpfte Vorgangsketten intakt zu halten, werden alle untergeordneten Vorgänge des letzten auf einer Seite angezeigten übergeordneten Vorgangs auf dieser Seite einbezogen, auch wenn die Gesamtzahl 100 überschreitet. Sie können sich durch die Seiten mit diesen Navigationsschaltflächen am unteren Rand der Tabelle bewegen:

• Vorherige Seite: Gehen Sie zur vorherigen Seite.
• Nächste Seite: Gehen Sie 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 wird am unteren Rand des Fensters mit den folgenden Registerkarten geöffnet, 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-Payload (falls aktiviert).

API-Informationen

Der Abschnitt API-Informationen zeigt die folgenden Details an:

• API: Der Name der API, die den Vorgang 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.

• Quellanwendung: Die Anwendung oder der Browser, der die API-Anfrage gestellt hat.

Aufrufinformationen

Der Abschnitt Aufrufinformationen zeigt die HTTP-Anfrage-Header an, die mit dem API-Aufruf unter einer Bezeichnung Anfrage-Header 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.

Aufrufen-Protokoll

Der Abschnitt Aufrufen-Protokoll zeigt Protokollmeldungen auf Systemebene an, die während der Verarbeitung der API-Anfrage generiert wurden. Klicken Sie auf , um das Protokoll in die Zwischenablage zu kopieren.

API-Payload

Der Abschnitt API-Payload zeigt die Anfrage- und Antwort-Payload-Daten für den API-Aufruf an. Dieser Abschnitt ist sichtbar, wenn eines oder beide der folgenden Elemente in der Registerkarte Einstellungen der API aktiviert sind: Debug-Modus aktivieren bis oder Anfrage- und Antwort-Payloads in Protokollen anzeigen.

Der Abschnitt ist in zwei Bereiche unterteilt:

• Anfragebody: Die Payload, die mit der API-Anfrage gesendet wird.

• Antwortbody: Die Payload, die von der API zurückgegeben wird. Wenn die Antwort-Payload das Anzeigelimit überschreitet, wird sie mit einer Bezeichnung (Gekürzt) angezeigt.

Jeder Bereich bietet die folgenden Steuerelemente:

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

• Kopieren: Kopieren Sie die Payload in die Zwischenablage.

• Herunterladen: Laden Sie die Payload als Datei herunter.

Operationsprotokolleinträge

Wenn ein Operation-Protokolleintrag ausgewählt wird, zeigt die Registerkarte Messages Folgendes an:

• Source Records: Bei Verwendung einer FTP- oder Database-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.

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

• Message: Protokolldetails einschließlich der folgenden:

  • Vom System generierte Meldungen, die anzeigen, 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 Invoke Operation (wenn Raise error if operation fails aktiviert ist) oder der Funktion WriteToOperationLog() generiert werden.

  Protokollmeldungen werden als einzelne Blöcke angezeigt, die nach Meldungstyp gekennzeichnet sind (z. B. Message, Error oder Fatal Error processing 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 gekennzeichnet ist.

• Messages logged in pre-transformation scripts: Meldungen, die während der Ausführung von Pre-Transformation-Scripts generiert werden. Klicken Sie auf , um zu kopieren, oder auf , um herunterzuladen.

Um die Protokollmeldungen eines Vorgangs in der Registerkarte Messages anzuzeigen, muss Folgendes erfüllt sein:

• Sie müssen Mitglied einer Rolle mit mindestens Read-Organisationsberechtigung und View Logs-Umgebungszugriff sein.
• Cloud Logging ist in der Private-Agent-Gruppe aktiviert. (Cloud Logging ist in Cloud-Agent-Gruppen immer aktiviert.) Wenn es deaktiviert ist und Ihre Netzwerkkonfiguration eine direkte Verbindung zum Agent-Host ermöglicht, können Protokollmeldungen sicher angezeigt werden, indem Sie auf den Link View log messages from Agent klicken.

Activity Logs tab

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 Private Agent ausgeführt werden.

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

Aktivitätsprotokoll-Dateien werden nach 14 Tagen automatisch vom Datenbereinigungs-Service des Private Agent gelöscht. Sie können dieses Verhalten im Abschnitt [ResultFiles] der Private-Agent-Datei jitterbit.conf ändern oder die Datenbereinigungs-Service-Regeln ändern.

Aktivitätsprotokoll-Downloads sind für Cloud Agents deaktiviert. Möglicherweise werden Download-Links für Cloud-Agent-Aktivitätsprotokolle angezeigt, aber der Versuch, Protokolle herunterzuladen, generiert eine Fehlermeldung.

Debug Files tab

Wenn das Debug-Logging für private Agents aktiviert ist, enthält dieses Registerkarte einen Link zum Herunterladen von Operation-Debug-Protokolldateien. Die Debug-Dateien werden standardmäßig nach 1 Tag oder gemäß den Bereinigungsregeln eines privaten Agents gelöscht.

Registerkarte „Debug-Logging"

Wenn das Debug-Logging auf Operationsebene aktiviert ist (für Cloud Agents oder für private Agents) und die Operation auf einem Agent der Version 10.48 oder später ausgeführt wurde, zeigt dieses Registerkarte die Details der vollständigen Ausführungshierarchie einer Studio-Operation. Die Operationsprotokollansicht 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 das Operation-Debug-Logging aktiviert ist, kann dieses 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 einbezogen, wenn Show Request & Response Payloads in Logs auch im Registerkarte Einstellungen der API aktiviert ist.

Übergeordnete Operationen (und alle untergeordneten Operationen darunter) werden in aufsteigender Reihenfolge nach Gestartet sortiert. Die Tabelle kann (nur für Operationen auf oberster Ebene) nach Name, Gestartet, Beendet, Dauer oder Status sortiert werden, indem auf die entsprechende Kopfzeile geklickt wird.

Wenn Sie die Operationsprotokollansicht ö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 Liste reduzieren oder Liste erweitern, um alle übergeordneten Operationen zu reduzieren oder zu erweitern.

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

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

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

• Status: Der Status der Operation oder des Operationsschritts. Eine vollständige Liste möglicher Status finden Sie unter Tabelle mit Operationsdetails weiter oben auf dieser Seite.

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

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

    • Zur API wechseln: Öffnen Sie die Detailseite der entsprechenden API in API Manager, wobei die Schublade automatisch geöffnet wird.

  • 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 Klicken wird der Status Abbruch angefordert neben dem Echtzeit-Operationsstatus angezeigt.

• Zum Vorgang wechseln: Öffnet das Projekt in Studio und wählt den Vorgang aus.

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

• Spalten filtern: Klicken, um eine Schublade zu öffnen, in der man die Spalten neu anordnen oder ihre Sichtbarkeit im Vorgangslisten-Panel anpassen kann:

  

  • Alle anzeigen: Macht alle Spalten sichtbar.

  • Verschieben: Ziehen und ablegen, um die Position der Spalte relativ zu anderen zu ändern.

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

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

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

• Vorgansprotokoll: Um ein Protokoll für einen einzelnen Vorgang anzuzeigen oder auszublenden, klickt man einen Vorgang aus der Liste.

  • Protokollmeldungen: Protokollmeldungen enthalten die Protokolldetails für den ausgewählten Vorgang. Ob Protokollmeldungen 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 Protokollmeldungen selbst angezeigt werden, werden nicht in die lokale Browserzeit konvertiert, sondern im ursprünglichen Format aus der Quelle der Protokollmeldung gemeldet.

  • Kopieren: Kopiert die Protokolldaten in die Zwischenablage.

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

Komponenteneingabe- und -ausgabedaten

Komponenteneingabe- und -ausgabedaten werden generiert, wenn ein Vorgang die Vorgangs-Debug-Protokollierung auf Vorgangsebene aktiviert hat (für Cloud-Agenten oder für private Agenten) und der Vorgang 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 Vorgangsschritts im Vorgangslisten-Panel angezeigt.

Symbole für Aktivitäten und Transformationen, die als Vorgangsschritte verwendet werden, werden angezeigt. Man kann 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: Durchsucht 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-Anfrage- und Antwortwortdaten

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

API-Informationen

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

• API: Der Name der API, die den Vorgang 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.

• 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 das -Kopiersymbol, 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 Private 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, die/der die API-Anfrage gestellt hat.

Aufrufinformationen

Das Operationsprotokoll zeigt einen Bereich Aufrufinformationen mit den HTTP-Anfrage-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 Bereich Aufrufsprotokoll mit detaillierten Trace-Informationen zur API-Anfrageverarbeitung 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 Anfrageverarbeitung Probleme aufgetreten sind.