API-Protokollseite im Jitterbit API Manager
Einführung
Die API-Protokoll-Seite im API Manager zeigt eine Tabelle aller API-Verarbeitungsprotokolle und Debug-Protokolle (wenn das Debug-Logging aktiviert ist). Protokolle werden für benutzerdefinierte, OData- und Proxy-APIs erstellt, wenn sie über das Cloud-API-Gateway oder ein privates API-Gateway aufgerufen werden. Wenn eine API eine Studio-Operation auslöst, erscheinen die resultierenden Betriebsprotokolle zusätzlich zur Studio- Betriebsprotokollansicht und der Management Console Laufzeit Seite auch auf der API-Protokoll-Seite.
Wichtig
Harmony speichert Protokolldaten für API-Protokolle, API-Debug-Protokolle und API-Detailprotokolle für 30 Tage ab dem Datum, an dem die API verwendet wird.
Hinweis
Für Details darüber, welche Informationen protokolliert werden, wenn eine API eine Operation auslöst, siehe API-Anforderungs- und Antwortdaten.
API-Aufrufe erzeugen vier Arten von Protokollen:
-
API-Protokolle: Der API Manager erstellt automatisch API-Protokolle auf der API-Protokoll-Seite für jeden API-Manager-API-Aufruf. API-Protokolle enthalten Informationen über den API-Aufruf, einschließlich des Zeitstempels der API-Anforderung, des HTTP-Statuscodes, der Anforderungs-ID, der Anforderungsmethode, der Anforderungs-URI, der Antwortzeit, der Quell-IP der aufrufenden Anwendung, der Quellanwendung und aller Protokollnachrichten.
-
API-Debug-Protokolle: Detaillierte Verfolgungsinformationen, die jeden Schritt der Anforderungsverarbeitung über die Dienst-URL einer API-Manager-API anzeigen. Das Debug-Logging für APIs ist standardmäßig nicht aktiviert und muss für eine einzelne API-Manager-API aktiviert werden. Um das Debug-Logging zu aktivieren, siehe die Einstellungen-Registerkarte in der benutzerdefinierten API-Konfiguration, OData-API-Konfiguration oder Proxy-API-Konfiguration.
-
API-Verbose-Protokolle: Anforderungs- und Antwortpayload-Daten, die über die Dienst-URL einer API-Manager-API empfangen oder gesendet werden. API-Verbose-Protokollierung ist standardmäßig nicht aktiviert und muss für jede einzelne API-Manager-API aktiviert werden. Um die verbose Protokollierung zu aktivieren, siehe die Einstellungen-Registerkarte in der benutzerdefinierten API-Konfiguration, OData-API-Konfiguration oder Proxy-API-Konfiguration.
-
Protokolle der privaten Agentenoperationen: Informationen über API-Aufrufe, die in die
jitterbit.log-Datei des privaten Agenten imlog-Verzeichnis geschrieben werden. Diese Protokolle enthalten den Beginn eines API-Aufrufs und die vergangene Zeit. Protokolle der privaten Agentenoperationen werden in der Konfigurationsdatei des privaten Agenten konfiguriert.
Um zusätzliche Protokollinformationen für OData-APIs hinzuzufügen, einschließlich SQL-Daten, die an die Datenbank gesendet werden, bearbeite die Konfigurationsdatei des privaten Agenten und setze DebugJDML auf true.
Zugriff auf die API-Protokollseite
Um auf die API-Protokoll-Seite zuzugreifen, verwende das Harmony-Portal-Menü, um API-Manager > API-Protokolle auszuwählen.
Steuerungen der API-Protokolle
Die API-Protokoll-Seite verfügt über Steuerungen, um die angezeigten Daten in der Protokolltabelle zu filtern, den Zeitraum festzulegen und das Tabellenlayout zu verwalten.

