Zum Inhalt springen

Betrieb-Debug-Protokollierung für Jitterbit-Cloud-Agenten

Einführung

Betrieb-Debug-Protokolle sind zusätzliche Protokolldateien und Daten, die für Operationen generiert werden, wenn die Betrieb-Debug-Protokollierung aktiviert ist.

Vorsicht

Die Betrieb-Debug-Protokollierung wird hauptsächlich zur Fehlersuche während der Tests verwendet und sollte in einer Produktionsumgebung nicht aktiviert werden.

Bei Cloud-Agenten kann das Aktivieren der Debug-Protokollierung für eine Operation zur Generierung von zwei Arten von Protokollen führen:

  • Komponenten-Eingabe- und Ausgabedaten: Daten, die in ein Studio-Betriebsprotokoll geschrieben werden, wenn die Betrieb-Debug-Protokollierung für eine Operation aktiviert ist. Die Daten werden von Harmony 30 Tage lang aufbewahrt.

    Warnung

    Wenn Komponenten-Eingabe- und Ausgabedaten generiert werden, werden alle Anforderungs- und Antwortdaten für diese Operation in der Harmony-Cloud protokolliert und bleiben dort 30 Tage lang. Personenbezogene Daten (PII) und sensible Daten wie Anmeldeinformationen, die in einer Anforderungsnutzlast bereitgestellt werden, sind im Klartext in den Eingabe- und Ausgabedaten innerhalb der Harmony-Cloud-Protokolle sichtbar.

  • API-Betriebsprotokolle: Betriebsprotokolle für sowohl erfolgreiche als auch erfolglose API-Operationen (konfiguriert für benutzerdefinierte APIs oder OData-Dienste). Wenn die Betrieb-Debug-Protokollierung nicht aktiviert ist, werden nur erfolglose API-Operationen in den Betriebsprotokollen protokolliert.

Aktivieren der Betrieb-Debug-Protokollierung

Sie können die Debug-Protokollierung für eine einzelne Studio- oder Design-Studio-Operation mit diesen Schritten aktivieren:

  • Studio: Verwenden Sie das Aktionsmenü einer Operation, um Einstellungen auszuwählen. Im Tab Optionen wählen Sie Debug-Protokollierung aktivieren bis und setzen Sie ein Datum, an dem die Debug-Protokollierung deaktiviert werden soll. Die Option, die Debug-Modus-Einstellungen 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. Im Fenster Operationseinstellungen wählen Sie Debug-Modus aktivieren bis und legen Sie ein Datum fest, an dem das Debug-Logging deaktiviert werden soll.

Dieses Datum ist auf 2 Wochen ab dem aktuellen Datum begrenzt. Das Debug-Logging der Operation wird zu Beginn dieses Datums (d.h. um 00:00 Uhr) unter Verwendung der Zeitzone des Agents deaktiviert.

Warnung

Bei Cloud-Agent-Gruppen ist die Dauer dieser Einstellung unzuverlässig. Protokolle können vor dem Ende des ausgewählten Zeitraums nicht mehr erstellt werden.

Komponenteneingabe- und -ausgabedaten

Komponenteneingabe- und -ausgabedaten werden generiert, wenn eine Studio-Operation, die Debug-Logging für die Operation aktiviert, auf der Ebene der Operation ausgeführt wird. Eingabe- und Ausgabedaten sind nur für Aktivitäten und Transformationen verfügbar, die als Operationselemente verwendet werden.

Vorsicht

Die Generierung von Komponenteneingabe- und -ausgabedaten wird nicht von der Agentgruppeneinstellung Cloud-Logging aktiviert beeinflusst. Komponenteneingabe- und -ausgabedaten werden in der Harmony-Cloud protokolliert, auch wenn das Cloud-Logging deaktiviert ist.

Zugriff auf Eingabe- und Ausgabedaten

Auf die Komponenteneingabe- und -ausgabedaten kann über den Betriebsprotokollbildschirm im Studio oder die Seite Laufzeit der Management-Konsole zugegriffen werden, in zusätzlichen Tabellenzeilen, die für jedes Operationselement angezeigt werden, das Eingabe- und Ausgabedaten hat. In der Spalte Eingabe/Ausgabe können die Symbole für Aktivitäten und Transformationen, die als Operationselemente verwendet werden, angeklickt werden, um die Komponenteneingabe- und -ausgabedaten für dieses einzelne Operationselement anzuzeigen oder auszublenden. Jeder Eintrag im Eingabe- und Ausgabenprotokoll ist auf 100 MB begrenzt. Wenn die Daten für einen einzelnen Eingabe- oder Ausgabeeintrag 100 MB überschreiten, werden keine Daten angezeigt.

logs table operation steps header

  • Suchen: Suchen Sie die Daten nach dem eingegebenen Text.
  • Kopieren: Kopiert die Protokolldaten in Ihre Zwischenablage.
  • Herunterladen: Lädt die Eingabe- oder Ausgabedaten herunter. Die Datei wird mit dem Namen des Operationselements gefolgt von _input oder _output entsprechend benannt.

Eingabe- und Ausgabedatenaufbewahrungsrichtlinie

Komponenten-Eingabe- und Ausgabedaten werden von Harmony 30 Tage lang aufbewahrt.

Eingabe- und Ausgabedateninhalte

Komponenten-Eingabe- und Ausgabedaten werden für bestimmte Schritte eines Vorgangs generiert. Die Daten sind entsprechend der Funktion eines Schrittes. Die Eingabe ist die Struktur, die die Komponente konsumiert, während die Ausgabe die Struktur ist, die die Komponente produziert.

Eingabe- und Ausgabedaten werden für diese Komponenten generiert, die als Vorgangsschritte verwendet werden:

  • Aktivitäten: Eingabe- und Ausgabedaten sowie alle zugehörigen Informationen für die Ausführung der Aktivität. Einige Aktivitäten können mehrere Eingabe- und Ausgabedateien haben.
  • Transformationen: Eingabe- und Ausgabedaten für die Ausführung der Transformation.

Eingabe- und Ausgabedaten sind nicht anwendbar auf Skripte, wenn sie als Vorgangsschritte verwendet werden. Der Skriptinhalt, wie er durch die Funktion WritetoOperationLog erzeugt wird, wird in den Protokollnachrichten eines Vorgangsprotokolls angezeigt.