Betriebs- debuggen für private Jitterbit-Agenten

Einführung

Bei den debuggen für Vorgänge handelt es sich um zusätzliche Protokolldateien und Daten, die für Vorgänge generiert werden, wenn die debuggen für Operation aktiviert ist.

Auf privaten Agenten: Aktivieren der debuggen von Operation kann zur Generierung von drei Arten von Protokollen führen:

• Operation- debuggen Protokolldateien: Dateien, die in ein privates Agentenverzeichnis geschrieben werden und generiert werden, wenn die debuggen von Operation entweder auf einem einzelnen Integration Studio oder Design Studio Operation oder für alle Operationen auf einem privaten Agenten über die Konfigurationsdatei eines Agenten. Die Dateien sind direkt auf privaten Agenten zugänglich und können über die Management Console Agenten heruntergeladen werden und Runtime Operations Seiten. Die Dateien unterliegen der Aufbewahrungsrichtlinie, die in den Bereinigungsregeln des Agenten konfiguriert ist und standardmäßig 1 Tag beträgt.

• Komponenten-Eingabe- und Ausgabedaten: Daten geschrieben in an Integration Studio Operation, wenn die debuggen aktiviert ist auf an Integration Studio Operation, der auf einem privaten Agenten der Version 10.48 oder höher ausgeführt wird. Die Daten werden von Harmony 30 Tage lang gespeichert.

  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 vertrauliche Daten wie in einer Payload bereitgestellte Anmeldeinformationen in den Eingabe- und Ausgabedaten in den Harmony Cloud-Protokollen im Klartext sichtbar sind.

• API Operationsprotokolle: Operationsprotokolle für erfolgreiche und erfolglose API Operationen (konfiguriert für benutzerdefinierte APIs oder OData Dienste). Wenn die debuggen von Operation nicht aktiviert ist, werden nur erfolglose API Vorgänge in den Operation protokolliert.

  Notiz

  Die Schritte zum Aktivieren der Protokollierung aller API -Operationen für den gesamten Agenten unterscheiden sich von den unter Gesamter privater Agent beschriebenen Schritten weiter unten auf dieser Seite. Informationen zum Aktivieren der API Operation für den gesamten Agenten finden Sie unter API Operation.

Aktivieren der Operation debuggen

Die debuggen von Vorgängen kann für einen einzelnen Operation aktiviert werden oder auf einem vollständig privaten Agenten. Komponenten-Eingabe- und Ausgabedaten werden standardmäßig auf privaten Agenten 10.48 oder höher generiert, können aber mit zusätzlichen Einstellungen deaktiviert werden in der privaten Agentenkonfigurationsdatei.

Operation

Die debuggen-Protokollierung auf Vorgangsebene kann hilfreich sein, wenn Sie Probleme mit einem einzelnen Operation haben und die debuggen Protokollierung nicht auf Agentenebene aktivieren müssen, da dies zu zahlreichen und/oder sehr großen Dateien führen könnte.

Sie können die debuggen für einen einzelnen Operation aktivieren, indem Sie entweder Integration Studio Operation oder Design Studio Operation:

• Integration Studio: Verwenden Sie das Aktionsmenü einer Operation, um Einstellungen auszuwählen. Wählen Sie auf der Tab Optionen Debugmodus aktivieren bis und legen Sie ein Datum fest, bis zu dem die debuggen deaktiviert werden soll. Die Option, die debuggen auf alle untergeordneten Operationen zu übertragen, ist ebenfalls verfügbar.

• Design Studio: Klicken Sie mit der rechten Maustaste auf den Hintergrund einer beliebigen Operation und wählen Sie Optionen. Wählen Sie im Fenster Operationsoptionen Debugmodus aktivieren bis und legen Sie ein Datum fest, bis zu dem die debuggen deaktiviert werden soll.

Dieses Datum ist auf 2 Wochen ab dem aktuellen Datum begrenzt. Die debuggen von Vorgängen wird zu Beginn dieses Datums (also um 00:00 Uhr) in der Zeitzone des Agenten deaktiviert.