Du kannst die angezeigten Daten anpassen, indem du die gespeicherten Abfrage-Steuerungen, die Suchleiste, das Zeitbereichsmenü und die Symbolleisten-Icons verwendest.
Abfragen
Die Suchleiste ermöglicht es dir, Protokolleinträge nach den unten aufgeführten Kriterien zu filtern. Gib ein oder mehrere Suchbegriffe in die Suchleiste ein, um die Tabelle der Protokolleinträge zu filtern.
Hinweis
Die API-Protokoll-Seite merkt sich deine zuletzt verwendeten Filterauswahlen. Wenn du nicht die erwarteten Ergebnisse siehst, überprüfe, ob zuvor angewendete Filter gelöscht wurden.
Suchbegriffe verwenden einen von zwei Operatoren:
=: Gibt Protokolleinträge zurück, bei denen das Feld mit dem Wert übereinstimmt.!=: Gibt Protokolleinträge zurück, bei denen das Feld nicht mit dem Wert übereinstimmt.
Wildcard-Muster werden mit beiden Operatoren unterstützt:
value%: Entspricht Einträgen, bei denen das Feld mit dem Wert beginnt.%value%: Entspricht Einträgen, bei denen das Feld den Wert enthält.%value: Entspricht Einträgen, bei denen das Feld mit dem Wert endet.
Dies sind die unterstützten Suchkriterien:
| Kriterium | Gültige Suche | Ungültige Suche |
|---|---|---|
| Anforderungs-ID | requestid=123%;requestid=fI9KRyjM%;requestid!=123%;requestid!=fI9KRyjM%; |
|
| Anforderungs-URI | requesturi=%acme2.jitterbit.net%;requesturi=%jitterbit.net/defaultUrlPrefix/test;requesturi=%[environment]/[version]/test;requesturi=%[environment]/[version]/test%requesturi!=%acme2.jitterbit.net%; |
|
| Antwortzeit | responsetime>5;responsetime<5;responsetime>=5;responsetime<=5;responsetime=0; |
responsetime!=5; |
| Quell-IP | sourceip=14.141%;sourceip!=14.141%; |
|
| Quellanwendung | sourceapp=Mozilla%;sourceapp=%Chrome%;sourceapp!=Mozilla%;sourceapp!=%Chrome%; |
|
| Nachricht | message=%REJECT%;message=%Access Denied%;message=%Ran successfully!%;message!=%REJECT%;message!=%Access Denied%; |
Abfragen kombinieren
Abfragen können eine Kombination von Kriterien enthalten. Kombinierte Suchkriterien müssen durch ein Semikolon (;) zwischen jedem Kriterium getrennt werden. Die Operatoren = und != können in derselben Suche zusammen verwendet werden. Dies sind Beispiele für gültige kombinierte Suchen:
message=%Access Denied%;requesturi=%contacts%;
requestid=%yzaccwui%;message=%REJECT%;
requesturi=%contacts%;responsetime<=2;
responsetime>=5;sourceapp=%Chrome%;
responsetime>=5;sourceip=70.5%;
sourceapp=%Chrome%;message=%REJECT%;
sourceapp=%Mozilla%;responsetime<=1;
sourceip=70.5%;requesturi=%contacts%;
sourceapp!=Mozilla%;message=%REJECT%;
sourceapp!=%Chrome%;responsetime<=2;
message!=%Access Denied%;requesturi=%contacts%;
sourceip!=70.5%;sourceapp=%Chrome%;
Gespeicherte Abfragen
Abfragen können gespeichert und wiederverwendet, dann bearbeitet oder gelöscht werden:
-
Eine Abfrage speichern: Klicken Sie auf Abfrage speichern. Ein Abfrageformular öffnet sich:
- Name: Geben Sie einen Namen für die gespeicherte Abfrage ein.
- Abfrage: Die aktuellen Suchbegriffe sind vorausgefüllt. Bearbeiten oder fügen Sie Abfragebegriffe mit derselben Syntax wie in der Suchleiste hinzu. Klicken Sie auf das Feld, um eine Liste verfügbarer Suchbegriffe anzuzeigen, oder geben Sie einen Begriff gefolgt von einem Semikolon ein.
Klicken Sie auf Speichern, um die Abfrage zu speichern.
-
Eine gespeicherte Abfrage verwenden: Klicken Sie auf Gespeicherte Abfragen, um die Liste der gespeicherten Abfragen zu öffnen, und klicken Sie dann auf eine Abfrage, um sie anzuwenden. Die Suchbegriffe werden in die Suchleiste übernommen und die Ergebnisse werden automatisch aktualisiert.
Hinweis
Die Zeitbereichswerte aus einer gespeicherten Abfrage werden auf den Zeitbereichsselector angewendet, nicht auf die Suchleiste.
-
Eine gespeicherte Abfrage bearbeiten: Klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf das Bearbeiten-Symbol für die Abfrage, die Sie bearbeiten möchten. Aktualisieren Sie den Namen oder die Abfragebegriffe und klicken Sie dann auf Speichern.
-
Eine gespeicherte Abfrage löschen: Klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf das Löschen-Symbol für die Abfrage, die Sie löschen möchten. Bestätigen Sie die Löschung, wenn Sie dazu aufgefordert werden.
Zeitbereichsselector
Der Zeitbereichsselector zeigt den derzeit ausgewählten Zeitraum (zum Beispiel Letzte 24 Stunden) an und ermöglicht es Ihnen, den Zeitrahmen der API-Protokolldaten anzupassen:

