Zum Inhalt springen

Runtime-Seite in der Jitterbit Management Console

Übersicht

Zweck Operationsprotokolle anzeigen
Ort Harmony-Portalmenü > Management Console > Runtime
Seitenzugriff Benutzer mit der Berechtigung Lesen Rollenberechtigung
Umgebungszugriff Benutzer mit Protokolle anzeigen Umgebungszugriffsebenen

Einführung

Die Seite Runtime ist eine Tabelle von Operationsprotokollen. Wenn eine Operation ausgeführt wird, wird ein Operationsprotokoll generiert. Ein Operationsprotokoll enthält Informationen über den Zeitpunkt und Ort der Operationsausführung, den Operationsstatus, die Anzahl der verarbeiteten Quell- und Zieldatensätze und alle Protokollmeldungen. Ob detaillierte Protokollmeldungen angezeigt werden, hängt von den Berechtigungen und Zugriffsebenen sowie davon ab, ob Cloud-Protokollierung aktiviert ist.

Runtime-Seite

Hinweis

Harmony speichert Operationsprotokolle 30 Tage lang.

Wichtig

Operationen, die durch eine API Manager benutzerdefinierte API oder OData API ausgelöst werden, verfügen über zusätzliche Protokollierung, die aktiviert werden kann. Weitere Informationen finden Sie unter API-Anfrage- und Antwortdaten.

Statuswerte

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

Symbol Status Beschreibung Hinweise
Submitted (Eingereicht) Eine Operation wurde in die Harmony-Warteschlange eingereicht, wurde aber noch nicht von einem Agent zur Ausführung akzeptiert. Operationen können durch einen Operationsplan, manuelle Ausführung, die Funktion RunOperation oder ein beliebiges Tool (einschließlich JitterbitUtils), das eine API Manager-API aufruft, eingereicht werden.
Received (Empfangen) Ein Agent bestätigt den Empfang der Anfrage zur Ausführung einer Operation. —
Pending (Ausstehend) Eine Operation ist in der Warteschlange, um auf einem Agent ausgeführt zu werden. —
Running (Wird ausgeführt) Ein Agent führt die Operation aus. —
Cancel Requested (Abbruch angefordert) Eine Anfrage zum Abbrechen der Operation wurde gestellt. Operationen können diesen Status anzeigen und dennoch nach dem Abbrechen weiter ausgeführt werden. Sie können auch einen Abbruch von der Design-Canvas einer Operation, aus der Operationsprotokollanzeige von Studio oder unter Verwendung der Funktionen GetOperationQueue und CancelOperation anfordern.
Canceled (Abgebrochen) Die Operation wurde abgebrochen. —
Success (Erfolg) Die Operation wurde erfolgreich abgeschlossen. —
Success with Info (Erfolg mit Info) Die Operation wurde erfolgreich mit nicht schwerwiegenden Problemen abgeschlossen. —
Success with Warning (Erfolg mit Warnung) Die Operation wurde erfolgreich mit Warnungen abgeschlossen, wie in den Protokollmeldungen angezeigt. Eine Warnung extra subelement in den Protokollmeldungen kann allgemein ignoriert werden. Diese Warnung zeigt an, dass die API-Nutzlast eines Connectors mehr Knoten oder Felder von Daten zurückgegeben hat, als im Reaktionsdatenschema definiert.
Success with Child Error (Erfolg mit untergeordnetem Fehler) Die Operation wurde erfolgreich abgeschlossen, aber eine oder mehrere untergeordnete Operationen litten unter schwerwiegenden Fehlern. Gilt nur für synchrone Operationen.
Error (Fehler) Die Operation ist fehlgeschlagen. Mögliche Ursachen sind ein schwerwiegender Fehler beim Schreiben in das Zielsystem, ein schwerwiegender Validierungsfehler in der Transformation oder die Transformationslogik, die die Funktion RaiseError auslöst.
Soap Fault (SOAP-Fehler) Die Operation ist mit einem SOAP-Fehler fehlgeschlagen. Gilt für Operationen, die den SOAP-Connector, Salesforce, Salesforce Service Cloud, ServiceMax, Workday von Studio oder die Web-Services- oder Salesforce-Endpunkte von Design Studio verwenden.
— Delayed Status (Verzögerter Status) Harmony konnte das Operationsprotokoll nicht vom Agent abrufen. Harmony versucht bis zu sechsmal mit einem 10-Sekunden-Timeout zwischen den Versuchen. Aktualisieren Sie oder überprüfen Sie später erneut. Sie können nicht nach diesem Status filtern, aber verzögerte Protokolleinträge können trotzdem in den Ergebnissen angezeigt werden.

