API-Protokollseite im Jitterbit API Manager

Einführung

Die Seite API-Protokolle im API Manager zeigt eine Tabelle aller API-Verarbeitungsprotokolle und Debug-Protokolle an (falls Debug-Protokollierung aktiviert ist). Protokolle werden für benutzerdefinierte, OData- und Proxy-APIs generiert, wenn sie über das Cloud-API-Gateway oder ein privates API-Gateway aufgerufen werden. Wenn eine API einen Studio-Vorgang auslöst, werden die resultierenden Vorgangsprotokolle auch auf der Seite API-Protokolle zusätzlich zur Studio-Vorgangsprotokollansicht und zur Seite Runtime der Management Console angezeigt.

API-Aufrufe generieren vier Arten von Protokollen:

• API-Protokolle: API Manager generiert automatisch API-Protokolle auf der Seite API-Protokolle für jeden API Manager-API-Aufruf. API-Protokolle enthalten Informationen zum API-Aufruf, einschließlich des Zeitstempels der API-Anfrage, des HTTP-Statuscodes, der Anfrage-ID, der Anfragemethode, des Anfrage-URI, der Antwortzeit, der Quell-IP der aufrufenden Anwendung, der Quellanwendung und aller Protokollmeldungen.

• API-Debug-Protokolle: Detaillierte Trace-Informationen, die jeden Schritt der Anfrageverarbeitung durch die Service-URL einer API Manager-API anzeigen. API-Debug-Protokollierung ist standardmäßig nicht aktiviert und muss für jede einzelne API Manager-API aktiviert werden. Um Debug-Protokollierung zu aktivieren, siehe die Registerkarte Einstellungen in benutzerdefinierte API-Konfiguration, OData-API-Konfiguration oder Proxy-API-Konfiguration.

• API-Verbose-Protokolle: Rohe Anfrage- und Antwortdaten, die zum Aufrufen-Protokoll hinzugefügt werden, wenn eine API-Anfrage gestellt wird, einschließlich Anfrage- und Antwortheader, Parameter und Text. API-Verbose-Protokollierung ist standardmäßig nicht aktiviert und muss für jede einzelne API Manager-API aktiviert werden. Um Verbose-Protokollierung zu aktivieren, siehe die Registerkarte Einstellungen in benutzerdefinierte API-Konfiguration, OData-API-Konfiguration oder Proxy-API-Konfiguration.

• Private Agent-Vorgangsprotokolle: Informationen zu API-Aufrufen, die in die Datei jitterbit.log des privaten Agenten im Verzeichnis log geschrieben werden. Diese Protokolle enthalten den Anfang eines API-Aufrufs und die verstrichene Zeit. Private Agent-Vorgangsprotokolle 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 Seite API-Protokolle zuzugreifen, verwenden Sie das Harmony-Portalmenü, um API Manager > API-Protokolle auszuwählen.

API-Protokoll-Steuerelemente

Die Seite API-Protokolle verfügt über Steuerelemente zum Filtern der in der Protokolltabelle angezeigten Daten, zum Festlegen des Zeitbereichs und zum Verwalten des Tabellenlayouts.

Sie können die angezeigten Daten mithilfe der gespeicherten Abfrage-Steuerelemente, der Suchleiste, des Zeitbereichsmenüs und der Symbole in der Symbolleiste anpassen.

Abfragen

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

Um eine Abfrage zu erstellen, ohne die Suchsyntax direkt einzugeben, klicken Sie auf das -Symbol rechts neben der Suchleiste. Ein Suchbereich wird geöffnet, dessen Felder in die Abschnitte Common, API und Operation unterteilt sind. Klicken Sie für jedes Feld auf das Operatorsteuerelement =, um Equals oder Not equals aus dem angezeigten Dropdown auszuwählen, und geben Sie dann einen Wert ein oder wählen Sie einen aus, der übereinstimmen soll. Klicken Sie auf Search, um die Abfrage auszuführen, oder auf Reset, um alle Felder zu löschen. Der Bereich erstellt die gleiche Abfragesyntax, die in diesem Abschnitt beschrieben wird, und die resultierende Abfrage wird in der Suchleiste angezeigt.

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.