Klicken Sie auf den Zeitbereichsselector, um einen Dialog mit zwei Registerkarten zu öffnen: Relativ und Absolut.
Relativ-Registerkarte
Die Relativ-Registerkarte bietet vordefinierte Zeiträume und einen benutzerdefinierten relativen Zeitbereichsselector:

Wählen Sie einen der vordefinierten Zeiträume aus:
-
Letzte 24 Stunden: Zeigt API-Protokolldaten der letzten 24 Stunden an.
-
Letzte 48 Stunden: Zeigt API-Protokolldaten der letzten 48 Stunden an.
-
Letzte 72 Stunden: Zeigt API-Protokolldaten der letzten 72 Stunden an.
Um einen benutzerdefinierten relativen Zeitraum zu erstellen, verwenden Sie die Steuerelemente am unteren Rand des Dialogs:
-
Zahlenfeld: Geben Sie die Anzahl der Zeiteinheiten ein (zum Beispiel
1,7,30). -
Einheiten-Dropdown: Wählen Sie die Zeiteinheit aus Minuten, Stunden, Tagen, Wochen oder Monaten.
-
Abbrechen: Schließen Sie den Dialog, ohne Änderungen anzuwenden.
-
Anwenden: Wenden Sie den ausgewählten Zeitraum an und schließen Sie den Dialog.
Absolut-Registerkarte
Die Absolut-Registerkarte ermöglicht es Ihnen, einen bestimmten Datum- und Zeitbereich innerhalb der letzten 30 Tage auszuwählen:

Der ausgewählte Datumsbereich wird oben im Dialog im Format MM/DD/YYYY, HH:mm am/pm - MM/DD/YYYY, HH:mm am/pm angezeigt.
Konfigurieren Sie den Datum- und Zeitbereich mit den folgenden Steuerelementen:
-
Startzeitfeld: Zeigt die Startzeit für den Bereich an. Klicken Sie auf , um zu löschen, oder klicken Sie auf , um die Zeit anzupassen.
-
Endzeitfeld: Zeigt die Endzeit für den Bereich an. Klicken Sie auf , um zu löschen, oder klicken Sie auf , um die Zeit anzupassen.
-
Kalenderauswahl: Verwenden Sie den Kalender, um Start- und Enddaten auszuwählen. Navigieren Sie zwischen den Monaten mit den linken und rechten Pfeilen.
-
Abbrechen: Schließen Sie den Dialog, ohne Änderungen anzuwenden.
-
Anwenden: Wenden Sie den ausgewählten Datum- und Zeitbereich an und schließen Sie den Dialog.
Zusätzliche Steuerelemente
Zusätzliche Steuerungen erscheinen auf der rechten Seite der Symbolleiste:
-
Als CSV herunterladen: Klicken Sie, um die aktuellen Protokolldaten basierend auf den angewendeten Filtern und Suchkriterien herunterzuladen.
Hinweis
Das Datumsfeld innerhalb der CSV-Datei ist ein UNIX-Zeitstempel, der konvertiert werden muss, wenn Sie ein anderes Datums- und Zeitformat verwenden möchten.
-
Aktualisieren: Klicken Sie, um die Protokolldaten basierend auf den angewendeten Filtern und Suchkriterien zu aktualisieren.
-
Spalten filtern: Klicken Sie, um die Sichtbarkeit und Reihenfolge der Spalten zu ändern. Die Spalten-Seitenleiste öffnet sich mit den folgenden Steuerungen:
-
Suchen: Geben Sie einen Teil oder den gesamten Spaltennamen ein, um die Liste auf die übereinstimmenden Texte zu reduzieren.
-
Alle anzeigen: Alle Spalten sichtbar machen.
-
Verschieben: Ziehen und ablegen, um die Position der Spalte im Verhältnis zu anderen zu ändern.
-
Sichtbar: Die Spalte wird in der Tabelle angezeigt. Klicken Sie, um sie auszublenden.
-
Ausgeblendet: Die Spalte wird nicht in der Tabelle angezeigt. Klicken Sie, um sie anzuzeigen.
-
Speichern: Änderungen an den Spalten speichern.
-
Abbrechen: Den Spalteneditor schließen, ohne Änderungen zu speichern.
-
Seiteneinstellungen
Die obere rechte Ecke der Seite enthält den Schalter für die Ausführungshierarchie und das Einstellungen-Symbol:

-
Ausführungshierarchie: Schalter zur Steuerung, wie die Suchergebnisse die Eltern-Kind-Hierarchie der Protokolleinträge anzeigen. Wenn aktiviert, enthalten die Suchergebnisse die gesamte Ausführungskette für jeden übereinstimmenden Eintrag: Wenn der Treffer ein API-Protokolleintrag ist, werden alle zugehörigen Betriebseinträge angezeigt; wenn der Treffer ein Betriebseintrag ist, werden auch der übergeordnete API-Protokolleintrag und alle Geschwister- oder Kindoperationen angezeigt. Wenn deaktiviert, werden nur die Einträge angezeigt, die direkt den Suchkriterien entsprechen, ohne Eltern oder Kinder.
-
Einstellungen: Klicken Sie, um die Einstellungen-Leiste zu öffnen. Wählen Sie ein automatisches Aktualisierungsintervall, eines von Nie (der Standard), 1 Minute, 5 Minuten, 15 Minuten oder 30 Minuten, und klicken Sie dann auf Speichern.
Protokolleinträge Tabelle
Jede Zeile in der API-Protokolle-Tabelle zeigt Protokolldaten für einen API-Aufruf oder eine durch diesen Aufruf ausgelöste Operation an.
Tipp
Um die Sichtbarkeit und Reihenfolge der Spalten zu ändern, verwenden Sie Spalten filtern, wie in zusätzlichen Steuerelementen beschrieben.