Runtime-Seite – Steuerelemente

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

Suchleiste

Eine Abfrage besteht aus einem oder mehreren Schlüssel-Wert-Paaren. Mehrere Bedingungen werden durch Semikolons getrennt. Ein Term hat die Form <key><operator><value>. Bei den Schlüsseln operation, project, environment, agent, status und apiServiceUrl können Werte Platzhalter (% oder *) enthalten, um beliebige Zeichenfolgen zu vergleichen. Der Platzhaltervergleich ist an den Anfang des Werts gebunden, daher liefern nur Suchvorgänge, die mit dem Anfang des Textes übereinstimmen, Ergebnisse: Verwende value% oder value*, um Werte zu vergleichen, die mit dem Text beginnen. Ein führender Platzhalter erweitert die Übereinstimmung nicht: %value% und *value* werden beide als value% behandelt (beginnt mit), 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) stimmt weiterhin überein. Der Schlüssel logType akzeptiert auch Platzhalter, aber nur in der Mitte oder am Ende des Werts (z. B. Oper% oder Op%on).

Hinweis

Für genaue Ergebnisse bei Verwendung des Ungleich-Operators (!=) deaktiviere den Toggle Execution tree view.

Gib eine gültige Abfragespezifikation in die Suchleiste ein und drücke die Eingabetaste:

Suchleiste

Wenn der Toggle Execution tree view aktiviert ist, gibt eine Abfrage Ergebnisse für die vollständige Ausführungskette aller übereinstimmenden Einträge zurück: Bei einer operation-Schlüsselabfrage 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 Suchzeichenfolge wird in den Ergebnissen blau hervorgehoben. Wenn der Toggle Execution tree view deaktiviert ist, werden nur die Einträge zurückgegeben, die direkt der Abfrage entsprechen.

Die folgende Tabelle zeigt die verfügbaren Abfragebedingungskomponenten:

Schlüssel Spalte Zulässige
Operatoren
Wert Anmerkungen
operation Operation =, != Operationsname
project Projekt =, != Projektname
environment Umgebung =, != Umgebungsname
agent Agent =, != Agentname
status Status =, != Statusname oder HTTP-Statuscode Bei Operation-Protokolleinträgen der Statusname, der in der Spalte Status der Operationsdetails-Tabelle angezeigt wird. Bei Custom API-, Proxy API- und OData API-Protokolleinträgen ein HTTP-Statuscode von 100 bis 599. Ein Wert, der keinem dieser Formate entspricht, gibt einen Validierungsfehler zurück.
logType Protokolltyp =, != Protokolltypname Einer der Werte Operation, Custom API, Proxy API oder OData API, die den Werten in der Spalte Log Type entsprechen.
started Gestartet <= Datum/Uhrzeit Datum/Uhrzeit: month/day/year-Datumsformat mit optionaler hour:minute:second-Uhrzeit in AM/PM-Form. Nur Datum: MM/DD/YYYY. Datum und Uhrzeit (AM): MM/DD/YYYY HH:MM:SS AM. Datum und Uhrzeit (PM): MM/DD/YYYY HH:MM:SS PM.
>=
finished Beendet <= Datum/Uhrzeit
>=
rootOperationInstanceGuid Root Operation Instance GUID = GUID der Wurzeloperation
apiServiceUrl API Service URL =, != API-Service-URL Die vollständige API-Service-URL für Einträge, die durch einen API-Aufruf ausgelöst wurden. Gib die vollständige URL einschließlich des Schemas https:// ein.

Abfragebeispiele

Die folgenden sind Beispielabfragebegriffe:

Abfragebegriff Beschreibung
operation=New Delete; Zeigt die Operation „New Delete" an.
operation=New%; Zeigt Operationsprotokolle für Operationen an, deren Namen mit „New" beginnen.
operation!=New%; Zeigt Operationsprotokolle für Operationen an, deren Namen nicht mit „New" beginnen.
project=SFDC-SAP; Zeigt Operationsprotokolle für Operationen im Projekt „SFDC-SAP" an.
project=SFDC%; Zeigt Operationsprotokolle für Operationen in beliebigen Projekten an, deren Namen mit „SFDC" beginnen.
project!=SFDC-SAP; Zeigt Operationsprotokolle für Operationen an, die nicht im Projekt „SFDC-SAP" enthalten sind.
environment=DEnv; Zeigt Operationsprotokolle für Operationen an, die in der Umgebung „DEnv" bereitgestellt wurden.
environment=DE%; Zeigt Operationsprotokolle für Operationen an, die in Umgebungen mit Namen bereitgestellt wurden, die mit „DE" beginnen.
environment!=DEnv; Zeigt Operationsprotokolle für Operationen an, die nicht in der Umgebung „DEnv" bereitgestellt wurden.
agent=Windows%; Zeigt Operationsprotokolle für Operationen an, die auf Agenten mit Namen ausgeführt werden, die mit „Windows" beginnen.
agent!=Windows%; Zeigt Operationsprotokolle für Operationen an, die auf Agenten mit Namen ausgeführt werden, die nicht mit „Windows" beginnen.
status=success; Zeigt Operationsprotokolle für Operationen mit dem Status „SUCCESS" an.
status!=success; Zeigt Operationsprotokolle für Operationen mit einem anderen Status als „SUCCESS" an.
status=200; Zeigt API-Protokolleinträge mit HTTP-Statuscode 200 an.
status!=200; Zeigt API-Protokolleinträge mit einem HTTP-Statuscode ungleich 200 an.
logType=Operation; Zeigt Protokolleinträge mit dem Protokolltyp „Operation" an.
logType!=Operation; Zeigt Protokolleinträge mit einem Protokolltyp ungleich „Operation" an.
logType=Oper%; Zeigt Protokolleinträge an, deren Protokolltyp mit „Oper" beginnt.
started>=9/12/2024; Zeigt Operationsprotokolle für Operationen an, die am oder nach dem 12.9.2024 gestartet wurden.
started>=9/12/2024 11:59:00 AM; Zeigt Operationsprotokolle für Operationen an, die am oder nach 11:59 Uhr am Morgen des 12.9.2024 gestartet wurden.
finished<=10/04/2024; Zeigt Operationsprotokolle für Operationen an, die am oder vor dem 4.10.2024 zuletzt aktiv waren.
finished>=10/04/2024 01:00:00 PM; Zeigt Operationsprotokolle für Operationen an, die am oder nach dem 4.10.2024 um 13:00 Uhr zuletzt aktiv waren.
message=1201 alarm; Zeigt Operationsprotokolle für Operationen an, die die Nachrichtenzeichenkette „1201 alarm" enthalten.
rootOperationInstanceGuid=0f04b6f6-4129-45dd-8388-abd19fe6a4f7; Zeigt Operationsprotokolle für Operationen an, die untergeordnete Elemente der Root-Operation mit der angezeigten GUID sind.
apiServiceUrl=https://acme2.jitterbit.net/defaultUrlPrefix%; Zeigt Protokolleinträge für API-Aufrufe an, deren API-Service-URL mit „https://acme2.jitterbit.net/defaultUrlPrefix" beginnt.
apiServiceUrl=https://acme2.jitterbit.net/defaultUrlPrefix/v1/customers; Zeigt Protokolleinträge für den API-Aufruf mit der exakt angezeigten API-Service-URL an.

Hinweis

Daten werden in der Zeitzone deines Browsers angegeben und angezeigt.

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:

    Abfrageformular

    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 Abfragetermin gefolgt von einem Semikolon ein.
    • Spalten: Wähle die Spalten aus, die in den Suchergebnissen angezeigt werden sollen.

      Abfrageformular

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

    Abfragen speichern

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

  • Um eine gespeicherte Abfrage zu verwenden, klicke auf Gespeicherte Abfragen und klicke 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:

    Abfrage bearbeiten

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

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