Gesamter privater Agent

Die debuggen von Operation auf Agentenebene kann über die private Agentenkonfigurationsdatei aktiviert werden für alle Vorgänge, die auf einem privaten Agenten ausgeführt werden.

Um die debuggen Protokollierung zu aktivieren, bearbeiten Sie die private Agent-Konfigurationsdatei wie folgt und starten Sie dann die Jitterbit-Dienste neu.

• Unter dem [TransformationEngine] Abschnitt, Satz WriteLog=true.

• Unter dem [OperationEngine] Abschnitt, Satz Debug=true.

Die in diesem Verzeichnis erstellten Dateien können sehr groß werden. Deaktivieren Sie die debuggen so schnell wie möglich und löschen Sie die Dateien, wenn Sie sie nicht mehr benötigen.

Zusätzliche Einstellungen

Private Agenten der Version 10.48 und höher verfügen über den Abschnitt [VerboseLogging] in ihrer privaten Agentenkonfigurationsdatei vorhanden mit der Einstellung verbose.logging.enable=true, das die Generierung von Komponenten-Eingabe- und Ausgabedaten ermöglicht:

[VerboseLogging]
verbose.logging.enable=true

Beim Upgrade einer früheren privaten Agentenversion auf 10.48 oder höher wird die Generierung von Eingabe- und Ausgabedaten standardmäßig automatisch aktiviert, auch wenn die [VerboseLogging] und der verbose.logging.enable Einstellung sind in der Konfigurationsdatei nicht vorhanden.

Um die Generierung von Komponenteneingabe- und -ausgabedaten zu deaktivieren, müssen Sie die [VerboseLogging] Abschnitt und Satz verbose.logging.enable=false um zu verhindern, dass Komponenten-Ein- und-Ausgabedaten in der Harmony Cloud protokolliert werden.

Zusätzliche Einstellungen im [VerboseLogging] Abschnitt sollte nicht geändert werden, es sei denn, der Jitterbit-Support fordert Sie dazu auf.

Debuggen Protokolldateien für Vorgänge

Sobald die debuggen für Operation aktiviert ist auf an Integration Studio Bei der Ausführung dieser Operation, Operation mit Design Studio Operation oder gesamten privaten Agenten werden debuggen Protokolldateien für die entsprechenden Operationen generiert.

Zugriff auf Debug-Protokolldateien

Der Zugriff auf die debuggen Protokolldateien für den Betrieb erfolgt über das Symbol Agentenprotokolle herunterladen auf der Management Console Agentenseite, die Tab Debugdateien der Management Console Runtime Operations oder direkt auf dem Agent Host an den folgenden Speicherorten:

Um das Verzeichnis des debuggen für Operation zu ändern, bearbeiten Sie die private Agentkonfigurationsdatei wie folgt und starten Sie dann die Jitterbit-Dienste neu:

• Unter dem [TransformationEngine] Abschnitt, Satz WriteLogDir zum gewünschten Verzeichnisspeicherort.

Aufbewahrungsrichtlinie für Debugprotokolldateien

Standardmäßig werden debuggen Protokolldateien für Operation nach einem Tag automatisch gelöscht.

Dieser Zeitraum ist konfigurierbar in CleanupRules.xml, auf das über private Agenten an diesen Standardstandorten zugegriffen werden kann:

Im Rahmen der CleanupRules.xml Datei können Sie diese Bereinigungsregel bearbeiten, um die Aufbewahrungsrichtlinie für das debuggen des Operation zu ändern:

  <CleanupRule>
      <DirectoryPath SearchSubDirectory = "YES" >DataInterchange/Temp/Debug</DirectoryPath>
      <Pattern>*</Pattern>
      <FileAge NumDays = "1" Comparator = "GE"/>
      <FileSize Size = "0" Comparator = "GE"/>
  </CleanupRule>

Inhalt der Debug-Protokolldatei

debuggen für Vorgänge enthalten debuggen für jede Operation und enthalten Informationen, die vor und nach der Ausführung jeder Transformation protokolliert werden. Informationen zu anderen Aktionen wie Lesen aus und Schreiben in den Harmony Cache sind ebenfalls enthalten.

