Debuggen für private Jitterbit-Agenten

Einführung

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

Vorsicht

Die debuggen Protokollierung für Vorgänge wird hauptsächlich zum Debuggen von Problemen während des Tests verwendet und sollte in einer Umfeld nicht aktiviert werden. Die generierten debuggen-Protokolldateien können umfangreich und/oder groß sein.

Auf privaten Agenten Aktivieren der debuggen Protokollierung für 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 für Operation entweder für eine einzelne Integration Studio oder Design Studio Operation oder für alle Operationen auf einem privaten Agenten über die Konfigurationsdatei eines Agenten aktiviert wird. 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 in den Bereinigungsregeln des Agenten konfigurierten Aufbewahrungsrichtlinie, die standardmäßig einen Tag beträgt.

• Komponenten-Ein- und Ausgabedaten: Daten, die in ein Integration Studio Operation geschrieben werden, wenn die debuggen-Protokollierung für eine Integration Studio Operation aktiviert ist, die 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 sensible Daten wie Anmeldeinformationen in einer Payload in den Eingabe- und Ausgabedaten der Harmony Cloud-Protokolle 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 Protokollierung von Operation nicht aktiviert ist, werden nur erfolglose API Vorgänge in den Operation.

  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 debuggen-Protokollierung

Die debuggen Protokollierung von Vorgängen kann für einen [einzelnen Operation] aktiviert werden.#operationdebuglogging-single-operation) oder auf einen 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 Konfigurationsdatei des privaten Agenten.

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 umfangreichen und/oder großen Dateien führen kann.

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

• Integration Studio: Wählen Sie im Aktionsmenü einer Operation Einstellungen aus. Wählen Sie im Tab Optionen die Option Debug-Modus aktivieren bis und legen Sie ein Datum für die Deaktivierung der debuggen-Protokollierung fest. Sie können die Einstellungen des debuggen-Modus auch auf untergeordnete Operationen übertragen.

• 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 die Option Debug-Modus aktivieren bis und legen Sie ein Datum fest, bis zu dem die debuggen Protokollierung deaktiviert werden soll.

Dieses Datum ist auf zwei Wochen ab dem aktuellen Datum begrenzt. Die debuggen des Vorgangs wird zu Beginn dieses Datums (d. h. um 0:00 Uhr) entsprechend der Zeitzone des Agenten deaktiviert.

Komplett privater Agent

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

Vorsicht

Das Aktivieren der debuggen Protokollierung auf Agentenebene kann sehr große Dateien im Verzeichnis jedes privaten Agenten innerhalb der privaten Agentengruppe erzeugen. Wenn Sie Probleme mit einem einzelnen Operation haben, sollten Sie stattdessen die debuggen Protokollierung für einen einzelnen Operation aktivieren.

Um die debuggen Protokollierung zu aktivieren, bearbeiten Sie die private Agent-Konfigurationsdatei wie folgt und starten Sie anschließend 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 Protokollierung so schnell wie möglich und löschen Sie die Dateien, wenn sie nicht mehr benötigt werden.

Zusätzliche Einstellungen

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

[VerboseLogging]
verbose.logging.enable=true

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

Um die Generierung von Komponenten-Ein- und Ausgabedaten zu deaktivieren, müssen Sie Folgendes hinzufügen: [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] Dieser Abschnitt sollte nur auf Anweisung des Jitterbit-Supports geändert werden.

Debuggen-Protokolldateien für Vorgänge

Sobald die debuggen-Protokollierung für Operation bei einer Integration Studio Operation, einer Design Studio Operation oder einem gesamten privaten Agenten aktiviert ist, werden bei der Ausführung dieser Operationen debuggen - Protokolldateien für die entsprechenden Operationen generiert.

Zugriff auf die Debug-Protokolldatei

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

WindowsLinux

C:\Program Files\Jitterbit Agent\DataInterchange\Temp\Debug

/usr/local/jitterbit/DataInterchange/Temp/Debug

Um das Verzeichnis des debuggen-Protokolls für den Operation zu ändern, bearbeiten Sie die Konfigurationsdatei des privaten Agenten wie folgt und starten Sie anschließend die Jitterbit-Dienste neu:

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

Aufbewahrungsrichtlinie für Debug-Protokolldateien

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

Dieser Zeitraum ist konfigurierbar in CleanupRules.xml, das auf privaten Agenten an diesen Standardspeicherorten zugänglich ist:

WindowsLinux

C:\Program Files\Jitterbit Agent

/usr/local/jitterbit/

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

Die debuggen Protokolldateien enthalten debuggen für jede Operation und Informationen, die vor und nach jeder Transformation protokolliert werden. Informationen zu anderen Aktionen wie dem Lesen und Schreiben aus dem Harmony Cache sind ebenfalls enthalten.

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

Komponenten-Ein- und Ausgabedaten

Komponenteneingabe- und -ausgabedaten werden generiert, wenn ein Integration Studio Operation mit aktivierter Operation debuggen-Protokollierung 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.

Achtung

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 für eine Agentengruppe zu deaktivieren, in der privaten Agenten-Konfigurationsdatei unter dem [VerboseLogging] Abschnitt, Satz verbose.logging.enable=false.

Zugriff auf Eingabe- und Ausgabedaten

Auf die Eingabe- und Ausgabedaten der Komponenten kann über das Integration Studio Bildschirm „Operation “ zugegriffen werden. oder die Runtime Operations der Management Console-Seite in zusätzlichen Tabellenzeilen, die für jeden Operation Schritt mit Eingabe- und Ausgabedaten angezeigt werden. In der Spalte Eingabe/Ausgabe können Sie auf die Symbole für Aktivitäten und Transformations klicken, die als Operation verwendet werden, 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 herunter. Der Dateiname besteht aus dem Namen des Operation Schritt, gefolgt von _input oder _output soweit zutreffend.

Richtlinie zur Aufbewahrung von Eingabe- und Ausgabedaten

Die Eingabe- und Ausgabedaten der Komponenten werden von Harmony 30 Tage lang gespeichert.

Ein- und Ausgabedateninhalte

Für bestimmte Schritte einer Operation werden Komponenteneingabe- und -ausgabedaten generiert. Die Daten sind der Funktion eines Schritts angemessen. 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 sowie 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 Ausführung der Transformation.

Eingabe- und Ausgabedaten gelten nicht für Scripts, wenn diese als Operation verwendet werden. Script, wie sie beispielsweise vom WritetoOperationLog Funktion, wird in den Logmeldungen eines Operation angezeigt.

Fehlerbehebung bei Eingabe- und Ausgabedaten

Auf Agent zu den Ein- und Ausgabedaten muss normalerweise nicht zugegriffen werden. Wenn Sie vermuten, dass bei der Generierung der Ein- 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 über jitterbit --help.