Zeitperioden-Auswahl

Die Seite Runtime gibt Datensätze innerhalb des in dem Zeitbereichsfeld festgelegten Zeitraums zurück, das Datensätze nach Startzeit filtert:

Zeitperioden-Auswahl

Klicke auf das Zeitbereichsfeld, um ein Dialogfeld mit zwei Registerkarten zu öffnen: Relativ und Absolut.

Registerkarte „Relativ"

Die Registerkarte Relativ bietet vordefinierte Zeitbereiche und eine benutzerdefinierte Auswahl für relative Zeiträume:

Registerkarte „Relativ"

Wähle einen der vordefinierten Zeitbereiche aus:

  • Letzte 1 Stunde: Zeigt Vorgangsprotokolle der letzten Stunde an.

  • Letzte 24 Stunden: (Standard.) Zeigt Vorgangsprotokolle der letzten 24 Stunden an.

  • Letzte 7 Tage: Zeigt Vorgangsprotokolle der letzten 7 Tage an.

  • Letzte 30 Tage: Zeigt Vorgangsprotokolle der letzten 30 Tage an.

Um einen benutzerdefinierten relativen Zeitraum zu erstellen, verwende die Steuerelemente am unteren Rand des Dialogfelds:

  • Zahlenfeld: Gib die Anzahl der Zeiteinheiten ein (z. B. 1, 7, 30).

  • Dropdown-Liste „Einheit": Wähle die Zeiteinheit aus Minuten, Stunden, Tage, Wochen oder Monate.

  • Abbrechen: Schließe das Dialogfeld, ohne Änderungen zu übernehmen.

  • Anwenden: Wende den ausgewählten Zeitbereich an und schließe das Dialogfeld.

Registerkarte „Absolut"

Auf der Registerkarte Absolut kannst du einen bestimmten Datums- und Zeitbereich innerhalb der letzten 30 Tage auswählen. Daten außerhalb dieses Bereichs können nicht ausgewählt werden:

Registerkarte „Absolut"

Konfiguriere den Datums- und Zeitbereich mithilfe der folgenden Steuerelemente:

  • Feld „Startzeit": Zeigt die Startzeit für den Bereich an. Klicke auf , um zu löschen, oder klicke auf , um die Uhrzeit anzupassen.

  • Feld „Endzeit": Zeigt die Endzeit für den Bereich an. Klicke auf , um zu löschen, oder klicke auf , um die Uhrzeit anzupassen.

  • Kalenderauswahl: Verwende den Kalender, um Start- und Enddaten auszuwählen. Navigiere zwischen Monaten mit den einfachen Pfeilen oder zwischen Jahren mit den doppelten Pfeilen.

  • Abbrechen: Dialog schließen, ohne Änderungen anzuwenden.

  • Anwenden: Ausgewählten Datums- und Zeitbereich anwenden und Dialog schließen.

Zusätzliche Zeitraumsteuerungen

Beim Anwenden eines Zeitbereichs wird ein entsprechender Started Abfragebegriff in der Suchleiste gesetzt (z. B. started>=10/01/2026 12:00:00 AM;started<=10/06/2026 03:00:00 PM;). Sie können weiterhin unabhängig nach Finished-Zeit filtern, indem Sie einen finished-Abfragebegriff direkt in die Suchleiste eingeben.

  • Klicken Sie auf neben dem Zeitbereichsfeld, um es auf den Standardwert Letzte 24 Stunden zurückzusetzen. Dies entfernt die bereits in der Suchleiste angewendete Started-Bedingung nicht; um einen angewendeten Zeitfilter zu entfernen, klicken Sie auf in der Suchleiste.

  • Klicken Sie auf das Kalendersymbol neben dem Zeitbereichsfeld, um den Dialog erneut zu öffnen.

Der ausgewählte Zeitbereich wird beibehalten, wenn Sie zwischen Tabellen- und Kartenlayouts für die Ergebnisse wechseln.

Als CSV herunterladen