Diese Dateien werden normalerweise vom Jitterbit-Support angefordert, wenn bei der Fehlerbehebung weitere Informationen benötigt werden.

Komponenten-Eingabe- und Ausgabedaten

Komponenten-Eingabe- und Ausgabedaten werden generiert, wenn an Integration Studio Operation, bei dem debuggen des Operation aktiviert ist auf Operation wird auf einem privaten Agenten der Version 10.48 oder höher ausgeführt, der auch über die Standardkonfigurationseinstellungen verfügt. Eingabe- und Ausgabedaten sind nur für Aktivitäten und Transformations verfügbar, die als Operation verwendet werden.

Zugriff auf Eingabe- und Ausgabedaten

Der Zugriff auf die Ein- und Ausgabedaten der Komponenten erfolgt über Integration Studio Operation-Bildschirm oder die Runtime Operations der Management Console-Seite in zusätzlichen Tabellenzeilen, die für jeden Operation Schritt angezeigt werden, der Eingabe- und Ausgabedaten hat. In der Spalte Eingabe/Ausgabe können Symbole für Aktivitäten und Transformations, die als Operation verwendet werden, angeklickt werden, um die Komponenteneingabe- und -ausgabedaten für diesen einzelnen Operation Schritt anzuzeigen oder auszublenden. Jeder Eingabe- und Ausgabeprotokolleintrag ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eingabe- oder Ausgabeprotokolleintrag 100 MB überschreiten, werden keine Daten angezeigt.

• Suchen: Durchsucht die Daten nach dem eingegebenen Text.
• Kopieren: Kopiert die Protokolldaten in Ihre Zwischenablage.
• Download: Lädt die Eingabe- oder Ausgabedaten herunter. Der Dateiname besteht aus dem Namen des Operation Schritt, gefolgt von _input oder _output je nach Bedarf.

Richtlinie zur Aufbewahrung von Eingabe- und Ausgabedaten

Komponenten-Ein- und Ausgabedaten werden von Harmony 30 Tage lang gespeichert.

Ein- und Ausgabedateninhalte

Für bestimmte Schritte einer Operation werden Komponenteneingabe- und -ausgabedaten generiert. Die Daten sind für die Funktion eines Schritts geeignet. Die Eingabe ist die Struktur, die die Komponente verwendet, während die Ausgabe die Struktur ist, die die Komponente erzeugt.

Für diese als Operation verwendeten Komponenten werden Ein- und Ausgabedaten generiert:

• Aktivitäten: Eingabe- und Ausgabedaten und alle zugehörigen Informationen zur Ausführung der Aktivität. Einige Aktivitäten können mehrere Eingabe- und Ausgabedateien haben.

• Transformations: Eingabe- und Ausgabedaten für die Durchführung der Transformation.

Eingabe- und Ausgabedaten sind nicht auf Scripts anwendbar, wenn sie als Operation verwendet werden. Script, wie sie von der WritetoOperationLog Funktion, wird in den Log-Meldungen eines Operation angezeigt.

Fehlerbehebung bei Eingabe- und Ausgabedaten

Auf Agent, die sich auf die Eingabe- und Ausgabedaten beziehen, muss normalerweise nicht zugegriffen werden. Wenn Sie glauben, dass beim Generieren der Eingabe- und Ausgabedaten ein Problem vorliegt, können Sie die Protokolldateien des Verbose Log Shipper-Dienstes auf einem privaten Agenten überprüfen:

<JITTERBIT_HOME>/VerboseLogShipper/verbose-log-shipper.out.log

Der Verbose Log Shipper-Dienst kann durch den Neustart eines privaten Agenten neu gestartet werden.

Auf privaten Linux Agenten können Sie diesen Dienst auch mit diesen Jitterbit-Befehlszeilenoptionen deaktivieren und wieder aktivieren:

jitterbit start_verboselogshipper

jitterbit stop_verboselogshipper

Diese Optionen können auch angezeigt werden mit jitterbit --help.