Zum Inhalt springen

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-Protokoll 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 auf der API-Protokoll-Seite.

API-Protokollseite

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 Nachverfolgungsinformationen, die jeden Schritt der Anforderungsverarbeitung über die Dienst-URL einer API-Manager-API anzeigen. Das Debug-Protokoll ist standardmäßig nicht aktiviert und muss für eine einzelne API-Manager-API aktiviert werden. Um das Debug-Protokoll 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 eines API Manager APIs empfangen oder gesendet werden. API-Verbose-Protokollierung ist standardmäßig nicht aktiviert und muss für jeden einzelnen API Manager API aktiviert werden. Um die verbose Protokollierung zu aktivieren, siehe den Einstellungen-Tab in benutzerdefinierter 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 im log-Verzeichnis geschrieben werden. Diese Protokolle enthalten den Beginn eines API-Aufrufs und die verstrichene 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, bearbeiten Sie die Konfigurationsdatei des privaten Agenten und setzen Sie DebugJDML auf true.

Zugriff auf die API-Protokollseite

Um auf die API-Protokolle-Seite zuzugreifen, verwenden Sie das Harmony-Portal-Menü, um API Manager > API-Protokolle auszuwählen.

Steuerungen der API-Protokolle

Die API-Protokolle-Seite verfügt über Steuerungen, um die angezeigten Daten in der Protokolltabelle zu filtern, den Zeitraum festzulegen und das Tabellenlayout zu verwalten.

Steuerungen der API-Protokolle

Sie können die angezeigten Daten anpassen, indem Sie die gespeicherten Abfrage-Steuerungen, die Suchleiste, das Zeitbereichsmenü und die Symbolleisten-Symbole verwenden.

Abfragen

Die Suchleiste ermöglicht es Ihnen, Protokolleinträge nach den unten aufgeführten Kriterien zu filtern. Geben Sie ein oder mehrere Suchbegriffe in die Suchleiste ein, um die Protokolleintragstabelle zu filtern.

Hinweis

Die API-Protokolle-Seite merkt sich Ihre zuletzt verwendeten Filterauswahlen. Wenn Sie nicht die erwarteten Ergebnisse sehen, bestätigen Sie, dass 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 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 die 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 auf die Suchleiste angewendet und die Ergebnisse aktualisieren sich automatisch.

    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:

Zeitbereichsselector

Klicken Sie auf den Zeitbereichsselector, um einen Dialog mit zwei Registerkarten zu öffnen: Relativ und Absolut.

Relativ-Registerkarte

Die Relative Registerkarte bietet vordefinierte Zeiträume und einen benutzerdefinierten relativen Zeitbereichsselector:

relative tab

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 Absolute Registerkarte ermöglicht es Ihnen, einen bestimmten Datum- und Zeitbereich innerhalb der letzten 30 Tage auszuwählen:

absolute tab

Der ausgewählte Zeitraum 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 Zeitraum mit den folgenden Steuerelementen:

  • Startzeitfeld: Zeigt die Startzeit für den Zeitraum an. Klicken Sie auf , um zu löschen, oder klicken Sie auf , um die Zeit anzupassen.

  • Endzeitfeld: Zeigt die Endzeit für den Zeitraum 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 Zeitraum 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 entsprechenden 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:

seiteneinstellungen

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

Logeinträ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 Steuerungen beschrieben.

logeinträge tabelle

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. Alle
Dauer Die Zeitspanne zwischen Begonnen und Beendet. Alle
ID Die eindeutige Kennung für den Protokolleintrag. Alle
API-Dienst-URL Die vollständige URL für den Aufruf 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 Wird ausgeführt 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.
  • Zur Operation gehen: Öffnen Sie das Projekt in 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 (sofern aktiviert) für einen Logeintrag anzuzeigen, klicken Sie auf den Eintrag in der Tabelle. Ein Schublade öffnet sich am unteren Rand der Seite mit den folgenden Registerkarten, abhängig vom Logtyp:

Die Schublade trägt den Titel Nachrichten und Protokolle und zeigt den Namen, den Status, die Startzeit, die Endzeit und die Dauer für den ausgewählten Logeintrag an.

Nachrichten-Registerkarte

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).

Nachrichten-Tab

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:

  • 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, das den API-Aufruf bearbeitet hat.

  • API-Dienst-URL: Die vollständige URL für den Aufruf 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: Debug-Modus 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 in der 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 Aufzeichnungen angezeigt, die aus dem Quellsystem gelesen wurden. Bei anderen Konnektoren wird die Anzahl mit 0 angezeigt, unabhängig von der Anzahl der Quellaufzeichnungen.

  • Zielaufzeichnungen: Wenn eine FTP oder Datenbank Aktivität als Ziel verwendet wird, wird die Anzahl der Aufzeichnungen angezeigt, die an das Zielsystem gesendet wurden. Bei anderen Konnektoren wird die Anzahl mit 0 angezeigt, unabhängig von der Anzahl der Zielaufzeichnungen.

  • 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 Skriptservices zurückgegeben werden.
    • Benutzerdefinierte Nachrichten, die vom Invoke Operation Tool generiert werden (wenn Fehler bei Operation fehlgeschlagen 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, was durch message truncated am 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

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 Agenten gelöscht. Dieses Verhalten kann im Abschnitt [ResultFiles] der Datei jitterbit.conf des privaten Agenten geändert werden, oder indem die Regeln des Dateireinigungsdienstes geändert werden.

Aktivitätsprotokolldownloads sind für Cloud-Agenten 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-Agenten oder für private Agenten) 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. 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 verknüpft 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 oberste Betriebe) nach Name, Gestart, Beendet, Dauer oder Status sortiert werden, indem auf die jeweilige Kopfzeile geklickt wird.

