Runtime-Operationen-Seite in der Jitterbit Management Console

Einführung

Die Runtime-Operationen-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 den Berechtigungen und Zugriffslevels ab sowie davon, ob das Cloud-Logging aktiviert ist. Wenn das Debug-Logging für 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.

Um die Runtime-Operationen-Seite zu öffnen, verwenden Sie das Harmony-Portal-Menü, um Management Console > Runtime-Operationen auszuwählen.

Um auf diese Seite zuzugreifen, müssen Sie entweder ein Administrator der Harmony-Organisation (ein Mitglied einer Rolle mit der Admin Berechtigung) oder ein Mitglied einer Rolle mit Ausführen oder Protokolle anzeigen Umgebungszugriff sein.

Standardmäßig zeigt die Runtime-Operationen-Seite keine erfolgreichen benutzerdefinierten API oder OData-Dienste API-Operationen an. Um sie einzuschließen, aktivieren Sie das Debug-Logging für Operationen für die Operation oder setzen Sie, nur für private Agenten, 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 Integration 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 minimieren.

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

• Agent: Der Agent Name.

• Umgebung: Der Name der Umgebung, in die 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.
  • 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.

    Eine extra Unterelement-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 eine oder mehrere untergeordnete Operationen hatten fatale Fehler. (Gilt für synchrone Operationen.)

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

  Wenn für einen Vorgang Betriebs-Debug-Protokollierung auf Vorgangsebene aktiviert ist 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-Vorgangsinstanz-GUID: Die global eindeutige Kennung (GUID) des Wurzelvorgangs (oberste Ebene) des 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.

  Hinweis

  Root Operation Instance Guid ist eine Beta-Funktion, die in Zukunft weiterentwickelt wird.

• Aktionen: Fahren Sie mit der Maus über eine Operation, um die folgenden Aktionen anzuzeigen:

  • Operationen abbrechen: Stoppen Sie eine Operation, die sich im Status Eingereicht, Empfangen, Ausstehend oder Läuft befindet.
  • Gehe zur Operation: Öffnen Sie das Projekt im Integration Studio und wählen Sie die Operation aus.

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

• 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. Für andere Connectoren 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. Für andere Connectoren wird die Anzahl mit 0 angezeigt, unabhängig von der Anzahl der Zielaufzeichnungen.

• 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 (Beta) Tool generiert werden (wenn Fehler auslösen, wenn die Operation fehlschlägt aktiviert ist) oder von der WriteToOperationLog() Funktion.

Um die Protokollnachrichten einer Operation im Nachrichten-Tab anzuzeigen, 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.)
• Das Cloud-Logging ist aktiviert für die private Agentengruppe. (Cloud-Logging ist immer für Cloud-Agentengruppen aktiviert.) Wenn es 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-Tab

Dieser Tab enthält Links zu Erfolgs- oder Fehlerdateien, 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. Sie können dieses Verhalten im Abschnitt [ResultFiles] der Konfigurationsdatei des privaten Agenten jitterbit.conf ändern oder die Regeln des Dateireinigungsdienstes anpassen.

Der Download von Aktivitätsprotokollen ist für Cloud-Agenten deaktiviert. Sie sehen möglicherweise Download-Links für Cloud-Agenten-Aktivitätsprotokolle, aber der Versuch, Protokolle herunterzuladen, erzeugt eine Fehlermeldung.

Debug-Protokolle-Tab

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

Debug-Protokolldateidownloads sind für Cloud-Agenten deaktiviert. Möglicherweise sehen Sie Download-Links für Debug-Dateien von Cloud-Agenten, aber der Versuch, Dateien herunterzuladen, führt zu einer Fehlermeldung.

Debug-Logging-Tab

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 dieser Tab die Details der vollständigen Ausführungs-Hierarchie eines Integrationsstudio-Betriebs an. Wenn der ausgewählte Betrieb mit Betriebsaktionen verknüpft ist, sind auch Protokolle für nachgelagerte Betriebe enthalten.

Elternbetriebe (und alle darunter liegenden Kindbetriebe) 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.

• Name: Der Name des Betriebs oder des Betriebsschritts. Die Offenlegungstriangeln, die verwendet werden können, um zusätzliche Zeilen zu erweitern oder zu reduzieren, werden bei Elternbetrieben und bei Betrieben angezeigt, für die Eingabe- und Ausgabedaten von Komponenten verfügbar sind:

  • Elternbetriebe: Wenn ein Elternbetrieb erweitert wird, erscheinen zusätzliche Zeilen für seine Kindbetriebe in der Reihenfolge, in der sie ausgeführt wurden. Standardmäßig sind alle Elternbetriebe erweitert. Verwenden Sie die Liste reduzieren oder Liste erweitern Symbole, um alle Elternbetriebe zu reduzieren oder zu erweitern.

• Eingabe/Ausgabe: Eingabe- und Ausgabedaten, die über diesen Teil der Protokolltabelle abgerufen werden, sind unter Eingabe- und Ausgabedaten von Komponenten beschrieben.

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

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

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

• Status: Der Status der Operation oder des Operationsschrittes. 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 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-Status der Operation angezeigt.

    Hinweis

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

  • Zur Operation gehen: Öffnet das Projekt im Integration Studio und wählt die Operation aus.

• Operationsprotokoll: Um ein Protokoll für eine einzelne Operation anzuzeigen oder auszublenden, klicken Sie auf eine beliebige Stelle in einer Operationszeile, außer auf die in der Eingabe/Ausgabe-Spalte angezeigten Symbole:

  

  • 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 Tab Nachrichten 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 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 eine Operation das Debug-Logging auf Operationsebene aktiviert hat (für Cloud-Agenten oder für private Agenten) und die Operation auf einem Agenten der Version 10.48 oder höher ausgeführt wurde.

Wenn Eingabe- und Ausgabedaten für Komponenten vorhanden sind, wird in der Protokolltabelle ein Eingabe/Ausgabe-Spalte angezeigt, die eine grafische Darstellung des Vorgangs oder des Vorgangsschritts zeigt.

In der Eingabe/Ausgabe-Spalte können Symbole für Aktivitäten und Transformationen, die als Vorgangsschritte verwendet werden, angeklickt werden, um die Eingabe- und Ausgabedaten für diesen einzelnen Vorgangsschritt anzuzeigen oder auszublenden. Jeder Eintrag im Eingabe- und Ausgabenprotokoll ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eintrag im Eingabe- oder Ausgabenprotokoll 100 MB überschreiten, werden keine Daten angezeigt.

• Suchen: Suchen 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 Vorgangsschritts 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 jeder Zeichenfolge übereinstimmt.

Um eine Abfrage zu verwenden, geben Sie eine gültige Abfragespezifikation in die Suchleiste ein und drücken Sie 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 Operationen zurück, die mit der Operation verknüpft sind. Der Schlüsselwort-String wird innerhalb der Ergebnisse blau hervorgehoben. Wenn der Ausführungsbaumansicht-Schalter deaktiviert ist, werden nur Operationen 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 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 Operations-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 Operationen 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.

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. Der 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, 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.