Klicken Sie auf Als CSV herunterladen, um den Dialog Logs herunterladen zu öffnen. Der Export weist folgende Eigenschaften auf:

  • Umfang: Der Export verwendet die angewendete Suchabfrage, Filter und den Zeitbereich und gibt alle passenden Protokolleinträge wieder. Dies entspricht der vollständigen Ergebnismenge, die über alle Seiten der Tabelle hinweg angezeigt wird.
  • Hierarchie: Der Export behält die Eltern-Kind-Hierarchie von Operationsketten bei und hält verwandte Einträge zusammenhängend.
  • Reihenfolge: Datensätze sind nach Started-Zeit des übergeordneten Elements (absteigend) sortiert, untergeordnete Datensätze nach Ausführungsreihenfolge (aufsteigend).
  • Zeitzone: Die Started- und Finished-Zeitstempel verwenden die lokale Zeitzone Ihres Browsers.
  • Verpackung: Wenn sich der Export über mehrere Dateien erstreckt, werden alle Dateien in einem einzigen ZIP-Archiv zum Herunterladen gepackt.

Der Dialog enthält die folgende Option:

  • Nachrichten einschließen: Wählen Sie aus, um vollständige Protokollnachrichten in den Export einzubeziehen. Diese Option ist standardmäßig deaktiviert. Das Einbeziehen von Nachrichten kann die Dateigröße und Generierungszeit erheblich erhöhen.

Klicken Sie auf Herunterladen, um den Export zu starten, oder auf Abbrechen, um ihn zu verwerfen.

Aktualisieren

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

Einstellungen

Wählen Sie ein automatisches Aktualisierungsintervall, eines der folgenden: Nie (Standard), 1 Minute, 5 Minuten, 15 Minuten oder 30 Minuten, und klicken Sie dann auf die Schaltfläche Speichern.

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

Spalten filtern

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

Spalten filtern

Die Schublade enthält die folgenden Steuerungen:

  • Alle anzeigen: Alle Spalten sichtbar machen.
  • Verschieben: Per Drag-and-Drop die Position der Spalte relativ zu anderen ändern.
  • Ausblenden: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.
  • Anzeigen: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.
  • Speichern: Spalten speichern.
  • Abbrechen: Schublade schließen, 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 des Vorgangs, der mit dem Protokolleintrag verknüpft ist. Für Operationseinträge mit untergeordneten Elementen klicken Sie auf das Symbol Erweitern, um die gesamte Kette anzuzeigen. Klicken Sie auf das Symbol Minimieren, um einen Vorgang und seine untergeordneten Elemente zu reduzieren. (Gilt für alle Protokolltypen.)

  • Protokolltyp: Der Typ des Protokolleintrags: Custom API, Proxy API oder OData API für von einem API-Aufruf ausgelöste Operationen oder Operation für direkt ausgeführte Operationen. (Gilt für alle Protokolltypen.)

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

  • Status: Der Status des Protokolleintrags. Siehe Statuswerte.

  • Gestartet: Der Zeitpunkt, an dem die Ausführung des Vorgangs angefordert wurde. (Gilt für alle Protokolltypen.)

  • Beendet: Der Zeitpunkt, an 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-Stamms, 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.

  • Projekt: Der Name des Projekts, in dem der Vorgang 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) des Stammvorgangs (auf oberster Ebene) des Vorgangs. Dieses Feld ist für Stammvorgänge 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, fahre mit der Maus darüber und klicke dann auf Inhalt kopieren.

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

  • Aktionen: Fahre mit der Maus auf einen Vorgang, 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:

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

    Für Protokolleinträge vom Typ Operation:

    • Anzeigen: Öffne die Protokolldetails.
    • Vorgang abbrechen: Aktiviert für Vorgänge mit dem Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt. Vorgang abbrechen sendet eine Anforderung an den Agent, um den Vorgang zu beenden. Nachdem die Anforderung geklickt wurde, wird der Status Abbruch angefordert neben dem Status des Vorgangs in Echtzeit angezeigt.

      Hinweis

      Das Senden einer Abbruchanforderung 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: Öffne das Projekt in Studio und wähle 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 auf Seiten von jeweils etwa 100 aufgeteilt. Um verknüpfte Vorgangsketten intakt zu halten, werden alle untergeordneten Vorgänge des letzten auf einer Seite angezeigten übergeordneten Vorgangs auf dieser Seite eingefügt, auch wenn die Summe 100 übersteigt. Verwende diese Navigationsschaltflächen am unteren Ende der Tabelle, um zwischen Seiten zu navigieren:

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

