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 ab und davon, ob das Cloud-Protokollieren aktiviert ist. Wenn das Debug-Protokollieren von Operationen (für Cloud-Agenten oder für private Agenten) für eine einzelne Operation aktiviert ist, enthält jedes Betriebsprotokoll auch Eingabe- und Ausgabedaten für die Operation.

Standardmäßig zeigt die Runtime-Seite keine erfolgreichen benutzerdefinierten API oder OData-APIs API-Operationen an. Um sie einzuschließen, aktivieren Sie das Debug-Protokollieren von Operationen für die Operation oder setzen Sie für private Agenten nur EnableLogging=true im Abschnitt [APIOperation] der Konfigurationsdatei für private Agenten.

Die Werkzeuge und Bereiche der Seite werden in diesem Dokument erwähnt. Sie sind im folgenden Bild dargestellt:

Operationen-Details-Tabelle

Die verfügbaren Spalten sind wie folgt:

• Operation: Der Name der Studio oder Design Studio Operation. Wenn eine Operation Kinder hat, klicken Sie auf das Erweitern Symbol, um die gesamte Kette anzuzeigen. Klicken Sie auf das Minimieren Symbol, um eine Operation und ihre Kinder zu reduzieren.

• Projekt: Der Name des Projekts, in dem die Operation ausgeführt wird.

• Agent: Der Agent Name.

• Umgebung: Der Name der Umgebung, in der die Operation bereitgestellt wurde.

• Status: Der Status der Operation, einer der folgenden:

  • Eingereicht: Eine Operation wurde in die Harmony-Warteschlange eingereicht, aber 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 in der Warteschlange zur Ausführung auf einem Agenten.
  • Ausführend: Ein Agent führt die Operation aus.
  • Stornierung angefordert: 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.
  • Erfolgreich: Die Operation wurde erfolgreich abgeschlossen.
  • Erfolgreich mit Informationen: Die Operation wurde erfolgreich mit nicht fatalen Problemen abgeschlossen.

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

    Tipp

    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: Der Vorgang wurde erfolgreich abgeschlossen, aber ein oder mehrere untergeordnete Vorgänge hatten fatale Fehler. (Gilt für synchrone Vorgänge.)

  • Fehler: Der Vorgang ist fehlgeschlagen.
  • SOAP-Fehler: Der Vorgang ist mit einem SOAP-Fehler fehlgeschlagen. (Gilt für Vorgänge mit Studio SOAP oder Salesforce Endpunkten, oder Design Studio Webdiensten oder Salesforce Endpunkten.)

  Wenn ein Vorgang Operation-Debug-Protokollierung auf Vorgansebene aktiviert hat und der Vorgang auf einem Agenten der Version 10.48 oder höher ausgeführt wurde, zeigt die Status-Spalte im Debug-Protokoll-Tab den Status des Vorgangsschrittes an:

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

• Gestartet: Die Zeit, zu der der Vorgang angefordert wurde.

• Beendet: Die Zeit, zu der sich der Status des Vorgangs zuletzt geändert hat.
• Vorgangs-ID: Die global eindeutige Kennung (GUID) des Vorgangs. (Diese Spalte ist standardmäßig ausgeblendet.)
• Root Operation Instance Guid: Die global eindeutige Kennung (GUID) des Wurzelvorgangs (oberster) Vorgangs. Dieses Feld ist für Wurzelvorgänge leer, und die Spalte ist standardmäßig ausgeblendet. Um den Wert zu kopieren, fahren Sie mit der Maus darüber und klicken Sie dann auf Inhalt kopieren.
• Aktionen: Fahren Sie mit der Maus über einen Vorgang, um die folgenden Aktionen anzuzeigen:
  • Vorgänge abbrechen: Stoppen Sie einen Vorgang, der sich im Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt befindet.
  • Gehe zu Vorgang: Öffnen Sie das Projekt in Studio und wählen Sie den Vorgang aus.

Wenn es mehr als 100 Operationen gibt, werden diese in Seiten mit jeweils 100 aufgeteilt. Sie können durch diese Navigationsschaltflächen am unteren Ende der Tabelle navigieren:

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

Um die Details eines Operationsprotokolls zu sehen, wählen Sie eines in der Tabelle aus. Ein Schublade öffnet sich am unteren Rand des Fensters mit vier Registerkarten, Nachrichten, Aktivitätsprotokolle, Debug-Dateien und Debug-Protokollierung.

Nachrichten-Registerkarte

