Runtime-Seite im Jitterbit Management Console

Übersicht

Einführung

Die Runtime-Seite ist eine Tabelle von Betriebsprotokollen. Wenn eine Operation ausgeführt wird, wird ein Betriebsprotokoll erstellt. Ein Betriebsprotokoll enthält Informationen darüber, wann und wo eine Operation ausgeführt wurde, den Status der Operation, die Anzahl der verarbeiteten Quell- und Zielaufzeichnungen sowie alle Protokollnachrichten. Ob detaillierte Protokollnachrichten angezeigt werden, hängt von Berechtigungen und Zugriffslevels sowie davon ab, ob das Cloud-Logging aktiviert ist.

Steuerungen der Runtime-Seite

Die Runtime-Seitenleiste enthält Steuerungen zum Suchen, Filtern, Herunterladen und Aktualisieren der Protokolldaten.

Suchleiste

Eine Abfrage besteht aus einem oder mehreren Schlüssel/Wert-Begriffen. Mehrere Begriffe werden durch Semikolons getrennt. Ein Begriff hat die Form <key><operator><value>. Für die Schlüssel operation, project, environment, agent und status können die Werte das Platzhalterzeichen % enthalten, das mit beliebigen Zeichenfolgen übereinstimmt. Sie können die Muster value% (beginnt mit), %value (endet mit) oder %value% (enthält) verwenden.

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

Wenn der Ausführung-Baum-Ansicht Schalter aktiviert ist, liefert eine Abfrage Ergebnisse für die gesamte Ausführungskette eines übereinstimmenden Eintrags: Bei einer Abfrage des Schlüssels operation umfassen die Ergebnisse die gesamte Hierarchie der übergeordneten und untergeordneten Operationen die mit der Operation verknüpft sind, sowie den übergeordneten API-Protokolleintrag, wenn die Operation durch einen API-Aufruf ausgelöst wurde. Der Schlüsselwort-String wird in den Ergebnissen blau hervorgehoben. Wenn der Ausführung-Baum-Ansicht Schalter deaktiviert ist, werden nur die Einträge zurückgegeben, die direkt mit der Abfrage übereinstimmen.

Die folgende Tabelle zeigt die verfügbaren Komponenten der Abfragebegriffe:

Abfragebeispiele

Die folgenden sind Beispielabfragebegriffe:

Saved queries

Abfragen können gespeichert und verwendet sowie bearbeitet oder gelöscht werden, wie folgt:

• Um eine Abfrage zu speichern, klicken Sie auf Abfrage speichern. Das Abfrageformular öffnet sich:

  

  Geben Sie Werte für die folgenden Felder ein oder wählen Sie diese aus, und klicken Sie dann auf Speichern:

  • Name: Ein Name für die Abfrage.
  • Abfrage: Ein oder mehrere Abfragebegriffe unter Verwendung derselben Syntax wie die Suchleiste. Sie können Begriffe auf folgende Weise hinzufügen:
    • Klicken Sie auf das Feld, um eine Liste verfügbarer Suchbegriffe anzuzeigen. Wählen Sie einen aus, um ihn in das Abfragefeld einzugeben, und fügen Sie dann einen Operator und einen Wert hinzu.
    • Wählen Sie einen der Abfragevorschläge aus.
    • Geben Sie einen Abfragebegriff ein, gefolgt von einem Semikolon.

  • Spalten: Wählen Sie die Spalten aus, die in den Suchergebnissen angezeigt werden sollen.

    

  Nach dem Speichern öffnet sich das Formular Gespeicherte Abfragen:

  

  Klicken Sie auf Gespeicherte Abfragen, um es zu schließen.

• Um eine gespeicherte Abfrage zu verwenden, klicken Sie auf Gespeicherte Abfragen, und klicken Sie dann auf die Abfrage, die Sie ausführen möchten. Die Abfragebegriffe werden in die Abfragenzeile kopiert, und die Abfrage wird automatisch ausgeführt.