Protokolleintragsdetails

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

Registerkarte „Meldungen"

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

API-Protokolleinträge

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

API-Informationen

Der Bereich 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 einem neuen Tab im API Manager zu öffnen.

  • Version: Die Versionsnummer der API.

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

  • 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: Eine eindeutige Kennung für die API-Anfrage. Sie können diese ID verwenden, um Logs ü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 Domainnamen 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, der die API-Anfrage gestellt hat.

Aufrufuformationen

Der Bereich Aufrufuformationen zeigt die HTTP-Request-Header, die mit dem API-Aufruf unter einer Bezeichnung Request Headers gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, wie 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.

Aufrufprotokoll

Der Bereich Aufrufprotokoll zeigt Systemmeldungen 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 Bereich API-Payload zeigt die Request- und Response-Payload-Daten für den API-Aufruf an. Dieser Bereich ist sichtbar, wenn eine oder beide der folgenden Optionen auf der Registerkarte „Einstellungen" der API aktiviert sind: Debugmodus aktiviert bis oder Request & Response Payloads in Logs anzeigen.

Der Bereich ist in zwei Bereiche aufgeteilt:

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

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

Jeder Bereich bietet folgende Steuerelemente:

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

  • Kopieren: Kopieren Sie die Payload in die Zwischenablage.

  • Herunterladen: Laden Sie die Payload als Datei herunter.

Vorgangsprotokolleinträge

Registerkarte „Meldungen"

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

  • Quelleinträge: Bei Verwendung einer FTP- oder Datenbank-Aktivität als Quelle wird die Anzahl der aus dem Quellsystem gelesenen Einträge angezeigt. Bei anderen Konnektoren wird die Anzahl unabhängig von der Anzahl der Quelleingaben mit 0 angezeigt.

  • Zieleinträge: Bei Verwendung einer FTP- oder Datenbank-Aktivität als Ziel wird die Anzahl der ins Zielsystem geschriebenen Einträge angezeigt. Bei anderen Konnektoren wird die Anzahl unabhängig von der Anzahl der Zieleinträge mit 0 angezeigt.

  • Nachricht: Protokolldetails einschließlich der folgenden:

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

    Protokollmeldungen werden als einzelne Blöcke angezeigt, die nach Meldungstyp gekennzeichnet sind (beispielsweise Nachricht, Fehler oder Fehler beim Verarbeiten des Vorgangs). Jeder Block bietet zum Kopieren oder zum Herunterladen des Inhalts.

    Hinweis

    • Datums- und Uhrzeitangaben in Protokollmeldungen werden in ihrem ursprünglichen Format aus der Quelle angezeigt und nicht in die lokale Browserzeit umgerechnet.
    • Protokollmeldungen, die ca. 100 KB groß sind (ca. 99.000 Zeichen), werden gekürzt, was durch message truncated am Ende des Protokolls gekennzeichnet ist.
  • Meldungen, die in Vorverarbeitungsskripten protokolliert sind: Meldungen, die während der Ausführung des Vorverarbeitungsskripts generiert werden. Klicken Sie auf , um zu kopieren, oder auf , um herunterzuladen.

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

  • Sie müssen Mitglied einer Rolle mit mindestens der Organisationsberechtigung Lesen und dem Umgebungszugriff Protokolle anzeigen sein.
  • Das Cloud-Protokollieren ist in der Private-Agent-Gruppe aktiviert. (Cloud-Protokollierung ist in Cloud-Agent-Gruppen immer aktiviert.) Wenn das Protokollieren deaktiviert ist und die Netzwerkkonfiguration eine direkte Verbindung zum Agent-Host zulässt, können Protokollmeldungen sicher angezeigt werden, indem Sie auf den Link Protokollmeldungen vom Agent anzeigen klicken.

Registerkarte „Activity Logs"

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. Zum Herunterladen klicken Sie auf deren Link.

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

Activity-Log-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.

