Operationsprotokolle in Jitterbit Studio

Einführung

Wenn eine Operation ausgeführt wird, wird ein Operationsprotokoll generiert. Ein Operationsprotokoll enthält Informationen darüber, wann und wo eine Operation ausgeführt wurde, den Operationsstatus und alle Protokollmeldungen. Ob detaillierte Protokollmeldungen angezeigt werden, hängt von den Berechtigungen und Zugriffsstufen sowie davon ab, ob Cloud-Protokollierung aktiviert ist.

API-gesteuerte Operationen (konfiguriert über benutzerdefinierte APIs oder OData-APIs) verfügen über zusätzliche Protokollierung, die je nach konfigurierten Einstellungen aktiviert werden kann. Weitere Informationen finden Sie unter API-Anfrage- und Antwortdaten.

Operationsprotokolle, einschließlich detaillierter Protokollmeldungen von Cloud-Agenten und privaten Agenten sowie Komponenteneingabe- und -ausgabedaten in Operationsprotokollen, werden von Harmony 30 Tage lang aufbewahrt.

Auf Operationsprotokolle zugreifen

Auf Operationsprotokolle kann in Studio auf Workflow-, Operations- oder Projektebene zugegriffen werden. Je nachdem, wo darauf zugegriffen wird, enthält der Operationsprotokoll-Bildschirm maximal 1.000 Protokolle für einen bestimmten Zeitraum für Operationen, die in einem bestimmten Workflow, für eine bestimmte Operation oder in einem Projekt ausgeführt wurden. Wenn Operationen mit Operationsaktionen oder der Funktion RunOperation verknüpft sind, sind auch Protokolle für nachgelagerte Operationen enthalten.

Nach Workflow

Die Option Protokolle anzeigen für einen Workflow, die Protokolle für Operationen anzeigt, die in einem bestimmten Workflow ausgeführt wurden, kann über die Registerkarte Workflows des Projektbereichs aufgerufen werden (siehe Workflow-Aktionsmenü in Projektbereich-Registerkarte „Workflows").

Nach Operation

Die Option Protokolle anzeigen für eine Operation ist an diesen Stellen verfügbar:

• Die Registerkarte Workflows des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte „Workflows").
• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte „Komponenten").
• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).

Darüber hinaus können Sie nach manueller Ausführung einer Operation auf den Operationsstatus auf der Design-Canvas klicken, um die Protokolle anzuzeigen (siehe Operationsstatus in Operationsbereitstellung und -ausführung).

Nach Projekt

Bei Verwendung der Option Protokolle anzeigen eines Projekts wird die Seite Runtime der Management Console in einer neuen Browser-Registerkarte geöffnet und gefiltert, um Protokolle für Operationen anzuzeigen, die im Projekt ausgeführt wurden.

Die Option Protokolle anzeigen für ein Projekt kann an diesen Stellen aufgerufen werden:

• Die Seite Projekte (siehe Kartenansicht oder Listenansicht in Projekte).
• Die Projekt-Symbolleiste (siehe Projektaktionsmenü in Projekt-Symbolleiste).

Registerkarte „Operationsprotokoll" der Projektschublade

Wenn Sie Protokolle nach Workflow oder Operation anzeigen, öffnet sich die Projektschublade am unteren Rand der Design-Canvas, um Ihren Kontext im Projekt beizubehalten. Die Operationsprotokolle werden in einer geteilten Ansicht angezeigt, mit der Operationsliste auf der linken Seite und detaillierten Protokollinformationen für die ausgewählte Operation auf der rechten Seite.