• Um eine gespeicherte Abfrage zu bearbeiten, klicken Sie auf Gespeicherte Abfragen, und klicken Sie auf das Bearbeiten-Symbol für die Abfrage, die Sie bearbeiten möchten. Die Abfrage öffnet sich im Abfrage bearbeiten-Bereich:

  

  Bearbeiten Sie die Abfrage, und klicken Sie dann auf Speichern, um sie zu speichern, oder auf Abbrechen, um abzubrechen.

• Um eine gespeicherte Abfrage zu 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. Ein Dialogfeld Gespeicherte Abfrage löschen fordert Sie zur Bestätigung auf. Klicken Sie auf Löschen, um fortzufahren, oder auf Abbrechen, um abzubrechen.

Zeitbereich

Die Runtime-Seite gibt den Zeitraum zurück, der im Zeitbereichsmenü angezeigt wird:

Um den Zeitraum zu ändern, öffnen Sie das Menü und wählen Sie eine der folgenden Optionen aus:

• Letzte 24 Stunden

• Letzte 48 Stunden

• Letzte 72 Stunden

• Benutzerdefinierte Zeit: Wählen Sie aus, um den Dialog Benutzerdefinierte Zeit zu öffnen. Damit können Sie Vorgänge basierend auf den Daten für die Felder Begonnen und Beendet filtern:

  

  Klicken Sie auf das Kalendersymbol, um einen Datumswähler für ein Feld zu öffnen:

  

  Legen Sie entweder oder beide von- oder bis-Daten mit dem Kalender fest. Die Darstellung der Daten hängt von der Spracheinstellung Ihres Browsers ab.

  Um eine Uhrzeit festzulegen, geben Sie die Stunde und die Minute im Format HH:MM und den Zeitraum (AM oder PM) ein.

  Klicken Sie irgendwo im Dialog Benutzerdefinierte Zeit, um den Datumswähler zu schließen.

  Wenn entweder oder beide Datumsbereiche festgelegt sind, klicken Sie auf Übernehmen. Um den Bereich zu löschen, klicken Sie auf Löschen. Um die Daten eines Feldes zu löschen, klicken Sie auf das -Symbol.

Als CSV herunterladen

Klicken Sie auf Als CSV herunterladen, um den Dialog Protokolle herunterladen zu öffnen. Der Export verwendet die angewendete Suchanfrage, Filter und den Zeitbereich. Die exportierten Daten spiegeln alle Protokolleinträge wider, die den angewendeten Filtern entsprechen, was dem vollständigen Ergebnissatz entspricht, der auf allen Seiten der Tabelle angezeigt wird. Der Export bewahrt die Eltern-Kind-Hierarchie der Vorgangsketten und hält verwandte Einträge zusammen. Die Datensätze sind nach der Begonnen-Zeit des Elternteils (absteigend) und die Kinddatensätze nach der Ausführungsreihenfolge (aufsteigend) geordnet. Wenn der Export mehrere Dateien umfasst, werden alle Dateien in einem einzigen ZIP-Archiv zum Download verpackt.

Der Dialog enthält die folgende Option:

• Nachrichten einbeziehen: Wählen Sie aus, um vollständige Protokollnachrichten im Export einzuschließen. Diese Option ist standardmäßig nicht ausgewählt. Das Einbeziehen von Nachrichten kann die Dateigröße und die Generierungszeit erheblich erhöhen.

Klicken Sie auf Download, um den Export zu starten, oder auf Abbrechen, um abzubrechen.

Aktualisieren

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

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

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

Spalten filtern

Um die Anordnung und Sichtbarkeit der Spalten zu ändern, klicken Sie auf Spalten filtern. Die Spalten-Leiste öffnet sich:

Die Leiste enthält die folgenden Steuerungen:

• 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.
• Speichern: Die Spalten speichern.
• Abbrechen: Die Spaltenleiste ohne Speichern der Änderungen schließen.

Tabelle mit Betriebsdetails