Platzhaltermuster werden mit beiden Operatoren unterstützt. Verwenden Sie % oder * als Platzhalterzeichen:

• value% oder value*: Stimmt mit Einträgen überein, bei denen das Feld mit dem Wert beginnt.
• abc%d oder abc*d: Stimmt mit Einträgen überein, bei denen das Feld mit abc beginnt, mit d endet und dazwischen beliebige Zeichen enthält.

Die Platzhalterübereinstimmung ist am Anfang des Feldwerts verankert, daher geben nur Suchen nach dem Anfang (Präfix) Ergebnisse zurück. Ein führender Platzhalter erweitert die Übereinstimmung nicht: %value% und *value* werden beide als value% (beginnt mit) behandelt. Die Suche nach Text, der nur in der Mitte oder am Ende eines Felds vorkommt, gibt keine Ergebnisse mehr zurück.

Dies sind die unterstützten Suchkriterien:

Abfragen kombinieren

Abfragen können eine Kombination von Kriterien enthalten. Kombinierte Suchkriterien müssen durch ein Semikolon (;) zwischen den einzelnen Kriterien 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=https://acme2.jitterbit.net%;

apiRequestId=yzaccwui%;message=REJECT;
sourceApplication=Mozilla%;message=REJECT;

sourceip=70.5%;requesturi=https://acme2.jitterbit.net%;

sourceApplication!=Mozilla%;message=REJECT;
message!=Access Denied;requesturi=https://acme2.jitterbit.net%;
sourceip!=70.5%;sourceApplication=Mozilla%;

Gespeicherte Abfragen

Abfragen können gespeichert und wiederverwendet werden, dann bearbeitet oder gelöscht:

• Abfrage speichern: Klicken Sie auf Abfrage speichern. Ein Abfrageformular wird geöffnet:

  • Name: Geben Sie einen Namen für die gespeicherte Abfrage ein.
  • Abfrage: Die aktuellen Suchbegriffe werden vorausgefüllt. Bearbeiten oder fügen Sie Abfragebegriffe mit der gleichen Syntax wie in der Suchleiste hinzu. Klicken Sie auf das Feld, um eine Liste der verfügbaren Suchbegriffe anzuzeigen, oder geben Sie einen Begriff gefolgt von einem Semikolon ein.

  Klicken Sie auf Speichern, um die Abfrage zu speichern.

• 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 werden automatisch aktualisiert.

  Hinweis

  Datumbereichswerte aus einer gespeicherten Abfrage werden auf die Zeitraumauswahl angewendet, nicht auf die Suchleiste.

• Gespeicherte Abfrage bearbeiten: Klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf das Symbol Bearbeiten für die Abfrage, die Sie bearbeiten möchten. Aktualisieren Sie den Namen oder die Abfragebegriffe, und klicken Sie dann auf Speichern.

• Gespeicherte Abfrage löschen: Klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf das Symbol Löschen für die Abfrage, die Sie löschen möchten. Bestätigen Sie das Löschen, wenn Sie dazu aufgefordert werden.

Zeitraumauswahl

Die Zeitraumauswahl zeigt den aktuell ausgewählten Zeitbereich an (z. B. Letzte 24 Stunden) und ermöglicht es Ihnen, den Zeitrahmen der API-Protokolldaten anzupassen:

Klicken Sie auf die Zeitraumauswahl, um ein Dialogfeld mit zwei Registerkarten zu öffnen: Relativ und Absolut.

Registerkarte „Relativ"

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

Wählen Sie einen der voreingestellten Zeitbereiche:

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

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

• Dropdown-Menü für Einheiten: Wählen Sie die Zeiteinheit aus Minuten, Stunden, Tage, Wochen oder Monate.

• Abbrechen: Schließen Sie das Dialogfeld, ohne Änderungen anzuwenden.

• Anwenden: Wenden Sie den ausgewählten Zeitbereich an und schließen Sie das Dialogfeld.

Registerkarte „Absolut"

Die Registerkarte Absolut ermöglicht es dir, einen bestimmten Datums- und Zeitbereich innerhalb der letzten 30 Tage auszuwählen. Daten außerhalb dieses Bereichs können nicht ausgewählt werden:

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.

Konfiguriere den Datums- und Zeitbereich mit den folgenden Steuerelementen:

• Startzeit-Feld: Zeigt die Startzeit für den Bereich an. Klicke , um zu löschen, oder klicke , um die Zeit anzupassen.

• Endzeit-Feld: Zeigt die Endzeit für den Bereich an. Klicke , um zu löschen, oder klicke , um die Zeit anzupassen.

• Datumsauswahl: Verwende den Kalender, um Start- und Enddaten auszuwählen. Navigiere zwischen Monaten mit den Pfeilen nach links und rechts.

• Abbrechen: Schließe den Dialog, ohne Änderungen anzuwenden.

• Anwenden: Wende den ausgewählten Datums- und Zeitbereich an und schließe den Dialog.

Zusätzliche Steuerelemente

Zusätzliche Steuerelemente werden auf der rechten Seite der Symbolleiste angezeigt:

• Als CSV herunterladen: Klicke, um den Dialog Protokolle herunterladen zu öffnen. Der Export hat die folgenden Eigenschaften:

  • Umfang: Der Export verwendet die angewendeten Filter und Suchkriterien und spiegelt alle übereinstimmenden Protokolleinträge wider. Dies entspricht dem vollständigen Ergebnissatz, der auf allen Seiten der Tabelle angezeigt wird.
  • Hierarchie: Der Export behält die Eltern-Kind-Hierarchie von API- und Operationsprotokolleinträgen bei und hält zugehörige Ketten zusammenhängend.
  • Reihenfolge: Datensätze werden nach der Startzeit des übergeordneten Elements (absteigend) sortiert, wobei untergeordnete Operationsdatensätze nach Ausführungsreihenfolge (aufsteigend) sortiert werden.
  • Zeitzone: Die Zeitstempel Gestartet und Beendet verwenden die lokale Zeitzone deines Browsers.
  • Verpackung: Wenn sich der Export über mehrere Dateien erstreckt, werden alle Dateien in einem einzigen ZIP-Archiv zum Herunterladen verpackt.

  Der Dialog enthält die folgende Option:

  • Meldungen einschließen: Wähle diese Option, um vollständige Protokollmeldungen in den Export einzubeziehen. Diese Option ist standardmäßig nicht ausgewählt. Das Einschließen von Meldungen kann die Dateigröße und Generierungszeit erheblich erhöhen.

  Klicke Herunterladen, um den Export zu starten, oder Abbrechen, um zu verwerfen.

• Aktualisieren: Klicke, um die Protokolldaten basierend auf den angewendeten Filtern und Suchkriterien zu aktualisieren.

• Spalten filtern: Klicke, um die Sichtbarkeit und Reihenfolge von Spalten zu ändern. Die Seitenleiste Spalten wird mit den folgenden Steuerelementen geöffnet:

  • Suche: Gib einen Teil oder den gesamten Namen einer Spalte ein, um die Liste auf die übereinstimmenden Texte zu reduzieren.

  • Alle anzeigen: Mache alle Spalten sichtbar.

  • Verschieben: Ziehe und lege ab, um die Position der Spalte relativ zu anderen zu ändern.

  • Sichtbar: Die Spalte wird in der Tabelle angezeigt. Klicke, um sie auszublenden.

  • Verborgen: Die Spalte wird nicht in der Tabelle angezeigt. Klicke, um sie anzuzeigen.

  • Speichern: Speichere alle Änderungen an den Spalten.

  • Abbrechen: Schließe den Spalten-Editor, ohne Änderungen zu speichern.

Seiteneinstellungen

Die obere rechte Ecke der Seite enthält den Umschalter Ausführungsbaumansicht und das Symbol Einstellungen:

• Ausführungsbaumansicht: Schalte um, um zu steuern, wie Suchergebnisse die Eltern-Kind-Hierarchie von Protokolleinträgen anzeigen. Wenn diese Option aktiviert ist, enthalten Suchergebnisse die vollständige Ausführungskette für jeden übereinstimmenden Eintrag: Wenn die Übereinstimmung ein API-Protokolleintrag ist, werden alle untergeordneten Operationseinträge angezeigt; wenn die Übereinstimmung ein Operationseintrag ist, werden auch sein übergeordneter API-Protokolleintrag und alle gleichgeordneten oder untergeordneten Operationen angezeigt. Wenn diese Option deaktiviert ist, werden nur die Einträge angezeigt, die direkt den Suchkriterien entsprechen, ohne übergeordnete oder untergeordnete Elemente.