• Registerkarten: Registerkarten oben in der Schublade sind mit Logging gefolgt vom Namen der Operation oder des Workflows gekennzeichnet (je nachdem, von wo aus auf die Protokolle zugegriffen wurde). Wenn Sie auf zusätzliche Protokolle oder Projektvariablen zugreifen, werden neue Registerkarten hinzugefügt. Um Registerkarten neu anzuordnen, ziehen Sie eine Registerkarte per Drag-and-Drop. Um eine Registerkarte zu schließen, klicken Sie auf das Symbol zum Schließen. Das Schließen der letzten Registerkarte oder die Verwendung des Symbols ganz rechts schließt die Schublade.
• Größe ändern: Die Leiste oben in der Schublade kann zum Ändern der Größe der Schublade verwendet werden. Bewegen Sie den Mauszeiger über die Leiste und ziehen Sie das Symbol zum Ändern der Größe nach oben oder unten, um die Größe der Schublade zu ändern.
• Reduzieren: Reduziert die Schublade, sodass alle Protokolle ausgeblendet werden. Nach dem Reduzieren klicken Sie auf das Symbol zum Zurückgeben, um zur vorherigen Ansicht zurückzukehren.
• Erweitern: Erweitert die Schublade auf Vollbild, sodass alle zusätzlichen Protokolle angezeigt werden. Nach dem Erweitern klicken Sie auf das Symbol zum Zurückgeben, um zur vorherigen Ansicht zurückzukehren.
• In Runtime öffnen: Öffnet die derzeit aufgerufene Registerkarte des Operationsprotokolls mit allen angewendeten Abfragen auf der Seite Runtime der Management Console. Zeitrahmenfilter werden nicht beibehalten und müssen auf der Seite Runtime erneut angewendet werden.
• Schließen: Schließt die Schublade.

Steuerelemente der Operationsprotokoll-Tabelle

Die Schubladenansicht des Operationsprotokolls enthält Filter für Zeitrahmen und Abfragen sowie Aktualisierung der Tabelle.

Zeitrahmen

Alle Zeitrahmen werden als lokale Browser-Zeit angezeigt. Standardmäßig ist der Zeitrahmen auf die letzten 24 Stunden der Protokolle seit der letzten Ausführung einer Operation eingestellt. Alternativ können Sie im Menü Letzte 48 Stunden, Letzte 72 Stunden oder Benutzerdefinierte Zeit auswählen:

Für einen bestimmten Zeitrahmen sind maximal 1.000 Protokolle in der Operationsprotokoll-Tabelle enthalten.

Wenn Benutzerdefinierte Zeit ausgewählt ist, wird ein Konfigurationsdialog geöffnet:

• Beendet: Um nach dem Datum und der Uhrzeit zu filtern, zu dem die Operation oder der Operationsschritt beendet wurde, klicken Sie auf das Symbol Kalender, um die Datumsauswahl zu öffnen. Um dieses Feld zu löschen, klicken Sie auf das Symbol Filter löschen.
• Gestartet: Um nach dem Datum und der Uhrzeit zu filtern, zu dem die Operation oder der Operationsschritt gestartet wurde, klicken Sie auf das Symbol Kalender, um die Datumsauswahl zu öffnen. Um dieses Feld zu löschen, klicken Sie auf das Symbol Filter löschen.
• Anwenden: (Aktiviert, wenn eines der Felder Beendet oder Gestartet konfiguriert ist.) Wendet alle Datums- und Uhrzeitfilter auf die Operationsprotokoll-Tabelle an.
• Löschen: (Aktiviert, wenn eines der Felder Beendet oder Gestartet konfiguriert ist.) Löscht beide Filter Beendet und Gestartet.

Sobald auf das Symbol Kalender geklickt wird, wird die Datums-/Uhrzeitauswahl für dieses Feld geöffnet:

• Von/Bis Datum: Verwenden Sie den Kalender unter einem oder beiden dieser Felder, um ein Datum innerhalb der letzten 30 Tage auszuwählen. Daten außerhalb dieses Bereichs können nicht ausgewählt werden.

• Monat: Der aktuelle Monat wird standardmäßig verwendet. Verwenden Sie die Pfeile, um zu einem anderen Monat zu navigieren.

  • Tag: Wählen Sie den gewünschten Tag aus dem Kalender aus.

• Zeit: Geben Sie die Stunde, Minute und Tageszeit (AM oder PM) ein.

Aktualisieren

Protokolle werden automatisch alle fünf Sekunden aktualisiert, wenn noch ein Vorgang ausgeführt wird (Status Empfangen, Eingereicht, Ausstehend oder Wird ausgeführt).