Um die Tabelle nach einer Spalte zu sortieren, klicken Sie auf die Spaltenüberschrift; klicken Sie erneut, um die Reihenfolge umzukehren. Die verfügbaren Spalten sind wie folgt:

• Name: Der Name der API oder der Operation, die mit dem Protokolleintrag verbunden ist. Bei Betriebseinträgen mit untergeordneten Elementen klicken Sie auf das Erweitern-Symbol, um die gesamte Kette anzuzeigen. Klicken Sie auf das Minimieren-Symbol, um eine Operation und ihre untergeordneten Elemente zu reduzieren. (Gilt für alle Protokolltypen.)

• Protokolltyp: Der Typ des Protokolleintrags: Benutzerdefinierte API, Proxy-API oder OData-API für Operationen, die durch einen API-Aufruf ausgelöst werden, oder Operation für direkt ausgeführte Operationen. (Gilt für alle Protokolltypen.)

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

• Status: Der Status des Protokolleintrags. Für Custom API, Proxy API und OData API Protokolleinträge ist dies der HTTP-Statuscode (siehe w3.org Statuscode-Definitionen). Für Operation Protokolleinträge ist dies einer der folgenden:

  • Eingereicht: Eine Operation wurde in die Harmony-Warteschlange eingereicht, wurde jedoch noch nicht von einem Agenten zur Ausführung akzeptiert.
  • Erhalten: Ein Agent bestätigt den Erhalt der Anfrage zur Ausführung einer Operation.
  • Ausstehend: Eine Operation ist zur Ausführung auf einem Agenten in der Warteschlange.
  • Ausführend: Ein Agent führt die Operation aus.
  • Stornierungsanfrage: Eine Anfrage zur Stornierung der Operation wurde gestellt. Operationen können diesen Status anzeigen und dennoch nach der Stornierung weiterlaufen.
  • Abgebrochen: Die Operation wurde abgebrochen.
  • Erfolg: Die Operation wurde erfolgreich abgeschlossen.
  • Erfolg mit Informationen: Die Operation wurde erfolgreich abgeschlossen, jedoch mit nicht fatalen Problemen.

  • Erfolg mit Warnung: Die Operation wurde erfolgreich abgeschlossen, jedoch mit Warnungen, wie in den Protokollnachrichten angezeigt.

    Hinweis

    Eine extra subelement Warnung in den Protokollnachrichten kann im Allgemeinen ignoriert werden. Diese Warnung zeigt an, dass die API-Nutzlast eines Connectors mehr Knoten oder Felder von Daten zurückgegeben hat, als im Antwortdatenschema definiert sind.

  • Erfolg mit Kindfehler: Die Operation wurde erfolgreich abgeschlossen, aber eine oder mehrere untergeordnete Operationen hatten fatale Fehler. (Gilt für synchrone Operationen.)

  • Fehler: Die Operation ist fehlgeschlagen.
  • SOAP-Fehler: Die Operation ist mit einem SOAP-Fehler fehlgeschlagen. (Gilt für Operationen mit Studio SOAP oder Salesforce Endpunkten, oder Design Studio Webdiensten oder Salesforce Endpunkten.)

Wenn eine Operation das Debug-Logging der Operation auf der Ebene der Operation aktiviert hat und die Operation auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt die Status-Spalte im Debug-Logging-Tab den Status des Operation-Schrittes an:

• Abgeschlossen: Der Operation-Schritt wurde ausgeführt und ohne Fehler abgeschlossen.
• Fehler: Der Operation-Schritt wurde ausgeführt, konnte jedoch aufgrund eines Fehlers nicht abgeschlossen werden.

• Unvollständig: Der Operation-Schritt wurde nicht ausgeführt oder abgeschlossen. Mögliche Gründe für diesen Status sind, dass der Operation-Schritt auf die Ausführung wartet oder dass ein Fehler in einem vorherigen Operation-Schritt die Ausführung des folgenden Schrittes verhindert hat.

• Gestart: Der Zeitpunkt, zu dem die Ausführung der Operation angefordert wurde. (Gilt für alle Protokolltypen.)