• Einstellungen: Klicke, um die Seitenleiste Einstellungen zu öffnen. Wähle ein Intervall für die automatische Aktualisierung aus – eine der Optionen Nie (Standard), 1 Minute, 5 Minuten, 15 Minuten oder 30 Minuten – und klicke dann Speichern.

Tabelle der Protokolleinträge

Jede Zeile in der Tabelle API-Protokolle zeigt Protokollierungsdaten für einen API-Aufruf oder einen durch diesen Aufruf ausgelösten Vorgang an.

Die folgenden Spalten sind verfügbar:

Bewegen Sie den Mauszeiger über einen Protokolleintrag, um verfügbare Aktionen anzuzeigen. Die Aktionen unterscheiden sich je nach Protokolltyp:

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

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

Für Operation-Protokolleinträge:

• Anzeigen: Öffnen Sie die API-Protokolldetails.
• Vorgang abbrechen: Aktiviert für Vorgänge mit dem Status Submitted, Received, Pending oder Running. Vorgang abbrechen sendet eine Anfrage an den Agenten, um den Vorgang zu beenden. Nach dem Klicken wird der Status Cancel Requested neben dem Echtzeit-Vorgangsstatus angezeigt.

• Zum Vorgang wechseln: Öffnet das Projekt in Studio und wählt 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 Protokolleinträge vorhanden sind, werden diese in Seiten mit je 100 Einträgen aufgeteilt. Verwenden Sie die Navigationsschaltflächen Vorherige Seite und Nächste Seite am unteren Ende der Tabelle, um zwischen den Seiten zu wechseln.

API-Protokolldetails

Um zusätzliche Details oder Debug-Protokolle (falls aktiviert) für einen Protokolleintrag anzuzeigen, klicken Sie auf den Eintrag in der Tabelle. Eine Schublade öffnet sich am unteren Ende der Seite mit den folgenden Registerkarten, je nach Protokolltyp:

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

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

Registerkarte „Meldungen"

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

API-Protokolleinträge

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

API-Informationen

Der Abschnitt API-Informationen zeigt die folgenden Details an:

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

• Version: Die Versionsnummer der API.

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

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

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

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

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

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

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

Aufrufinformationen

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

Aufrufen-Protokoll

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

API-Nutzlast

Der Bereich API-Nutzlast zeigt die Anfrage- und Antwortnutzlastdaten für den API-Aufruf an. Dieser Bereich ist sichtbar, wenn eine oder beide der folgenden Optionen in der Registerkarte „Einstellungen" der API aktiviert sind: Debug-Modus aktivieren bis oder Anfrage- und Antwortnutzlasten in Protokollen anzeigen.

Der Bereich ist in zwei Bereiche unterteilt:

• Anfragebody: Die mit der API-Anfrage gesendete Nutzlast.

• Antwortkörper: Die von der API zurückgegebene Nutzlast. Wenn die Antwortnutzlast das Anzeigelimit überschreitet, wird sie mit einer (Truncated)-Bezeichnung angezeigt.

Jeder Bereich bietet die folgenden Steuerelemente:

• Suche: Durchsucht die Nutzlast nach einer bestimmten Zeichenfolge.

• Kopieren: Kopiert die Nutzlast in die Zwischenablage.

• Herunterladen: Lädt die Nutzlast als Datei herunter.

Operationsprotokolleinträge

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

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

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

• Meldung: Protokolldetails für die Operation, einschließlich einer oder mehrerer der folgenden:

  • Vom System generierte Meldungen, die angeben, 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 Scripting-Services zurückgegeben werden.
  • Benutzerdefinierte Meldungen, die vom Tool Operation aufrufen (wenn Fehler auslösen, wenn Operation fehlschlägt aktiviert ist) oder der Funktion WriteToOperationLog() generiert werden.

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

  Hinweis

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

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

Registerkarte „Aktivitätsprotokolle"