Die folgenden Spalten sind verfügbar:
| Spalte | Beschreibung | Gilt für |
|---|---|---|
| Name | Der Name der API oder der Operation, die mit dem Protokolleintrag verbunden ist. | Alle |
| Protokolltyp | Der Typ des Protokolleintrags: Benutzerdefinierte API, Proxy-API oder OData-API für API-Protokolleinträge oder Operation für Protokolleinträge von Operationen. Protokolleinträge von Operationen erscheinen automatisch, wenn ein API-Aufruf eine Studio-Operation auslöst. Es sind keine zusätzlichen Konfigurationen erforderlich. | Alle |
| Umgebung | Der Name der Umgebung, in der die API bereitgestellt ist. | Alle |
| Status | Der Status des Protokolleintrags. Bei API-Protokolleinträgen handelt es sich um den HTTP-Statuscode (siehe w3.org Statuscode-Definitionen). Bei Operation-Protokolleinträgen handelt es sich um den Status der Operation. | Alle |
| Begonnen | Der Zeitstempel, wann die API-Anfrage empfangen wurde oder die Operation zu laufen begann. Zeiten werden in der Zeitzone Ihres Browsers angezeigt. | Alle |
| Beendet | Der Zeitstempel, wann der API-Aufruf oder die Operation abgeschlossen wurde. Zeiten werden in der Zeitzone Ihres Browsers angezeigt. Dieses Feld ist leer, solange der API-Aufruf oder die Operation noch läuft. | Alle |
| Dauer | Die Zeit, die zwischen Begonnen und Beendet vergangen ist. Dieses Feld ist leer, solange der API-Aufruf oder die Operation noch läuft. | Alle |
| ID | Die eindeutige Kennung für den Protokolleintrag. | Alle |
| API-Dienst-URL | Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Dienststammverzeichnisses, der Version und aller Pfadparameter. | Nur API |
| API-Version | Die Versionsnummer der API. | Nur API |
| Anforderungsmethode | Die HTTP-Methode, die für den API-Aufruf verwendet wurde. Mögliche Werte sind GET, POST, PUT, DELETE, PATCH und MERGE. | Nur API |
| Quell-IP | Die IP-Adresse der Client-Anwendung oder des Servers, der die API-Anfrage gestellt hat. | Nur API |
| Quellanwendung | Die Anwendung oder der Browser, der die API-Anfrage gestellt hat. | Nur API |
| API-Gateway | Der Domainname des Cloud-API-Gateways oder des privaten API-Gateways, das die Anfrage verarbeitet hat. | Nur API |
| Gateway-Typ | Der Typ des API-Gateways, das die Anfrage verarbeitet hat, entweder Öffentlich (Cloud-API-Gateway) oder Privat (privates API-Gateway). | Nur API |
| Auth-Typ | Der Typ der Authentifizierung, die vom Sicherheitsprofil verwendet wird, das der API zugewiesen ist. | Nur API |
| Agent | Der Name des Agents, der die Operation verarbeitet hat. | Nur Operation |
| Projekt | Der Name des Projekts, das mit dem Protokolleintrag verbunden ist. | Nur Operation |
| Root-Operation-Instanz-GUID | Die global eindeutige Kennung (GUID) der Root-Operation-Instanz. | Nur Operation |
| Operations-ID | Die eindeutige Kennung der durch den API-Aufruf ausgelösten Operation. | Nur Operation |
Hinweis
Logtyp in dieser Tabelle bezieht sich auf die Kategorie des Logeintrags, nicht auf die API-Logtypen (API-Logs, Debug-Logs, ausführliche Logs, Logs des privaten Agentenbetriebs), die in der Einführung beschrieben sind.
Fahren Sie mit der Maus über einen Logeintrag, um verfügbare Aktionen anzuzeigen. Die Aktionen unterscheiden sich je nach Logtyp:
Für Custom API, Proxy API und OData API Logeinträge:
- Anzeigen: Öffnen Sie die API-Logdetails.
- API öffnen: Öffnen Sie die API im API-Manager.
Für Operation Logeinträge:
- Anzeigen: Öffnen Sie die API-Logdetails.
-
Operation abbrechen: Aktiviert für Operationen, die den Status Eingereicht, Empfangen, Ausstehend oder Läuft haben. Operation abbrechen sendet eine Anfrage an den Agenten, um die Operation zu stoppen. Nach dem Klicken wird der Status Abbrechen angefordert neben dem Echtzeit-Status der Operation angezeigt.
Hinweis
Das Senden einer Abbruchanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen, die den Status Abbrechen angefordert haben, können weiterhin ausgeführt werden, abhängig vom aktuellen Ausführungszustand des Agenten.
-
Zur Operation gehen: Öffnen Sie das Projekt im Studio und wählen Sie die Operation aus. Diese Aktion ist nur für Studio-Operationen verfügbar, nicht für Design-Studio-Operationen.
Wenn es mehr als 100 Logeinträge gibt, werden sie in Seiten von jeweils 100 aufgeteilt. Verwenden Sie die Vorherige Seite und Nächste Seite Navigationsschaltflächen am Ende der Tabelle, um zwischen den Seiten zu wechseln.
API-Logdetails
Um zusätzliche Details oder Debug-Logs (falls aktiviert) für einen Logeintrag anzuzeigen, klicken Sie auf den Eintrag in der Tabelle. Ein Schublade öffnet sich am unteren Ende der Seite mit den folgenden Registerkarten, abhängig vom Logtyp:
- Custom API, Proxy API und OData API Logeinträge: Nachrichten und Debug-Logging.
- Operation Logeinträge: Nachrichten, Aktivitätsprotokolle und Debug-Logging.
Der Bereich ist mit Nachrichten und Protokolle betitelt und zeigt den Namen, den Status, die Startzeit, die Endzeit und die Dauer des ausgewählten Protokolleintrags an.
Nachrichten-Tab
Der Inhalt des Nachrichten-Tabs variiert je nach Protokolltyp des ausgewählten Eintrags.
API-Protokolleinträge
Wenn ein Custom API, Proxy API oder OData API Protokolleintrag ausgewählt ist, zeigt der Nachrichten-Tab Details zum API-Aufruf in den folgenden zusammenklappbaren Abschnitten an: API-Informationen, Aufrufinformationen, Aufrufprotokoll und API-Nutzlast (wenn 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 einem neuen Tab im API-Manager zu öffnen.
-
Version: Die Versionsnummer der API.
-
API-Typ: Der Typ der API, einer der folgenden:
- CUSTOM_API: Eine benutzerdefinierte API im API-Manager erstellt.
- ODATA: Eine OData API im API-Manager erstellt.
-
Anforderungsmethode: Die HTTP-Methode, die für den API-Aufruf verwendet wurde. Mögliche Werte sind GET, POST, PUT, DELETE, PATCH und MERGE.
-
API-Anforderungs-ID: Eine eindeutige Kennung für die API-Anforderung. Sie können diese ID verwenden, um Protokolle über verschiedene Systeme hinweg zu korrelieren und nach bestimmten Anforderungen zu suchen. Klicken Sie auf , um den Wert zu kopieren.
-
Quell-IP: Die IP-Adresse der Client-Anwendung oder des Servers, der die API-Anforderung gestellt hat.
-
API-Gateway: Das API-Gateway, das die Anfrage verarbeitet hat. Dieses Feld zeigt den Domainnamen entweder des Cloud-API-Gateways oder des privaten API-Gateways an, das den API-Aufruf bearbeitet hat.
-
API-Dienst-URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Dienststammverzeichnisses, der Version und aller Pfadparameter. Dies ist die vollständige API-Dienst-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-Anforderungsheader an, die mit dem API-Aufruf unter dem Label Anforderungsheader gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, wie accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungsheader.
Protokoll des Aufrufs
Der Abschnitt Protokoll des Aufrufs zeigt systemweite Protokollnachrichten an, die während der Verarbeitung der API-Anfrage generiert wurden. Klicken Sie auf , um das Protokoll in Ihre Zwischenablage zu kopieren.
API-Nutzlast
Der Abschnitt API-Nutzlast zeigt die Anforderungs- und Antwortnutzlastdaten für den API-Aufruf an. Dieser Abschnitt ist sichtbar, wenn einer oder beide der folgenden Punkte im Einstellungs-Tab der API aktiviert sind: Debugmodus aktivieren bis oder Anforderungs- und Antwortnutzlasten in Protokollen anzeigen.
Der Abschnitt ist in zwei Panels unterteilt:
-
Anforderungstext: Die Nutzlast, die mit der API-Anfrage gesendet wurde.
-
Antworttext: Die Nutzlast, die von der API zurückgegeben wurde. Wenn die Antwortnutzlast das Anzeige-Limit überschreitet, wird sie mit einem
(Truncated)-Label angezeigt.
Jedes Panel bietet die folgenden Steuerungen:
-
Suchen: Suchen Sie die Nutzlast nach einer bestimmten Zeichenfolge.
-
Kopieren: Kopieren Sie die Nutzlast in Ihre Zwischenablage.
-
Herunterladen: Laden Sie die Nutzlast als Datei herunter.
Protokolleinträge der Operation
Wenn ein Operation-Protokolleintrag ausgewählt ist, zeigt der Tab Nachrichten Folgendes an:
-
Quellaufzeichnungen: Wenn eine FTP oder Datenbank Aktivität als Quelle verwendet wird, wird die Anzahl der Datensätze angezeigt, die aus dem Quellsystem gelesen wurden. Bei anderen Konnektoren wird die Anzahl mit
0angezeigt, unabhängig von der Anzahl der Quellaufzeichnungen. -
Ziel-Datensätze: Bei der Verwendung einer FTP oder Datenbank Aktivität als Ziel wird die Anzahl der Datensätze angezeigt, die an das Zielsystem gesendet wurden. Bei anderen Konnektoren wird die Anzahl mit
0angezeigt, unabhängig von der Anzahl der Ziel-Datensätze. -
Nachricht: Protokolldetails für die Operation, einschließlich einer der folgenden:
- Vom System generierte Nachrichten, die anzeigen, dass die Operation ohne Fehler abgeschlossen wurde.
- Informations- und Warnmeldungen, die von den Quell- oder Zielsystemen zurückgegeben werden.
- Validierungswarnungen, die von den Jitterbit-Transformations-, Validierungs- und Skriptingdiensten zurückgegeben werden.
- Benutzerdefinierte Nachrichten, die vom Invoke Operation Tool generiert werden (wenn Fehler auslösen, wenn die Operation fehlschlägt aktiviert ist) oder von der
WriteToOperationLog()Funktion.
Hinweis
- Daten und Zeiten in Protokollnachrichten erscheinen im ursprünglichen Format der Quelle und werden nicht in die lokale Browserzeit umgewandelt.
- Protokollnachrichten, die ~100 KB überschreiten (~99.000 Zeichen), werden gekürzt, wobei
message truncatedam Ende des Protokolls angezeigt wird.
Klicken Sie auf , um zu kopieren, oder auf , um die Protokollnachrichten herunterzuladen.
-
In Pre-Transformation-Skripten protokollierte Nachrichten: Nachrichten, die während der Ausführung von Pre-Transformation-Skripten generiert werden. Klicken Sie auf , um zu kopieren, oder auf , um herunterzuladen.
Aktivitätsprotokolle-Registerkarte

Die Aktivitätsprotokolle-Registerkarte enthält Links zu Erfolgs- oder Fehlermeldungsdateien, die von Salesforce, Salesforce Service Cloud oder ServiceMax Aktivitäten erstellt wurden, die auf einem privaten Agenten ausgeführt werden. Die Dateien liegen im CSV-Format vor. Klicken Sie auf einen Link, um herunterzuladen.
Aktivitätsprotokolldateien werden nach 14 Tagen automatisch vom Dateireinigungsdienst des privaten Agents gelöscht. Dieses Verhalten kann im Abschnitt [ResultFiles] der Konfigurationsdatei des privaten Agents jitterbit.conf oder durch Ändern der Regeln für den Dateireinigungsdienst geändert werden.
Der Download von Aktivitätsprotokollen ist für Cloud-Agents deaktiviert. Möglicherweise sehen Sie Download-Links, aber der Versuch, herunterzuladen, erzeugt eine Fehlermeldung.
Debug Logging-Registerkarte
Wenn das Debug-Logging auf der Betriebsebene (für Cloud-Agents oder für private Agents) aktiviert ist und der Betrieb auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt diese Registerkarte die Details der vollständigen Ausführungs-Hierarchie eines Studio-Betriebs an. Die Ansicht des Betriebsprotokolls zeigt eine geteilte Ansicht mit Betriebsprotokollen im linken Bereich und detaillierten Protokollinformationen für den ausgewählten Betrieb im rechten Bereich. Die Ansicht verwendet die ausgewählten Tabellensteuerungen, um die Ergebnisse zu filtern. Wenn Betriebe mit Betriebsaktionen oder der Funktion RunOperation verkettet sind, werden diese Betriebe unter dem übergeordneten Betrieb aufgelistet.
Wenn das Debug-Logging für den Betrieb aktiviert ist, kann diese Registerkarte auch Komponenten-Eingabe- und Ausgabedaten sowie API-Anforderungs- und -Antwortdaten anzeigen (wenn der Betrieb durch eine API des API-Managers ausgelöst wird). Die Anforderungs- und Antwortpayloads sind nur enthalten, wenn Anforderungs- und Antwortpayloads in Protokollen anzeigen ebenfalls im Einstellungs-Tab der API aktiviert ist.
Übergeordnete Betriebe (und alle darunter liegenden Unterbetriebe) sind aufsteigend nach Gestart sortiert. Die Tabelle kann (nur für übergeordnete Betriebe) nach Name, Gestart, Beendet, Dauer oder Status sortiert werden, indem auf die jeweilige Kopfzeile geklickt wird.

Wenn Sie die Ansicht des Betriebsprotokolls öffnen, wird standardmäßig das erste Betriebsprotokoll in der Liste ausgewählt. Die detaillierten Protokollinformationen für diesen Betrieb erscheinen im rechten Bereich.
-
Name: Der Name der Operation oder des Operationsschrittes. Die Pfeile, die verwendet werden können, um zusätzliche Zeilen ein- oder auszublenden, werden bei übergeordneten Operationen und bei Operationen angezeigt, für die Eingabe- und Ausgabedaten von Komponenten verfügbar sind:
- Übergeordnete Operationen: Wenn eine übergeordnete Operation erweitert wird, erscheinen zusätzliche Zeilen für ihre untergeordneten Operationen in der Reihenfolge, in der sie ausgeführt wurden. Standardmäßig sind alle übergeordneten Operationen erweitert. Verwenden Sie die Liste einklappen oder Liste ausklappen Symbole, um alle übergeordneten Operationen ein- oder auszublenden.
-
Started: Das Datum und die Uhrzeit, zu der die Operation oder der Operation Schritt gestartet wurde, angezeigt als lokale Browserzeit.
-
Finished: Das Datum und die Uhrzeit, zu der die Operation oder der Operation Schritt gestoppt wurde, angezeigt als lokale Browserzeit. Dieses Feld ist leer, solange die Operation oder der Operation Schritt noch läuft.
-
Duration: Die Zeit, die zwischen Started und Finished vergangen ist, angegeben in Sekunden für Operationen und in Millisekunden für Operation Schritte. Dieses Feld ist leer, solange die Operation oder der Operation Schritt noch läuft.
-
Status: Der Status der Operation oder des Operation Schrittes. Eine vollständige Liste möglicher Status finden Sie in der Operation details table.
-
Actions: Diese Aktionen sind für Operationen verfügbar (nicht für Operation Schritte):
-
Operation abbrechen: Aktiviert für Operationen, die sich im Status Submitted, Received, Pending oder Running befinden. Operation abbrechen sendet eine Anfrage an den Agenten, um die Operation zu stoppen. Nach dem Klicken wird der Status Cancel Requested neben dem Echtzeit-Status der Operation angezeigt.
Hinweis
Das Senden einer Abbruchanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen, die den Status Cancel Requested haben, können weiterhin ausgeführt werden, abhängig vom aktuellen Ausführungszustand des Agenten.
-
Zur Operation gehen: Öffnen Sie das Projekt in Studio und wählen Sie die Operation aus.
-
-
Aktualisieren: Klicken Sie, um die Liste der Betriebsprotokolle zu aktualisieren.
-
Spalten filtern: Klicken Sie, um ein Panel zu öffnen, das es Ihnen ermöglicht, die Spalten neu anzuordnen oder deren Sichtbarkeit im Betriebslistenbereich anzupassen:

-
Alle anzeigen: Alle Spalten sichtbar machen.
-
Verschieben: Ziehen und ablegen, um die Position der Spalte im Verhältnis zu anderen zu ändern.
-
Ausblenden: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.
-
Anzeigen: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.
-
-
Spaltengröße ändern: Ziehen Sie die Größenänderungs-Leiste einer Spalte, um sie zu ändern.
-
Betriebsprotokoll: Um ein Protokoll für einen einzelnen Betrieb anzuzeigen oder auszublenden, klicken Sie auf einen Betrieb in der Liste.
-
Protokollnachrichten: Protokollnachrichten enthalten die Protokolldetails für den ausgewählten Betrieb. Ob Protokollnachrichten angezeigt werden, hängt von den Berechtigungen und Zugriffsrechten des aktuellen Benutzers ab und davon, ob das Cloud-Logging aktiviert ist. Weitere Informationen finden Sie im Abschnitt Nachrichtentab weiter oben auf dieser Seite.
Hinweis
Die innerhalb der Protokollnachrichten angezeigten Daten und Zeiten werden nicht in die lokale Browserzeit umgewandelt, sondern im ursprünglichen Format aus der Quelle der Protokollnachricht angezeigt.
-
Kopieren: Kopiert die Protokolldaten in Ihre Zwischenablage.
- Herunterladen: Lädt die Protokollnachrichten als Textdatei herunter.
- Anzeigen / Ausblenden: Zeigt die Protokollnachrichten an oder blendet sie aus.
-
Eingabe- und Ausgabedaten der Komponente
Eingabe- und Ausgabedaten der Komponente werden generiert, wenn ein Betrieb das Debug-Logging auf Betriebsebene aktiviert hat (für Cloud-Agenten oder für private Agenten) und der Betrieb auf einem Agenten der Version 10.48 oder höher ausgeführt wurde.
Hinweis
Die Generierung von Eingabe- und Ausgabedaten der Komponente wird nicht durch die Einstellung der Agentengruppe Cloud-Logging aktiviert beeinflusst. Eingabe- und Ausgabedaten der Komponente werden in der Harmony-Cloud protokolliert, auch wenn das Cloud-Logging deaktiviert ist.
Um die Generierung von Eingabe- und Ausgabedaten für Komponenten in einer privaten Agentengruppe zu deaktivieren, setzen Sie in der Konfigurationsdatei des privaten Agents im Abschnitt [VerboseLogging] verbose.logging.enable=false.
Warnung
Wenn Eingabe- und Ausgabedaten für Komponenten generiert werden, werden alle Anforderungs- und Antwortdaten für diesen Vorgang in der Harmony-Cloud protokolliert und bleiben dort für 30 Tage. Seien Sie sich bewusst, dass personenbezogene Daten (PII) und sensible Daten wie Anmeldeinformationen, die in einer Anforderungsnutzlast bereitgestellt werden, im Klartext in den Eingabe- und Ausgabedaten innerhalb der Protokolle der Harmony-Cloud sichtbar sind.
Wenn Eingabe- und Ausgabedaten für Komponenten vorhanden sind, wird eine grafische Darstellung des Vorgangs oder des Vorgangsschrittes im Panel der Vorgangsliste angezeigt.
Symbole für Aktivitäten und Transformationen, die als Vorgangsschritte verwendet werden, werden angezeigt. Sie können auf einen Vorgangsschritt klicken, um die Eingabe- und Ausgabedaten für diesen einzelnen Vorgangsschritt anzuzeigen oder auszublenden. Jeder Eintrag im Eingabe- und Ausgabenprotokoll ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eintrag im Eingabe- oder Ausgabenprotokoll 100 MB überschreiten, werden keine Daten angezeigt.

- Suchen: Suchen Sie die Daten nach dem eingegebenen Text.
- Kopieren: Kopiert die Protokolldaten in Ihre Zwischenablage.
- Herunterladen: Lädt die Eingabe- oder Ausgabedaten als Datei im entsprechenden Datenformat herunter. Die Datei wird mit dem Namen des Vorgangsschrittes gefolgt von
_inputoder_outputbenannt, je nach Bedarf.
API-Anforderungs- und Antwortdaten
Wenn ein Vorgang durch einen API-Manager benutzerdefinierten API oder OData-API ausgelöst wird, hängt die Menge der in den Protokolleintrag-Details angezeigten Informationen davon ab, welche Einstellungen aktiviert sind:
| Aktivierte Einstellungen | Protokollierte Informationen |
|---|---|
| Keine (Standard) | API-Informationen und Anrufinformationen im Nachrichtentab für alle API-Aufrufe (erfolgreich und nicht erfolgreich). |
| Vorgangs-Debug-Protokollierung | API-Informationen und Anrufinformationen im Nachrichtentab und Debug-Protokollierungstab. Anforderungs- und Antwortpayload sind ausgeschlossen. |
| API-Debug-Protokollierung und/oder Anforderungs- und Antwortpayloads in Protokollen anzeigen | API-Informationen, Anrufinformationen und Anforderungs-/Antwortpayload im Nachrichtentab. |
Um das Debug-Logging für Operationen zu aktivieren, siehe Debug-Logging für Cloud-Agenten oder Debug-Logging für private Agenten. Um Anforderungs- und Antwortpayloads anzuzeigen, aktiviere Anforderungs- und Antwortpayloads in Protokollen anzeigen im Einstellungs-Tab der API.
API Manager Log Service API (Beta)
Als Alternative zum Herunterladen einer API-Protokolldatei durch Klicken auf Als CSV herunterladen kannst du API-Protokolle programmgesteuert mit der API Manager Log Service API (Beta) abrufen.