• Beendet: Der Zeitpunkt, zu dem sich der Status der Operation zuletzt geändert hat. (Gilt für alle Protokolltypen.)

• Dauer: Die Zeitspanne zwischen Gestart und Beendet. (Gilt für alle Protokolltypen.)

• ID: Der eindeutige Identifikator für den Protokolleintrag. (Gilt für alle Protokolltypen.)

• API-Dienst-URL: Die vollständige URL zum Aufrufen der API, einschließlich der Basis-URL, des Dienststammverzeichnisses, der Version und aller Pfadparameter. Diese Spalte wird nur für Benutzerdefinierte API, Proxy-API und OData-API-Protokolleinträge ausgefüllt.

• Agent: Der Agent Name. Diese Spalte wird nur für Operation-Protokolleinträge ausgefüllt.

• Projekt: Der Name des Projekts, in dem die Operation ausgeführt wird. Diese Spalte wird nur für Operation-Protokolleinträge ausgefüllt.

• Root-Operation-Instanz-GUID: Der global eindeutige Identifikator (GUID) der Wurzel (obersten) Operation der Operation. Dieses Feld ist für Wurzeloperationen leer, und die Spalte ist standardmäßig ausgeblendet. Diese Spalte wird nur für Operation-Protokolleinträge ausgefüllt. Um den Wert zu kopieren, fahren Sie mit der Maus darüber und klicken Sie dann auf Inhalt kopieren.

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

• Aktionen: Fahren Sie mit der Maus über eine Operation, 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 Protokolldetails.
  • API öffnen: Öffnen Sie die API im API Manager.

  Für Operation Protokolleinträge:

  • Anzeigen: Öffnen Sie die Protokolldetails.

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

    Hinweis

    Das Senden einer Abbruchanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen mit dem Status Abbrechen angefordert 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. Diese Aktion ist nur für Studio-Operationen verfügbar, nicht für Design Studio-Operationen.

Wenn es mehr als 100 Operationen gibt, werden sie in Seiten von jeweils etwa 100 aufgeteilt. Um die verknüpften Operationsketten intakt zu halten, sind alle untergeordneten Operationen des letzten auf einer Seite angezeigten Elternteils auf dieser Seite enthalten, auch wenn die Gesamtzahl 100 überschreitet. Sie können durch die Seiten navigieren, indem Sie diese Navigationsschaltflächen am Ende der Tabelle verwenden:

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

Protokolleintragsdetails

Um die Details eines Protokolleintrags zu sehen, wählen Sie einen in der Tabelle aus. Die Nachrichten und Protokolle-Leiste öffnet sich am unteren Rand des Fensters mit den folgenden Registerkarten, abhängig vom Protokolltyp:

• Custom API, Proxy API und OData API Protokolleinträge: Nachrichten und Debug-Protokollierung.
• Operation Protokolleinträge: Nachrichten, Aktivitätsprotokolle, Debug-Dateien und Debug-Protokollierung.

Nachrichten-Registerkarte

Der Inhalt der Nachrichten-Registerkarte 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 die Nachrichten-Registerkarte 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, die im API Manager erstellt wurde.
  • ODATA: Eine OData API, die im API Manager erstellt wurde.

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

Anrufinformationen

Der Abschnitt Anrufinformationen 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.

Anrufprotokoll

Der Abschnitt Anrufprotokoll 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 einem bestimmten String.

• Kopieren: Kopieren Sie die Nutzlast in Ihre Zwischenablage.

• Herunterladen: Laden Sie die Nutzlast als Datei herunter.

Protokolleinträge der Operation

Wenn ein Protokolleintrag der Operation ausgewählt ist, zeigt der Nachrichten-Tab 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.

• 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 0 angezeigt, unabhängig von der Anzahl der Ziel-Datensätze.