Registerkarte „Debug Files"

Debug files tab

Wenn das Debug-Protokollieren für Private Agents 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 Private Agent konfiguriert entfernt.

Hinweis

Diese Registerkarte wird nicht für Vorgänge angezeigt, die auf Cloud Agents ausgeführt werden.

Registerkarte „Debug Logging"

Wenn das Debug-Protokollieren auf der Vorgangsebene aktiviert ist (für Cloud Agents oder für Private Agents) und der Vorgang auf einem Agent Version 10.48 oder später ausgeführt wurde, zeigt diese Registerkarte die Details der vollständigen Ausführungshierarchie eines Studio-Vorgangs. Die Vorgangsprotokollanzeige zeigt eine geteilte Ansicht mit Vorgangsprotokollen im linken Bereich und detaillierten Protokollinformationen für den ausgewählten Vorgang im rechten Bereich. Die Ansicht verwendet die ausgewählten Tabellensteuerelemente, um Ergebnisse zu filtern. Wenn Vorgänge mit Vorgangsaktionen oder der Funktion RunOperation verknüpft sind, werden diese Vorgänge unter dem übergeordneten Vorgang aufgelistet.

Wenn das Operationsdebug-Protokoll aktiviert ist, kann dieser Tab auch Komponenten-Ein- und Ausgabedaten und API-Request- und Response-Daten anzeigen (wenn die Operation durch eine API Manager API ausgelöst wird). Die Request- und Response-Payload werden nur eingebunden, wenn Show Request & Response Payloads in Logs auch in der 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 man auf die entsprechende Kopfzeile klickt.

Registerkarte Debug-Protokoll

Wenn man die Operationsprotokollansicht öffnet, 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 Caret-Zeichen, mit denen zusätzliche Zeilen erweitert oder reduziert werden können, werden auf übergeordneten Operationen und auf Operationen angezeigt, für die Komponenten-Ein- und Ausgabedaten verfügbar sind:

    • Übergeordnete Operationen: Wenn eine übergeordnete Operation erweitert wird, erscheinen zusätzliche Zeilen für ihre untergeordneten Operationen in der Reihenfolge ihrer Ausführung. Standardmäßig sind alle übergeordneten Operationen erweitert. Mit den Symbolen Liste reduzieren oder Liste erweitern können alle übergeordneten Operationen reduziert oder erweitert werden.
  • Gestartet: Datum und Uhrzeit, zu denen die Operation oder der Operationsschritt gestartet wurde, angezeigt als lokale Browserzeit.

  • Beendet: Datum und 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 Protokolleintrag 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 wegen 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 in einem vorherigen Operationsschritt ein Fehler aufgetreten ist, der die Ausführung des nächsten Schritts verhindert.
  • Aktionen: Diese Aktionen sind nicht für Operationsschritte verfügbar und unterscheiden sich je nach Zeilentyp:

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

      • Zur API: Öffnet die Detailseite der entsprechenden API in 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 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ührungsstatus des Agenten noch ausgeführt werden.

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

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

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

filter columns

  • Alle anzeigen: Macht alle Spalten sichtbar.

  • 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 Vergrößerungs-Leiste einer Spalte, um sie zu vergrößern.

  • Operationsprotokoll: Um ein Protokoll für eine einzelne Operation anzuzeigen oder auszublenden, wählen Sie eine Operation aus der Liste.

    • Protokollmeldungen: Protokollmeldungen enthalten die Protokolldetails für die ausgewählte Operation. Ob Protokollmeldungen angezeigt werden, hängt von den Berechtigungen und Zugriffsebenen 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 in ihrem Originalformat aus der Quelle der Protokollmeldung angegeben.

    • 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 für eine Operation das Operationsdebugging auf Operationsebene aktiviert ist (für Cloud-Agenten oder für private Agenten) und die Operation auf einem Agent der Version 10.48 oder höher ausgeführt wurde.

Hinweis

Die Generierung von Komponenteneingabe- und -ausgabedaten ist von der Agentengruppeneinstellung Cloud-Protokollierung aktiviert nicht beeinflusst. Komponenteneingabe- und -ausgabedaten werden in der Harmony Cloud protokolliert, auch wenn die Cloud-Protokollierung deaktiviert ist.

