Betriebsprotokolle im Jitterbit Integration Studio
Einführung
Wenn eine Operation ausgeführt wird wird ein Operation generiert. Ein Operation enthält Informationen darüber, wann und wo ein Operation ausgeführt wurde, den Operation und alle Protokollmeldungen. Ob detaillierte Protokollmeldungen angezeigt werden, hängt von den Berechtigungs- und Zugriffsebenen sowie davon ab, ob die Cloud-Protokollierung aktiviert ist. Bei der debuggen Protokollierung von Operation (für Cloud-Agenten oder für private Vertreter) für eine einzelne Operation aktiviert ist, enthält jedes Operation auch Eingabe- und Ausgabedaten für die Operation.
Betriebsprotokolle, einschließlich detaillierter Protokollnachrichten von Cloud-Agenten und privaten Agenten sowie Komponenten-Ein- und-Ausgabedaten in Operation, werden von Harmony 30 Tage lang aufbewahrt.
Betriebsprotokolle können auch in der Management Console Runtime Operations eingesehen werden Seite.
Wichtig
Standardmäßig werden erfolgreiche API -Operationen (konfiguriert für benutzerdefinierte APIs oder OData-Dienste) sind nicht in den Operation enthalten, sofern nicht eine dieser Einstellungen aktiviert ist:
EnableLogging=true
im [APIoperation]
Abschnitt der privaten Agentenkonfigurationsdatei. Informationen zum Beheben bestimmter Fehler, die bei der Ausführung einer Operation auftreten können, finden Sie unter Fehlerbehebung bei Operationen.
Operation
Auf Operationsprotokolle kann im Integration Studio auf Workflow, Operation oder Projektebene zugegriffen werden. Je nachdem, wo auf sie zugegriffen wird, enthält der Operation 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 Operation verknüpft sind oder die RunOperation
Funktion, Protokolle für nachlegende Vorgänge sind ebenfalls enthalten.
Nach Workflow
Auf die Option Protokolle anzeigen für einen Workflow, die Protokolle für Vorgänge anzeigt, die innerhalb eines bestimmten Workflow ausgeführt wurden, kann über die Tab Workflows im Projektbereich zugegriffen werden (siehe Aktionsmenü „Workflow-Aktionen“ im Projektbereich Tab Workflows).
Durch den Operation
Auf die Option Protokolle anzeigen für einen Operation kann von diesen Orten aus zugegriffen werden:
- Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).
- Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).
- Die Design-Canvas (siehe Aktionsmenü in Design-Leinwand).
Darüber hinaus können Sie nach dem manuellen Ausführen einer Operation auf der Design-Canvas auf den Operation klicken, um die Protokolle anzuzeigen (siehe Operationsstatus in Operationsbereitstellung und -ausführung).
Nach Projekt
Bei Verwendung der Option „Protokolle anzeigen“ eines Projekts werden in der Verwaltungskonsole die Laufzeitvorgänge wird in einem neuen Browser-Tab geöffnet und gefiltert, um Protokolle für Vorgänge anzuzeigen, die innerhalb des Projekts ausgeführt wurden.
Auf die Option Protokolle anzeigen für ein Projekt kann von diesen Orten aus zugegriffen werden:
- Die Seite Projekte (siehe Kartenansicht oder Listenansicht in Projekte).
- Die Projektsymbolleiste (siehe Aktionsmenü in der Projektsymbolleiste).
Notiz
Der Rest dieser Seite behandelt die Benutzeroberfläche des Operation für Workflows und Vorgänge. Informationen zum Anzeigen von Operation für ein gesamtes Projekt finden Sie unter Laufzeitvorgänge.
Tab „Operation “ der Projektschublade
Beim Anzeigen von Protokollen nach Workflow oder Operation wird die Projektschublade am unteren Rand der Design-Canvas geöffnet, um Ihren Kontext im Projekt beizubehalten:
- Registerkarten: Die Registerkarten oben in der Schublade sind mit Protokollierung gefolgt vom Namen des Operation oder Workflow beschriftet (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 die Reihenfolge der Registerkarten zu ändern, ziehen Sie eine Tab per Drag & Drop. Um eine Tab zu schließen, klicken Sie auf Schließen-Symbol. Schließen Sie die letzte Tab oder verwenden Sie das Symbol ganz rechts Das Schließen-Symbol schließt die Schublade.
- Größe ändern: Die Leiste oben in der Schublade kann verwendet werden, um die Größe der Schublade zu ändern. Bewegen Sie den Mauszeiger über die Leiste und ziehen Sie das Zum Ändern der Schubladengröße das Größensymbol nach oben oder unten drücken.
- Reduzieren: Reduziert die Schublade, sodass alle Protokolle ausgeblendet werden. Klicken Sie anschließend auf das Zurück-Symbol, um zur vorherigen Ansicht zurückzukehren.
- Erweitern: Erweitert die Schublade auf den Vollbildmodus, sodass alle zusätzlichen Protokolle angezeigt werden. Klicken Sie nach dem Erweitern auf das Zurück-Symbol um zur vorherigen Ansicht zurückzukehren.
- In Laufzeitoperationen öffnen: Öffnet die aktuell aufgerufene Tab des Operation mit allen angewendeten Abfragen in der Management Console Laufzeitvorgänge Seite. Zeitrahmenfilter werden nicht beibehalten und müssen auf der Seite Laufzeitvorgänge erneut angewendet werden.
- Schließen Schließt die Schublade.
Steuerelemente der Betriebsprotokolltabelle
Das Operation Schubladenansicht enthält Filter für Zeitrahmen und Abfragen und Tabelle Aktualisieren.
Zeitrahmen
Alle Zeiträume werden in der lokalen Browserzeit angezeigt. Standardmäßig ist der Zeitrahmen auf die Letzten 24 Stunden der Protokolle seit der letzten Ausführung eines Operation eingestellt. Alternativ können Sie im Menü Letzte 48 Stunden, Letzte 72 Stunden oder Benutzerdefinierte Zeit auswählen:
Für einen bestimmten Zeitraum werden maximal 1.000 Protokolle in die Operation aufgenommen.
Hinweis
Betriebsprotokolle werden maximal 30 Tage lang gespeichert.
Wenn Benutzerdefinierte Zeit ausgewählt ist, öffnet sich ein Konfigurationsdialog:
- Fertig: Um nach Datum und Uhrzeit zu filtern, an dem die Operation oder der Operation Schritt beendet wurde, klicken Sie auf das Kalendersymbol, um die Datumsauswahl zu öffnen. Um dieses Feld zu löschen, klicken Sie auf das Symbol „Filter löschen“.
- Gestartet: Um nach Datum und Uhrzeit des Beginns der Operation oder des Operation Schritt zu filtern, klicken Sie auf das Kalendersymbol, um die Datumsauswahl zu öffnen. Um dieses Feld zu löschen, klicken Sie auf das Symbol „Filter löschen“.
- Übernehmen: (Aktiviert, wenn entweder die Felder Fertig oder Gestartet konfiguriert sind.) Wendet alle Datums- und Zeitfilter auf die Tabelle der Operation an.
- Löschen: (Aktiviert, wenn entweder die Felder Fertig oder Begonnen konfiguriert sind.) Löscht sowohl die Filter Fertig als auch Begonnen.
Sobald ein Wenn Sie auf das Kalendersymbol klicken, wird die Datums-/Uhrzeitauswahl für dieses Feld geöffnet:
-
Von/Bis Datum: Wählen Sie im Kalender unter einem oder beiden dieser Felder ein Datum innerhalb der letzten 30 Tage aus.
-
Monat: Standardmäßig wird der aktuelle Monat verwendet. Verwenden Sie die Mit den Pfeilen können Sie zu einem anderen Monat navigieren.
-
Tag: Wählen Sie den gewünschten Tag im Kalender aus.
-
Uhrzeit: Geben Sie Stunde, Minute und Zeitraum ein (AM
oder PM
).
Aktualisieren
Protokolle werden automatisch alle fünf Sekunden aktualisiert, wenn ein Operation noch ausgeführt wird (Status Empfangen, Übermittelt, Ausstehend oder Ausführen).
Sie können die Protokolle auch jederzeit manuell aktualisieren, um aktuelle Informationen anzuzeigen. Klicken Sie dazu auf das Symbol Aktualisieren-Symbol oben rechts.
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 operation
Schlüssel, der Wert kann ein Platzhalterzeichen enthalten, %
, das mit jeder Zeichenfolge übereinstimmt.
Um eine Abfrage zu verwenden, geben Sie eine gültige Abfrage in die Suchleiste ein und drücken Sie die Eingabetaste:
Die folgende Tabelle zeigt die verfügbaren Abfrage:
Schlüssel | Schlüsselspalte | Erlaubte Operatoren | Wert1 |
---|---|---|---|
name oder operation | Name | = | Vorgangsname |
status | Status | = | Statusname |
started | Gestartet | <= | Datum/Uhrzeit |
>= | |||
finished | Fertig | <= | Datum/Uhrzeit |
>= | |||
message | n/v | n/v | Betriebsprotokollmeldung |
1 Werttypen
- Statusname: Die Zeichenfolge, die in der Spalte Status der Operation angezeigt wird.
- Datum/Uhrzeit: Datumsformat
Monat/Tag/Jahr
, mit optionalerStunde:Minute:Sekunde
-Uhrzeit im AM/PM-Format:- Nur Datum:
MM/TT/JJJJ
- Datum und Uhrzeit (AM):
MM/TT/JJJJ HH:MM:SS AM
- Datum und Uhrzeit (PM):
MM/TT/JJJJ HH:MM:SS PM
- Nur Datum:
Betriebszustände
Die folgenden Status können bei Verwendung des status
Schlüssel:
-
Fehler: Wenn der Agent die Ausführung einer Operation abschließt, aber beim Schreiben in das Zielsystem ein schwerwiegender Fehler aufgetreten ist, oder bei der Transformation ein schwerwiegender Validierungsfehler aufgetreten ist, oder die Transformation den
RaiseError
Funktion, dann wird der Operation auf Fehler gesetzt und die Operation beendet. -
SOAP Fehler: Wenn der Agent die Ausführung einer Operation abschließt und das Ergebnis ein SOAP Fehler war, wird der Status auf SOAP Fehler gesetzt. Dieser Status gilt nur für Operationen mit Salesforce, Salesforce Service Cloud, ServiceMax, SOAP oder Workday Aktivitäten.
-
Übermittelt: Wenn Vorgänge an die Harmony Warteschlange übermittelt, aber noch nicht von einem Agenten zur Ausführung abgeholt wurden, haben sie den Status Übermittelt. Vorgänge können auf verschiedene Weise übermittelt werden:
- Jitterbit-Planungsdienst oder externer Planungsdienst
- Manuelle Ausführung der Operation im Integration Studio
- A
RunOperation
Funktion aus einem Script oder einer Transformation - Jedes Werkzeug, einschließlich
JitterbitUtils
, das eine API-Manager API aufruft
-
Empfangen: Sobald ein Agent ausgewählt wurde und der Agent bestätigt hat, dass er die Anforderung zum eine Operation Durchführen erhalten hat, wird der Status in Empfangen geändert.
-
Ausstehend: Sobald ein Operation in der Operation-Engine eines Agenten geplant ist, wird der Status auf Ausstehend geändert. Vorgänge sollten nicht lange im Status Ausstehend verbleiben, da Agenten die Anfrage annehmen und die Vorgänge innerhalb kurzer Zeit ausführen sollten.
-
Läuft: Sobald der Agent mit der Ausführung einer Operation beginnt, sollte sich der Status in Läuft ändern. Operationen bleiben in diesem Status, bis sie abgeschlossen sind oder ein Fehler auftritt. Der Agent beginnt mit der Protokollierung der von der Operation generierten Meldungen, damit Benutzer verfolgen können, welcher Teil der Operation gerade ausgeführt wird.
-
Abbruch angefordert: Zeigt an, dass eine Anforderung zum Abbrechen des Operation übermittelt wurde. Wenn ein Benutzer einen Operation mit dem Status Übermittelt, Empfangen, Ausstehend oder Wird ausgeführt abbrechen möchte, kann er dies von folgenden Stellen aus tun:
- Die Operation (siehe Laufzeit in Design-Leinwand).
- Die Operation.
- Die Laufzeitoperationen Seite der Management Console (siehe Laufzeit abbrechen).
Alternativ können sie eine andere Operation aktivieren, um eine Operation abzubrechen, indem sie eine Kombination der
GetOperationQueue
UndCancelOperation
Funktionen. Sobald ein Abbruch angefordert wird, ändert sich der Operation in Abbruch angefordert. Ein Operation sollte nicht lange in diesem Status verbleiben, da der Agent den Operation innerhalb relativ kurzer Zeit abbrechen sollte. -
Abgebrochen: Sobald ein Agent einen Operation abbricht, wird der Status auf Abgebrochen gesetzt und der Operation beendet. Alle Protokollinformationen bis zum Zeitpunkt des Abbruchs sind in den Protokollmeldungen verfügbar, sodass Sie wissen, wann der Operation abgebrochen wurde.
-
Erfolg: Sobald ein Agent die Ausführung einer Operation abgeschlossen hat, und das Ergebnis erfolgreich war, ohne dass Warnungen vom Zielsystem oder Warnungen in der Transformation mithilfe des
WriteToOperationLog
Funktion, dann wird der Status auf Erfolg gesetzt. -
Erfolg mit Info: Wenn der Agent die Ausführung einer Operation abschließt, es jedoch nicht schwerwiegende Probleme bei der Transformation oder beim Posten im Zielsystem gab oder
WriteToOperationLog
Wurden Meldungen in das Protokoll geschrieben, wird der Status auf Erfolgreich mit Informationen gesetzt. Dies weist den Benutzer darauf hin, die Protokollmeldungen auf Informationen zu prüfen. -
Erfolg mit Warnung: Wenn der Agent die Ausführung einer Operation abschließt, aber bei der Transformation oder der Übertragung an das Zielsystem keine schwerwiegenden Probleme aufgetreten sind und eine Warnung ausgegeben wurde, wird der Status auf Erfolg mit Warnung gesetzt. Dies weist den Benutzer darauf hin, die Protokollmeldungen auf Warnungen zu prüfen.
-
Erfolg mit untergeordnetem Fehler: Wenn der Agent die Ausführung einer Operation erfolgreich abschließt, aber innerhalb einer oder mehrerer untergeordneter Operationen ein schwerwiegender Fehler beim Schreiben in das Zielsystem aufgetreten ist, oder es einen schwerwiegenden Validierungsfehler bei der Transformation gab, oder die Transformation den
RaiseError
Funktion, dann wird der Operation auf Erfolgreich mit untergeordnetem Fehler gesetzt. Dieser Status gilt nicht für asynchrone Vorgänge. -
Verzögerter Status: Wenn der Agent aus irgendeinem Grund kein Operation zurücksendet, wird der Verzögerte Status angezeigt. Harmony versucht sechsmal, die Protokolle abzurufen, mit einer 10-sekündigen Pause zwischen den einzelnen Aufrufen. Aktualisieren oder überprüfen Sie die Protokolle später erneut. Sie können nicht nach Vorgängen mit dem Verzögerten Status filtern, diese werden aber in den Operation angezeigt.
Status des Vorgangsschritts
Operationsschritte werden nur angezeigt, wenn für diese Operation die debuggen auf Operation aktiviert ist (für Cloud-Agenten oder für private Vertreter) und der Operation wurde auf einem Agenten der Version 10.48 oder höher ausgeführt.
Operationsschritte können folgende Status haben:
- Abgeschlossen: Der Operation Schritt wurde ohne Fehler ausgeführt und abgeschlossen.
- Fehler: Der Operation Schritt wurde ausgeführt, konnte aber 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 seine Ausführung wartet oder dass in einem vorherigen Operation Schritt ein Fehler aufgetreten ist, der die Ausführung des folgenden Schrittes verhindert.
Betriebsprotokolltabelle
Die Operation zeigt die Operation unter Verwendung der ausgewählten Tabellensteuerelemente an. Wenn Operationen mit Operation verknüpft sind oder die RunOperation
Funktion, Protokolle für nachlegende Vorgänge sind ebenfalls enthalten.
Übergeordnete Vorgänge (und alle untergeordneten Vorgänge) werden in aufsteigender Reihenfolge nach Gestartet sortiert. Die Tabelle kann (nur für Vorgänge der obersten Ebene) nach Name, Gestartet, Beendet, Dauer oder Status sortiert werden, indem Sie auf die jeweilige Header klicken.
Es werden maximal 1000 Operation angezeigt. Um Protokolle für weitere Vorgänge anzuzeigen, passen Sie die Filter entsprechend an.
Tipp
Die grundlegende Konfiguration dessen, was in einem Operation enthalten sein soll, wird unter der Tab Optionen der Operation angegeben (siehe Betriebsoptionen). Weitere Protokollierungsoptionen anzeigen (für Cloud-Agenten oder für private Vertreter).
-
Name: Der Name der Operation oder des Operation Schritt. Der Bei übergeordneten Operationen und bei Operationen, für die Komponenten-Eingabe- und-Ausgabedaten verfügbar sind, werden Aufklappdreiecke angezeigt, mit denen sich zusätzliche Zeilen erweitern oder reduzieren lassen:
-
Übergeordnete Operationen: Wenn eine übergeordnete Operation erweitert wird, werden zusätzliche Zeilen für die untergeordneten Operationen in der Reihenfolge ihrer Ausführung angezeigt. Standardmäßig werden alle übergeordneten Operationen erweitert. Verwenden Sie die Liste reduzieren oder Erweitern Sie die Listensymbole neben der Suchleiste, um alle übergeordneten Vorgänge zu reduzieren oder zu erweitern.
-
Operation mit Ein- und Ausgabedaten: Beim Erweitern einer Operation mit Ein- und Ausgabedaten werden für jeden Operation Schritt zusätzliche Zeilen in der Reihenfolge ihrer Ausführung angezeigt. Weitere Informationen finden Sie unter Komponenten-Ein- und Ausgabedaten.
-
-
Eingabe/Ausgabe: Diese Spalte wird nur angezeigt, wenn die Tabelle einen Operation enthält, bei dem die debuggen auf Operation aktiviert ist (für Cloud-Agenten oder für private Vertreter) und der Operation wurde auf einem Agenten der Version 10.48 oder höher ausgeführt. Die über diesen Teil der Protokolltabelle abgerufenen Eingabe- und Ausgabedaten werden unter Ein- und Ausgabedaten der Komponenten beschrieben.
-
Gestartet: Datum und Uhrzeit des Beginns der Ausführung des Operation oder Operation Schritt, angezeigt als lokale Browserzeit.
-
Fertig: Datum und Uhrzeit, zu denen die Ausführung des Operation oder Operation Schritt beendet wurde, angezeigt als lokale Browserzeit.
-
Dauer: Die zwischen Start und Fertig verstrichene Zeit, angegeben in Sekunden für Vorgänge und in Millisekunden für Operation.
-
Status: Der Status der Operation oder des Operation Schritt. Eine vollständige Liste der möglichen Status finden Sie unter Operationsstatus weiter oben auf dieser Seite.
-
Aktionen: Diese Aktion ist verfügbar:
-
Operation abbrechen: Aktiviert für Vorgänge im Status Übermittelt, Empfangen, Ausstehend oder Wird ausgeführt.
Operation abbrechen sendet eine Anforderung an den Agenten, den Operation zu stoppen. Nach dem Klicken wird der Status Abbruch angefordert neben dem Echtzeit-Operation angezeigt.
Notiz
Vorgänge mit dem Status Abbruch angefordert können weiterhin ausgeführt werden.
-
-
Operationsprotokoll: Um ein Protokoll für eine einzelne Operation anzuzeigen oder auszublenden, klicken Sie irgendwo auf eine Operation, außer auf die Symbole in der Spalte Eingabe/Ausgabe (sofern vorhanden):
-
Quelldatensätze: Bei Verwendung eines FTP oder Datenbank als Quelle wird die Anzahl der Datensätze angezeigt, die aus dem Quellsystem gelesen wurden. Für andere Konnektoren lautet die Anzahl
0
unabhängig von der Anzahl der Quelldatensätze. -
Zieldatensätze: Bei Verwendung eines FTP oder Datenbank als Ziel wird die Anzahl der Datensätze angezeigt, die im Zielsystem veröffentlicht wurden. Für andere Konnektoren lautet die Anzahl
0
unabhängig von der Anzahl der Zieldatensätze. -
Protokollmeldungen: Protokollmeldungen enthalten die Protokolldetails zum ausgewählten Operation. Ob Protokollmeldungen angezeigt werden, hängt von den Berechtigungen und Zugriffsebenen des aktuellen Benutzers und davon ab, ob die Cloud-Protokollierung aktiviert ist. Weitere Informationen finden Sie unter Tab„Nachrichten“ in der Management Console Laufzeitvorgänge Seitendokumentation.
Hinweis
Die in den Protokollmeldungen angezeigten Datums- und Uhrzeitangaben werden nicht in die lokale Browserzeit konvertiert, sondern im Originalformat der Protokollquelle wiedergegeben.
-
Kopieren: Kopiert die Protokolldaten in die Zwischenablage.
-
Herunterladen: Lädt die Protokollmeldungen als Textdatei herunter.
-
Ein-/Ausblenden: Blendet die Protokollmeldungen ein oder aus.
-
Komponenten-Ein- und Ausgabedaten
Komponenteneingabe- und -ausgabedaten werden generiert, wenn für einen Operation die debuggen auf Operation aktiviert ist (für Cloud-Agenten oder für private Vertreter) und der Operation wurde auf einem Agenten der Version 10.48 oder höher ausgeführt.
Hinweis
Die Generierung von Komponenten-Ein- und Ausgabedaten wird von der Agentengruppeneinstellung Cloud-Logging aktiviert nicht beeinflusst. Die Eingabe- und Ausgabedaten der Komponenten werden in der Harmony-Cloud protokolliert, auch wenn die Cloud-Protokollierung deaktiviert ist.
Um die Generierung von Komponenten-Eingabe- und Ausgabedaten in einer privaten Agentengruppe zu deaktivieren, in der privaten Agentenkonfigurationsdatei unter dem [VerboseLogging]
Abschnitt, Satz verbose.logging.enable=false
.
Warnung
Wenn Komponenteneingabe- und -ausgabedaten generiert werden, werden alle Anforderungs- und Antwortdaten für diesen Operation in der Harmony Cloud protokolliert und verbleiben dort 30 Tage lang. Beachten Sie, dass personenbezogene Daten (PII) und sensible Daten wie Anmeldeinformationen in einer Payload in den Eingabe- und Ausgabedaten der Harmony Cloud-Protokolle im Klartext sichtbar sind.
Wenn Komponenteneingabe- und -ausgabedaten vorhanden sind, wird in der Operation eine Spalte Eingabe/Ausgabe mit einer grafischen Darstellung des Operation oder Operation Schritt angezeigt.
In der Spalte Eingabe/Ausgabe können Sie auf die Symbole für Aktivitäten und Transformations, die als Operation verwendet werden, klicken, um die Komponenten-Eingabe- und-Ausgabedaten für den jeweiligen Operation Schritt ein- oder auszublenden. Jeder Eingabe- und Ausgabeprotokolleintrag ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eingabe- oder Ausgabeprotokolleintrag 100 MB überschreiten, werden keine Daten angezeigt.
-
Suchen: Durchsucht die Daten nach dem eingegebenen Text.
-
Kopieren: Kopiert die Protokolldaten in die Zwischenablage.
-
Download: Lädt die Eingabe- oder Ausgabedaten als Datei im entsprechenden Datenformat herunter. Der Dateiname besteht aus dem Namen des Operation Schritt, gefolgt von
_input
oder_output
gegebenenfalls.