Debug-Logging-Registerkarte

Wenn Sie die Ansicht des Betriebsprotokolls öffnen, wird standardmäßig der erste Betriebsprotokolleintrag in der Liste ausgewählt. Die detaillierten Protokollinformationen für diesen Betrieb erscheinen im rechten Bereich.

  • Name: Der Name des Betriebs oder des Betriebsschritts. Die Pfeile, die verwendet werden können, um zusätzliche Zeilen ein- oder auszuklappen, werden bei übergeordneten Betrieben und bei Betrieben angezeigt, für die Komponenten-Eingabe- und Ausgabedaten verfügbar sind:

  • Elternoperationen: Wenn eine Elternoperation erweitert wird, erscheinen zusätzliche Zeilen für ihre untergeordneten Operationen in der Reihenfolge, in der sie ausgeführt wurden. Standardmäßig sind alle Elternoperationen erweitert. Verwenden Sie die Collapse-Liste oder Expand-Liste-Icons, um alle Elternoperationen zu minimieren oder zu erweitern.

  • Begonnen: Das Datum und die Uhrzeit, zu der die Operation oder der Operation Schritt gestartet wurde, angezeigt als lokale Browserzeit.

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

  • Dauer: Die Zeit, die zwischen Begonnen und Beendet vergangen ist, angegeben in Sekunden für Operationen und in Millisekunden für Operationsschritte.

  • Status: Der Status der Operation oder des Operation Schrittes. Eine vollständige Liste möglicher Status finden Sie in der Operationdetails-Tabelle.

  • Aktionen: Diese Aktionen sind für Operationen (nicht für Operationsschritte) verfügbar:

    • Operation abbrechen: Aktiviert für Operationen, die den Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt 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-Operationsstatus angezeigt.

      Hinweis

      Operationen, die den Status Abbrechen angefordert haben, können weiterhin ausgeführt werden.

    • Gehe zur Operation: Öffnen Sie das Projekt in Studio und wählen Sie die Operation aus.

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

  • Spalten filtern: Klicken Sie, um eine Schublade zu öffnen, die es Ihnen ermöglicht, die Spalten neu anzuordnen oder ihre Sichtbarkeit im Operationslistenpanel anzupassen:

    filter columns

    • 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 Vorgang anzuzeigen oder auszublenden, klicken Sie auf einen Vorgang aus der Liste.

    • Protokollnachrichten: Protokollnachrichten enthalten die Protokolldetails für den ausgewählten Vorgang. Ob Protokollnachrichten angezeigt werden, hängt von den Berechtigungen und Zugriffsrechten des aktuellen Benutzers sowie davon ab, 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 Vorgang auf Betriebsebene das Debug-Logging aktiviert hat (für Cloud-Agenten oder für private Agenten) und der Vorgang 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 der Komponente in einer privaten Agentengruppe zu deaktivieren, setzen Sie in der Konfigurationsdatei des privaten Agenten im Abschnitt [VerboseLogging] verbose.logging.enable=false.

Warnung

Wenn Eingabe- und Ausgabedaten der Komponente 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 von Komponenten vorhanden sind, wird eine grafische Darstellung des Vorgangs oder des Vorgangsschritts 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 der Komponente für diesen einzelnen Vorgangsschritt anzuzeigen oder auszublenden. Jeder Eintrag im Eingabe- und Ausgabelog ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eintrag im Eingabe- oder Ausgabelog 100 MB überschreiten, werden keine Daten angezeigt.

log table operation steps header

  • Suchen: Durchsuchen Sie die Daten nach dem eingegebenen Text.
  • Kopieren: Kopiert die Logdaten in Ihre 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, je nach Bedarf.

API-Anforderungs- und Antwortdaten

Wenn ein Vorgang von einem API-Manager benutzerdefinierten API oder OData-API ausgelöst wird, hängt die Menge der in den Logeintragsdetails angezeigten Informationen davon ab, welche Einstellungen aktiviert sind:

Aktivierte Einstellungen Protokollierte Informationen
Keine (Standard) API-Informationen und Anrufinformationen im Nachrichten-Tab für alle API-Aufrufe (erfolgreich und erfolglos).
Vorgang-Debug-Logging API-Informationen und Anrufinformationen im Nachrichten-Tab und Debug-Logging-Tab. Anforderungs- und Antwortpayload sind ausgeschlossen.
API-Debug-Logging und/oder Anforderungs- & Antwortpayloads in Logs anzeigen API-Informationen, Anrufinformationen und Anforderungs-/Antwortpayload im Nachrichten-Tab.

Um das Vorgang-Debug-Logging zu aktivieren, siehe Vorgang-Debug-Logging für Cloud-Agenten oder Vorgang-Debug-Logging für private Agenten. Um Anforderungs- und Antwortpayloads anzuzeigen, aktivieren Sie Anforderungs- & Antwortpayloads in Logs anzeigen im Einstellungs-Tab der API.

API Manager Log Service API (Beta)

Als Alternative zum Herunterladen einer API-Protokolldatei durch Klicken auf Download as CSV können Sie API-Protokolle programmgesteuert mit der API Manager Log Service API (Beta) abrufen.