Um die Generierung von Komponenteneingabe- und -ausgabedaten in einer privaten Agentgruppe zu deaktivieren, legen Sie in der Konfigurationsdatei des privaten Agenten im Abschnitt [VerboseLogging] den Wert verbose.logging.enable=false fest.

Warnung

Wenn Komponenteneingabe- und -ausgabedaten generiert werden, werden alle Anfrage- und Antwortdaten für diese Operation in der Harmony Cloud protokolliert und verbleiben dort 30 Tage lang. Beachten Sie, dass personenbezogene Daten (PII) und vertrauliche Daten wie in einer Anfrage bereitgestellte Anmeldedaten als Klartext in den Eingabe- und Ausgabedaten in den Harmony Cloud-Protokollen sichtbar sind.

Wenn Komponenteneingabe- und -ausgabedaten vorhanden sind, wird eine grafische Darstellung der Operation oder des Operationsschritts im Operationslistenbereich angezeigt.

Symbole für Aktivitäten und Transformationen, die als Operationsschritte verwendet werden, werden angezeigt. Sie können auf einen Operationsschritt klicken, um die Komponenteneingabe- und -ausgabedaten für diesen einzelnen Operationsschritt 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.

log table operation steps header

  • Suche: Sucht 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 Operationsschritts gefolgt von _input oder _output benannt.

API-Anfrage- und Antwortdaten

Neue Benutzeroberfläche erforderlich

Die Funktion für API-Anfrage- und Antwortdaten ist nur für Organisationen verfügbar, die auf die neuen Schnittstellen Analytics und API-Protokolle aktualisiert wurden. Dieses Upgrade wird schrittweise ausgerollt. Wenn Sie sich für frühzeitigen Zugriff interessieren, wenden Sie sich an den Jitterbit-Support.

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

Aktivierte Einstellungen Erfolgreiche Ausführungen in Studio-Operationsprotokollen Unbearbeitete Anfrage-/Antwortdaten im Anrufprotokoll Anfrage-/Antwortnutzlasten
Keine (Standard)
Ausführliche Protokollierung (benutzerdefinierte API, OData-API oder Proxy-API Einstellungen)
Debug-Modus aktivieren bis (benutzerdefinierte API, OData-API oder Proxy-API Einstellungen)
Operationsdebug-Protokollierung (Cloud-Agents oder Private Agents)

Hinweis

Um alle drei Datentypen gleichzeitig zu erfassen, verwenden Sie Debug-Modus aktivieren bis oder kombinieren Sie Operationsdebug-Protokollierung mit Anfrage- und Antwortnutzlasten in Protokollen anzeigen und Ausführliche Protokollierung.

api information

API-Informationen

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

api information

  • 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:

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

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

  • Quell-IP: Die IP-Adresse der Client-Anwendung oder des Servers, der die API-Anfrage gesendet hat.

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

  • API-Service-URL: Die vollständige URL für den Aufruf der API, einschließlich der Basis-URL, des Service Root, der Version und eventueller Pfadparameter. Dies ist die vollständige API-Service-URL, wie sie vom Client verwendet wird.

  • Quellobjekt: Die Anwendung oder der Browser, die bzw. der die API-Anfrage gesendet hat.

Aufrufinformationen

Das Operationsprotokoll zeigt einen Abschnitt Aufrufinformationen mit den HTTP-Anfrage-Header, 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 Anmeldeinformationen oder Sitzungsdaten enthalten, werden maskiert, wie unter Maskierte Header beschrieben.

Aufrufen Sie das Protokoll

Das Operationsprotokoll zeigt auch einen Bereich Aufrufen Sie das Protokoll mit detaillierten Trace-Informationen zur API-Anfrageverarbeitung an. Diese Informationen können zur Fehlerbehebung von API-Gateway-Problemen, Timeout-Problemen oder zum Verständnis des internen Verarbeitungsflusses der API verwendet werden. Der spezifische Inhalt des Aufrufen Sie das Protokoll variiert je nach API-Konfiguration, Gateway-Einstellungen und ob während der Anfrageverarbeitung Probleme aufgetreten sind.