• Nachricht: Protokolldetails, einschließlich einer der folgenden:

  • Systemgenerierte 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 melden, wenn die Operation fehlschlägt aktiviert ist) oder von der WriteToOperationLog() Funktion.

  Protokollnachrichten werden als einzelne Blöcke angezeigt, die nach Nachrichtentyp (zum Beispiel Nachricht, Fehler oder Fatale Fehler bei der Verarbeitung der Operation) gekennzeichnet sind. Jeder Block bietet zum Kopieren oder zum Herunterladen seines Inhalts.

  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 Nachricht gekürzt am Ende des Protokolls angezeigt wird.

• 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 , um herunterzuladen.

Um die Protokollnachrichten einer Operation im Nachrichten-Tab zu sehen, müssen die folgenden Bedingungen erfüllt sein:

• Sie müssen Mitglied einer Rolle mit mindestens Lesen Organisationsberechtigung und Protokolle anzeigen Umgebungszugriff sein.
• Cloud-Protokollierung ist aktiviert in der privaten Agentengruppe. (Cloud-Protokollierung ist immer in Cloud-Agentengruppen aktiviert.) Wenn sie deaktiviert ist und Ihre Netzwerkkonfiguration es Ihnen ermöglicht, direkt mit dem Agenten-Host zu verbinden, können Protokollnachrichten sicher angezeigt werden, indem Sie auf den Link Protokollnachrichten vom Agenten anzeigen klicken.

Aktivitätsprotokolle-Registerkarte

Diese Registerkarte enthält Links zu Erfolgs- oder Fehlerdateien, die von den Aktivitäten des Salesforce, Salesforce Service Cloud oder ServiceMax erstellt wurden, die auf einem privaten Agenten ausgeführt werden.

Die Dateien liegen im CSV-Format vor. Um eine herunterzuladen, klicken Sie auf den entsprechenden Link.

Aktivitätsprotokolldateien werden nach 14 Tagen automatisch vom Dateireinigungsdienst des privaten Agenten gelöscht. Dieses Verhalten kann im Abschnitt [ResultFiles] der Konfigurationsdatei des privaten Agenten jitterbit.conf oder durch Ändern der Regeln des Dateireinigungsdienstes geändert werden.

Der Download von Aktivitätsprotokollen ist für Cloud-Agenten deaktiviert. Es können Download-Links für Aktivitätsprotokolle von Cloud-Agenten angezeigt werden, jedoch führt der Versuch, Protokolle herunterzuladen, zu einer Fehlermeldung.

Debug-Dateien-Registerkarte

Wenn das Debug-Logging für private Agenten aktiviert ist, enthält diese Registerkarte einen Link zum Herunterladen von Betriebs-Debug-Protokolldateien. Die Debug-Dateien werden standardmäßig nach 1 Tag entfernt oder gemäß den Einstellungen in den Reinigungsregeln eines privaten Agenten.

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-Vorgangs. 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 Vorgänge mit Betriebsaktionen oder der Funktion RunOperation verknüpft sind, werden diese Vorgänge unter dem übergeordneten Betrieb aufgelistet.