Die Registerkarte Aktivitätsprotokolle enthält Links zu Erfolgs- oder Fehlerdateien, die von Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivitäten erstellt werden, die auf einem privaten Agent ausgeführt werden. Dateien liegen im CSV-Format vor. Klicken Sie auf einen Link, um herunterzuladen.

Aktivitätsprotokoll-Dateien werden nach 14 Tagen automatisch vom Datenbereinigungs-Service des privaten Agenten gelöscht. Sie können dieses Verhalten in der Sektion [ResultFiles] der Datei jitterbit.conf des privaten Agenten oder durch Änderung der Datenbereinigungs-Service-Regeln ändern.

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

Debug Logging-Registerkarte

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

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

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

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

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

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

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

• Beendet: Das Datum und die Uhrzeit, zu der die Operation oder der Operationsschritt beendet wurde, angezeigt als lokale Browserzeit. Dieses Feld ist leer, während die Operation oder der Operationsschritt noch ausgeführt wird.

• Dauer: Die zwischen Gestartet und Beendet verstrichene Zeit, angegeben in Sekunden für Operationen und in Millisekunden für Operationsschritte. Dieses Feld ist leer, während die Operation oder der Operationsschritt noch ausgeführt wird.

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

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

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

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

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

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

      Hinweis

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

• Zum Vorgang gehen: Öffnen Sie das Projekt in Studio und wählen Sie den Vorgang aus.

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

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

  

  • Alle anzeigen: Alle Spalten sichtbar machen.

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

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

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

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

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

  • Protokollmeldungen: Protokollmeldungen enthalten die Protokolldetails für den ausgewählten Vorgang. Ob Protokollmeldungen angezeigt werden, hängt von den Berechtigungen und 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

    Daten und Uhrzeiten, die in den Protokollmeldungen selbst angezeigt werden, werden nicht in die lokale Browserzeit konvertiert, sondern werden in ihrem ursprünglichen Format aus der Quelle der Protokollmeldung gemeldet.

  • Kopieren: Kopiert die Protokolldaten in die Zwischenablage.

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

Komponenteneingabe- und -ausgabedaten

Komponenteneingabe- und -ausgabedaten werden generiert, wenn ein Vorgang auf Vorgangsebene Debug-Protokollierung aktiviert hat (für Cloud-Agenten oder für private Agenten) und der Vorgang auf einem Agent der Version 10.48 oder später ausgeführt wurde.

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

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

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

API-Anfrage- und Antwortdaten

Wenn ein Vorgang durch eine API Manager benutzerdefinierte API oder OData-API ausgelöst wird, hängen die im Protokolleintrag der Registerkarte Meldungen angezeigten Informationen davon ab, welche Einstellungen aktiviert sind. API-Informationen, Aufrufinformationen und grundlegende Aufrufsprotokollierungsdaten sind immer enthalten. gibt an, dass der Informationstyp enthalten ist; gibt an, dass er nicht enthalten ist:

Maskierte Header

Header, die häufig Anmeldedaten oder Sitzungsdaten enthalten, werden in der Protokollausgabe maskiert. Der Name eines maskierten Headers wird weiterhin angezeigt, aber sein Wert wird durch [removed] ersetzt.

Die Maskierung gilt für den Abschnitt Anrufinformationen auf dieser Seite, den Abschnitt Anrufinformationen der Seite Runtime der Verwaltungskonsole und die Rohdaten von Request und Response, die durch Ausführliches Logging oder Debug-Modus aktivieren bis hinzugefügt werden.

Die folgenden Header werden maskiert:

• api_key
• authorization
• authtoken
• clientsecret
• password
• proxy_authorization
• x_access_token
• x_api_key
• x_auth_token

Um benutzerdefinierte Request-Header in Studio HTTP-Aktivitäten oder Design Studio HTTP Quellen und Ziele zu maskieren, verwenden Sie den Abschnitt [Masking] der Konfigurationsdatei des privaten Agenten.

API Manager Log Service API (Beta)

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

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten des API Manager-Fehlerbehebungsleitfadens:

• Operationsprotokolle sind nicht sichtbar für API-ausgelöste Operationen, wenn der Debug-Modus deaktiviert ist

• API-Payload ist 2 Tage lang auf dem Agenten verfügbar

• API-Protokollseite behält vorherige Filterauswahlen bei