Sie können die Protokolle jederzeit manuell aktualisieren, um aktualisierte Informationen anzuzeigen. Um die Protokolle manuell zu aktualisieren, klicken Sie auf das Symbol Aktualisieren oben rechts.

Abfragen

Eine Abfrage besteht aus einem oder mehreren Schlüssel-Wert-Begriffen. Mehrere Begriffe werden durch Semikola getrennt. Ein Begriff hat die Form <key><operator><value>. Für den Schlüssel operation kann der Wert ein Platzhalterzeichen % enthalten, das einer beliebigen Zeichenkette entspricht.

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

Die folgende Tabelle zeigt die verfügbaren Abfragebegriff-Komponenten:

Vorgangsstatus

Die folgenden Status können abgefragt werden, wenn der Schlüssel status verwendet wird:

• Fehler: Wenn der Agent die Ausführung eines Vorgangs abschließt, aber beim Schreiben in das Zielsystem ein schwerwiegender Fehler auftritt, oder ein schwerwiegender Validierungsfehler in der Transformation vorliegt, oder die Transformationslogik die Funktion RaiseError auslöst, wird der Vorgangsstatus auf Fehler gesetzt und die Vorgangsausführung beendet.

• SOAP Fault: Wenn der Agent die Ausführung eines Vorgangs abschließt und das Ergebnis ein SOAP Fault ist, wird der Status auf SOAP Fault gesetzt. Dieser Status gilt nur für Vorgänge, die Salesforce, Salesforce Service Cloud, ServiceMax, SOAP oder Workday Aktivitäten verwenden.

• Eingereicht: Wenn Vorgänge in die Harmony-Warteschlange eingereicht werden, aber noch nicht von einem Agent zur Ausführung abgerufen wurden, haben sie den Status Eingereicht. Vorgänge können auf mehrere Arten eingereicht werden:

  • Jitterbit-Planungsdienst oder externer Planungsdienst
  • Manuelle Ausführung des Vorgangs in Studio
  • Eine RunOperation Funktion aus einem Skript oder einer Transformation
  • Jedes Tool, einschließlich JitterbitUtils, das eine API Manager API aufruft

• Empfangen: Sobald ein Agent ausgewählt wird und der Agent bestätigt hat, dass er die Anforderung zum Ausführen eines Vorgangs erhalten hat, wird der Status in Empfangen geändert.

• Ausstehend: Sobald ein Vorgang zur Ausführung in der Operationsengine eines Agenten eingeplant ist, ändert sich der Status zu Ausstehend. Vorgänge sollten nicht lange im Status Ausstehend verbleiben, da Agenten die Anfrage aufgreifen und Vorgänge in kurzer Zeit ausführen sollten.

• Wird ausgeführt: Sobald der Agent mit der Ausführung eines Vorgangs beginnt, sollte sich der Status zu Wird ausgeführt ändern. Vorgänge verbleiben in diesem Status, bis sie abgeschlossen sind oder auf einen Fehler stoßen. Der Agent protokolliert die vom Vorgang generierten Meldungen während der Ausführung, damit Benutzer nachverfolgbar können, welcher Teil des Vorgangs gerade ausgeführt wird.

• Abbruch angefordert: Gibt an, dass eine Anfrage zum Beenden des Vorgangs eingereicht wurde. Wenn ein Benutzer einen Vorgang beenden möchte, der sich im Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt befindet, kann er dies von diesen Orten aus tun:

  • Der Vorgang (siehe Laufzeitstatus in Design Canvas).
  • Die Operationsprotokoll-Tabelle.
  • Die Seite Laufzeit der Management Console.

  Alternativ können Benutzer einen anderen Vorgang aktivieren, um einen Vorgang mithilfe einer Kombination der Funktionen GetOperationQueue und CancelOperation abzubrechen. Sobald ein Abbruch angefordert wird, ändert sich der Vorgangsstatus zu Abbruch angefordert. Ein Vorgang sollte nicht lange in diesem Status verbleiben, da der Agent den Vorgang in relativ kurzer Zeit abbrechen sollte.