Wenn das Debug-Logging für die Operation aktiviert ist, kann dieser Tab auch Komponenten-Eingabe- und Ausgabedaten sowie API-Anforderungs- und -Antwortdaten anzeigen (wenn die Operation 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 Operationen (und alle darunter liegenden untergeordneten Operationen) werden in aufsteigender Reihenfolge nach Begonnen sortiert. Die Tabelle kann (nur für übergeordnete Operationen) nach Name, Begonnen, Beendet, Dauer oder Status sortiert werden, indem auf die jeweilige Kopfzeile geklickt wird.

Wenn Sie die Ansicht des Operationsprotokolls öffnen, wird standardmäßig die erste Operation im Protokoll ausgewählt. Die detaillierten Protokollinformationen für diese Operation erscheinen im rechten Bereich.

• Name: Der Name der Operation oder des Operationsschrittes. Die Pfeile, die verwendet werden können, um zusätzliche Zeilen zu erweitern oder zu reduzieren, werden bei übergeordneten Operationen und bei Operationen angezeigt, für die Komponenten-Eingabe- und Ausgabedaten verfügbar sind:

  • Übergeordnete Operationen: Wenn eine übergeordnete Operation erweitert wird, erscheinen zusätzliche Zeilen für ihre untergeordneten Operationen in der Reihenfolge, in der sie ausgeführt wurden. Standardmäßig sind alle übergeordneten Operationen erweitert. Verwenden Sie die Liste reduzieren oder Liste erweitern Symbole, um alle übergeordneten Operationen zu reduzieren 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 Operationen Schritte.

• Status: Der Status der Operation oder des Operation Schrittes. Eine vollständige Liste möglicher Status finden Sie in der Tabelle mit Operationsdetails weiter oben auf dieser Seite.

• Aktionen: Diese Aktionen sind für Operationen (nicht für Operation Schritte) 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-Status der Operation angezeigt.

    Hinweis

    Das Senden einer Abbruchanfrage garantiert nicht, dass die Operation abgebrochen wird. Operationen mit dem Status Abbrechen angefordert 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 Operationsprotokolle zu aktualisieren.

• Spalten filtern: Klicken Sie, um ein Fenster zu öffnen, das es Ihnen ermöglicht, die Spalten neu anzuordnen oder deren Sichtbarkeit im Operationslistenpanel 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.

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

  • Protokollnachrichten: Protokollnachrichten enthalten die Protokolldetails für die ausgewählte Operation. 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

    Daten und Zeiten, die in den Protokollnachrichten selbst angezeigt werden, werden nicht in die lokale Browserzeit umgewandelt, sondern im ursprünglichen Format von 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.

Komponenteneingabe- und -ausgabedaten

Komponenteneingabe- und -ausgabedaten werden generiert, wenn ein Vorgang auf der Vorgangsebene 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.

Wenn Komponenteneingabe- und -ausgabedaten vorhanden sind, wird eine grafische Darstellung des Vorgangs oder des Vorgangsschrittes im Vorgangsliste-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 Ausgabeeintrag ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eingabe- oder Ausgabeeintrag 100 MB überschreiten, werden keine Daten angezeigt.

• Suche: Durchsuchen 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 Arbeitsschrittes gefolgt von _input oder _output benannt, je nach Bedarf.

API-Anforderungs- und Antwortdaten

Wenn eine Operation durch eine API-Manager benutzerdefinierte API oder OData-API ausgelöst wird, hängt die in den Betriebsprotokollen angezeigte Information davon ab, welche Einstellungen aktiviert sind. Fehlgeschlagene Operationen werden immer protokolliert. Erfolgreiche Durchläufe erscheinen in den Studio-Betriebsprotokollen nur, wenn Debug-Modus aktivieren bis (eine API-Manager-Einstellung) oder Betriebs-Debug-Protokollierung (eine Agenteneinstellung) aktiv ist. zeigt an, dass die Einstellung diese Fähigkeit hinzufügt; zeigt an, dass dies nicht der Fall ist:

API-Informationen

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

• API: Der Name der API, die den Betrieb 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 im API-Manager erstellt.
  • ODATA: Eine OData-API im API-Manager erstellt.

• Anfragemethode: 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 das Kopiersymbol, 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 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-Anforderung gestellt hat.

Call information

Das Betriebsprotokoll zeigt einen Abschnitt Call information mit den HTTP-Anforderungsheadern an, die mit dem API-Aufruf gesendet wurden. Jeder Header wird als Schlüssel-Wert-Paar angezeigt, wie z.B. accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungsheader.

Call log

Das Betriebsprotokoll zeigt auch einen Abschnitt Call log mit detaillierten Nachverfolgungsinformationen über die Verarbeitung der API-Anforderung an. Diese Informationen können zur Fehlersuche bei Problemen mit dem API-Gateway, Zeitüberschreitungsproblemen oder zum Verständnis des internen Verarbeitungsflusses der API verwendet werden. Der spezifische Inhalt des Call-Logs variiert je nach API-Konfiguration, Gateway-Einstellungen und ob während der Anforderungsverarbeitung Probleme aufgetreten sind.