Diese Registerkarte zeigt 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, einschließlich einer der folgenden:

  • Vom System generierte Nachrichten, die anzeigen, dass die Operation ohne Fehler abgeschlossen wurde.
  • Informations- und Warnmeldungen, die von den Quell- oder Zielsystemen zurückgegeben werden.
  • Validierungswarnungen, die von den Jitterbit-Transformations-, Validierungs- und Skriptingdiensten zurückgegeben werden.
  • Benutzerdefinierte Nachrichten, die vom Invoke Operation Tool generiert werden (wenn Fehler auslösen, wenn die Operation fehlschlägt aktiviert ist) oder von der WriteToOperationLog() Funktion.

  Hinweis

  • Daten und Zeiten in Protokollnachrichten erscheinen im ursprünglichen Format der Quelle und werden nicht in die lokale Browserzeit umgewandelt.
  • Protokollnachrichten, die ~100 KB Größe (~99.000 Zeichen) überschreiten, werden gekürzt, was durch message truncated am Ende des Protokolls angezeigt wird.

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 der Berechtigung Lesen für die Organisation und dem Zugriff Ausführen auf die Umgebung sein. (Ein Zugriffslevel auf die Umgebung von Protokolle anzeigen ist nicht ausreichend.)
• Cloud-Logging ist aktiviert für die private Agentengruppe. (Cloud-Logging ist immer für Cloud-Agentengruppen aktiviert.) Wenn es deaktiviert ist und Ihre Netzwerk-Konfiguration 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-Tab

Dieser Tab enthält Links zu Erfolgs- oder Fehlermeldungsdateien, die von den Aktivitäten 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 können Sie im Abschnitt [ResultFiles] der Konfigurationsdatei des privaten Agenten jitterbit.conf ändern oder indem Sie die Regeln des Dateireinigungsdienstes ändern.

Der Download von Aktivitätsprotokollen ist für Cloud-Agenten deaktiviert. Sie können Download-Links für Aktivitätsprotokolle von Cloud-Agenten sehen, aber der Versuch, Protokolle herunterzuladen, erzeugt eine 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 Konfigurationen in den Bereinigungsregeln eines privaten Agenten.

Der Download von Debug-Protokolldateien ist für Cloud-Agenten deaktiviert. Es können Download-Links für Debug-Dateien von Cloud-Agenten angezeigt werden, jedoch führt der Versuch, Dateien herunterzuladen, zu einer 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.

Übergeordnete Betriebe (und alle darunter liegenden Unterbetriebe) sind aufsteigend nach Begonnen sortiert. Die Tabelle kann (nur für oberste Betriebe) nach Name, Begonnen, Beendet, Dauer oder Status sortiert werden, indem auf die jeweilige Kopfzeile geklickt wird.

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

• Name: Der Name des Betriebs oder des Betriebsschritts. Die Pfeile, die verwendet werden können, um zusätzliche Zeilen zu erweitern oder zu reduzieren, werden bei übergeordneten Betrieben und bei Betrieben angezeigt, für die Eingabe- und Ausgabedaten von Komponenten 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 Operation Schritte.

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

• Aktionen: Diese Aktionen sind 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

    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:

  

  • 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öße-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-Protokollieren 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 für einen Vorgang das Debug-Protokollieren auf Vorgangsebene aktiviert ist (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 Eingabe- und Ausgabedaten für Komponenten vorhanden sind, wird eine grafische Darstellung des Vorgangs oder des Vorgangsschrittes im Panel der Vorgangsliste angezeigt.

Symbole für Aktivitäten und Transformationen, die als Vorgangsschritte verwendet werden, werden angezeigt. Sie können auf einen Vorgangsschritt klicken, um die Eingabe- und Ausgabedaten 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.

• Suchen: Sucht 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 Vorgangsschrittes gefolgt von _input oder _output benannt, je nach Bedarf.

Abfragen

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 können die Werte ein Platzhalterzeichen, %, enthalten, das mit beliebigen Zeichenfolgen übereinstimmt.

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ührungsbaumansicht-Schalter aktiviert ist, gibt eine Abfrage mit dem Schlüssel operation (unten beschrieben) Ergebnisse für die gesamte Hierarchie von übergeordneten oder untergeordneten Vorgängen zurück, die mit dem Vorgang verknüpft sind. Der Schlüsselwort-String wird in den Ergebnissen blau hervorgehoben. Wenn der Ausführungsbaumansicht-Schalter deaktiviert ist, werden nur Vorgänge zurückgegeben, die der Abfrage entsprechen.

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 der gleichen 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.

    

  Wenn gespeichert, ö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, 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 an, 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 sowie 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.

Seiteneinstellungen

Sie können die Tabelle sortieren, ihre Spalten neu anordnen oder ihren Inhalt aktualisieren:

• Sortieren: Um die Tabelle in aufsteigender Reihenfolge zu sortieren, klicken Sie auf eine beliebige Spaltenüberschrift. Klicken Sie erneut, um die Sortierreihenfolge umzukehren.

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

  

  Die Schublade 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: Spalten speichern.
  • Abbrechen: Schließen Sie die Spaltenschublade, ohne Änderungen zu speichern.

• Aktualisieren: Die Tabelle wird automatisch aktualisiert.

  Um das automatische Aktualisierungsintervall zu ändern, klicken Sie auf Einstellungen. Der Einstellungen-Bereich öffnet sich:

  

  Wählen Sie ein automatisches Aktualisierungsintervall aus: 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.