• Abgebrochen: Sobald ein Agent einen Vorgang abbricht, setzt er den Status auf Abgebrochen und der Vorgang wird beendet. Alle Protokollinformationen bis zum Zeitpunkt des Abbruchs sind in den Protokollmeldungen verfügbar, damit Sie wissen, an welcher Stelle der Vorgang abgebrochen wurde.

• Erfolg: Sobald ein Agent die Ausführung eines Vorgangs abgeschlossen hat und das Ergebnis ein Erfolg ohne Warnungen vom Zielsystem oder Warnungen in der Transformation mithilfe der Funktion WriteToOperationLog war, wird der Status auf Erfolg gesetzt.

• Erfolg mit Info: Wenn der Agent die Ausführung eines Vorgangs abgeschlossen hat, aber es gab nicht kritische Probleme in der Transformation oder beim Posten zum Zielsystem oder die Funktion WriteToOperationLog wurde verwendet, um Meldungen in das Protokoll zu schreiben, wird der Status auf Erfolg mit Info gesetzt. Dies warnt den Benutzer, dass er die Protokollmeldungen auf Informationen überprüfen sollte.

• Erfolg mit Warnung: Wenn der Agent die Ausführung eines Vorgangs abgeschlossen hat, aber es gab nicht kritische Probleme in der Transformation oder beim Posten zum Zielsystem und es gab eine Warnung, wird der Status auf Erfolg mit Warnung gesetzt. Dies warnt den Benutzer, dass er die Protokollmeldungen auf Warnungen überprüfen sollte.

• Erfolg mit untergeordnetem Fehler: Wenn der Agent die erfolgreiche Ausführung eines Vorgangs abgeschlossen hat, aber innerhalb eines oder mehrerer untergeordneter Vorgänge gab es einen kritischen Fehler beim Schreiben in das Zielsystem oder es gab einen kritischen Validierungsfehler in der Transformation oder die Transformationslogik hat die Funktion RaiseError ausgelöst, wird der Vorgangsstatus auf Erfolg mit untergeordnetem Fehler gesetzt. Dieser Status gilt nicht für asynchrone Vorgänge.

• Verzögerter Status: Wenn der Agent aus irgendeinem Grund kein Operationsprotokoll zurückgibt, wird Verzögerter Status angezeigt. Harmony versucht, Protokolle sechsmal abzurufen, mit einem 10-Sekunden-Timeout zwischen den einzelnen Aufrufen. Aktualisieren Sie die Seite oder überprüfen Sie die Protokolle später erneut. Es ist nicht möglich, nach Vorgängen mit Verzögertem Status zu filtern, aber Sie können sie in den Operationsprotokollen sehen.

Operationsschritte-Status

Operationsschritte werden nur angezeigt, wenn dieser Vorgang die Operationsdebug-Protokollierung auf Vorgangsebene aktiviert hat (für Cloud-Agenten oder für private Agenten) und der Vorgang auf einem Agent der Version 10.48 oder später ausgeführt wurde.

Operationsschritte können diese möglichen Status haben:

• Abgeschlossen: Der Operationsschritt wurde ausgeführt und ohne Fehler abgeschlossen.
• Fehler: Der Operationsschritt wurde ausgeführt, konnte aber aufgrund eines Fehlers nicht abgeschlossen werden.
• Unvollständig: Der Operationsschritt wurde nicht ausgeführt oder abgeschlossen. Mögliche Gründe für diesen Status sind, dass der Operationsschritt auf die Ausführung wartet oder dass ein Fehler in einem vorherigen Operationsschritt die Ausführung des folgenden Schritts verhindert hat.

Ansicht des Operationsprotokolls

Die Ansicht des Operationsprotokolls 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 verkettet sind, werden diese Operationen unter der übergeordneten Operation aufgelistet.

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

Es werden maximal 1000 Operationsprotokolle angezeigt. Um Protokolle für zusätzliche Operationen anzuzeigen, passen Sie die Filter entsprechend an.

Bereich der Operationsliste

Wenn Sie die Ansicht des Operationsprotokolls ö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 bei übergeordneten Operationen und bei Operationen angezeigt, für die Komponenteneingabe- und -ausgabedaten verfügbar sind:

  • Übergeordnete Operationen: Wenn Sie eine übergeordnete Operation erweitern, 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 neben der Spalte Name, um alle übergeordneten Operationen zu reduzieren oder zu erweitern.

  • Operation mit Eingabe- und Ausgabedaten: Wenn Sie eine Operation mit Eingabe- und Ausgabedaten erweitern, werden zusätzliche Zeilen für jeden Operationsschritt in der Reihenfolge ihrer Ausführung angezeigt. Weitere Informationen finden Sie unter Komponenteneingabe- und -ausgabedaten.

• Gestartet: Das Datum und die Uhrzeit, zu der die Operation oder der Operationsschritt mit der Ausführung begann, angezeigt als lokale Browserzeit.

• Beendet: Das Datum und die Uhrzeit, zu der die Operation oder der Operationsschritt die Ausführung beendete, 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 Operationsstatus weiter oben auf dieser Seite.

• Aktionen: Diese Aktion ist verfügbar:

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

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

• Anzeigeeinstellungen: Öffnet ein Menü, das steuert, welche Operationen in der Protokollansicht angezeigt werden.

  • Verkettete Operationen: Zeigt untergeordnete Operationen in einer Operationskette an oder blendet sie aus. Wenn aktiviert (), zeigt die Protokollansicht die ausgewählte Operation und alle untergeordneten Operationen in ihrer Operationskette an. Wenn deaktiviert (), werden nur die Protokolle der ausgewählten Operation angezeigt.

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

  

  • Alle anzeigen: Macht alle Spalten sichtbar.

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

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

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

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

Operationsprotokoll-Panel

Klicken Sie auf eine beliebige Operationszeile im linken Panel, um die detaillierten Protokollinformationen im rechten Panel anzuzeigen:

• Name: Der Name der Operation oder des Operationsschritts, zu dem das Protokoll gehört.

• Status: Der Status der Operation oder des Operationsschritts.

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

• Beendet: Datum und Uhrzeit, zu denen 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.

• 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 zeigt die Anzahl 0 an, unabhängig von der Anzahl der Quelldatensätze.

• 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 zeigt die Anzahl 0 an, unabhängig von der Anzahl der Zieldatensätze.

• Protokollmeldungen: Protokollmeldungen enthalten die Protokolldetails für die ausgewählte Operation. Ob Protokollmeldungen angezeigt werden, hängt davon ab, ob Cloud-Protokollierung aktiviert ist. Weitere Informationen finden Sie unter Registerkarte „Meldungen" in der Dokumentation der Seite Laufzeit der Management Console.

  Hinweis

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

• 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 eine Operation das Operationsdebug-Protokoll auf Operationsebene aktiviert hat (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.

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

Sie können auf Vorgangsschritte 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.

• Suche: Durchsucht die Daten nach dem eingegebenen Text.

• Kopieren: Kopiert die Protokolldaten in die Zwischenablage.

• Herunterladen: Lädt die Eingabe- oder Ausgabedaten als Datei im entsprechenden Datenformat herunter. Die Datei wird mit dem Namen des Vorgangsschritts gefolgt von _input oder _output benannt.

API-Anfrage- und Antwortdaten

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

API-Informationen

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

• API: Der Name der API, die den Vorgang ausgelöst hat.

  • API in neuem Tab öffnen: Klicken Sie, um die API in einem neuen Tab im API Manager zu öffnen.

• API-Typ: Dieses Feld kann einen der folgenden Typen haben:

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

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

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

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

• API-Gateway: Das API-Gateway, das die Anfrage verarbeitet hat. Dieses Feld zeigt den Domänennamen des Cloud-API-Gateways oder 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 Anwendung oder der Browser, der die API-Anfrage gestellt hat.

Aufrufinformationen

Das Operationsprotokoll zeigt einen Bereich Aufrufinformationen mit den HTTP-Anfrage-Headern an, die mit dem API-Aufruf gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, z. B. accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungs-Header. Header, die Anmeldedaten oder Sitzungsdaten enthalten, werden maskiert, wie unter Maskierte Header beschrieben.

Aufrufen-Protokoll

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