Zum Inhalt springen

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

Einführung

Die Betrieb Debug-Protokollierung erzeugt zusätzliche diagnostische Informationen, um bei der Fehlersuche zu helfen. Diese Funktion produziert zwei Arten von Daten:

  • Komponenten-Eingabe- und Ausgabedaten: Die Anforderungs- und Antwortdaten, die von jeder Aktivität und Transformation in einem Betrieb verarbeitet werden. Harmony speichert diese Daten 30 Tage lang.

  • API-Anforderungsdaten: Detaillierte Informationen zu API-Aufrufen für Operationen, die durch einen API-Manager benutzerdefinierte API oder OData-API ausgelöst werden, einschließlich API-Name, Anforderungsmethode, Quell-IP, Gateway-Details und Anrufverfolgungsdaten. Für Details, wann diese Daten in Protokollen erscheinen, siehe API-Anforderungsdaten.

Warnung

Wenn Komponenten-Eingabe- und Ausgabedaten erzeugt werden, werden alle Anforderungs- und Antwortdaten für diesen Betrieb 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.

Aufgrund dieser Sicherheitsimplikationen sollte die Betrieb Debug-Protokollierung nur zur Fehlersuche bei Problemen während der Tests verwendet werden. Aktivieren Sie diese Funktion nicht in einer Produktionsumgebung.

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 Betriebsoptionen wählen Sie Debug-Modus aktivieren bis und setzen Sie ein Datum, an dem die Debug-Protokollierung deaktiviert werden soll.

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

Warnung

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

Betrieb Protokolle anzeigen

Wenn Sie das Debug-Protokoll für Operationen aktivieren, können Sie die Betrieb Protokolle an zwei Orten einsehen:

  • Studio-Betriebsprotokolle: Protokolle über das Menü Protokolle anzeigen der Operation im Studio einsehen.
  • Laufzeitseite: Protokolle auf der Management Console Laufzeit Seite einsehen.

Beide Standorte zeigen Betriebsprotokolle mit Komponenten-Eingabe- und Ausgabedaten (wenn verfügbar) und API-Anforderungsdaten (wenn die Operation durch eine benutzerdefinierte API des API-Managers ausgelöst wird). Anforderungs- und Antwortpayloads werden nur angezeigt, wenn auch das ausführliche API-Protokoll aktiviert ist.

Komponenten-Eingabe- und Ausgabedaten

Komponenten-Eingabe- und Ausgabedaten werden generiert, wenn eine Studio-Operation, die Debug-Protokollierung für Operationen aktiviert hat, auf der Ebene der Operation ausgeführt wird. Eingabe- und Ausgabedaten sind nur für Aktivitäten und Transformationen verfügbar, die als Operation Schritte verwendet werden.

Vorsicht

Die Generierung von Komponenten-Eingabe- und Ausgabedaten wird nicht von der Agentengruppeneinstellung Cloud-Protokollierung aktiviert beeinflusst. Komponenten-Eingabe- und Ausgabedaten werden in der Harmony-Cloud protokolliert, auch wenn die Cloud-Protokollierung deaktiviert ist.

Zugriff auf Eingabe- und Ausgabedaten

Auf Komponenten-Eingabe- und Ausgabedaten kann über den Protokollbildschirm der Operation im Studio oder die Laufzeit Seite der Management Console zugegriffen werden, in zusätzlichen Tabellenzeilen, die für jeden Operation Schritt angezeigt werden, der Eingabe- und Ausgabedaten hat. In der Eingabe/Ausgabe-Spalte können Symbole für Aktivitäten und Transformationen, die als Operation Schritte verwendet werden, angeklickt werden, um die Komponenten-Eingabe- und Ausgabedaten für diesen einzelnen Operation Schritt anzuzeigen oder auszublenden. Jeder Eingabe- und Ausgabeeintrag 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

  • Suche: Durchsuchen 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 Operation-Schrittes gefolgt von _input oder _output benannt, je nach Bedarf.

Eingabe- und Ausgabedatenaufbewahrungsrichtlinie

Die Eingabe- und Ausgabedaten der Komponenten werden von Harmony für 30 Tage aufbewahrt.

Inhalte der Eingabe- und Ausgabedaten

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

Eingabe- und Ausgabedaten werden für diese Komponenten generiert, die als Operation-Schritte 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 diese als Operation-Schritte verwenden. Der Skriptinhalt, wie er durch die Funktion WritetoOperationLog erzeugt wird, wird in den Protokollnachrichten eines Betriebsprotokolls angezeigt.

API-Anforderungsdaten

Neue Analytics-Oberfläche erforderlich

Die Funktion für API-Anforderungsdaten ist nur für Organisationen verfügbar, die auf die neue Analytics -Oberfläche aktualisiert wurden. Dieses Upgrade wird schrittweise eingeführt. Wenn Sie an einem frühen Zugang interessiert sind, kontaktieren Sie den Jitterbit-Support.

Wenn eine Operation durch eine API-Manager benutzerdefinierte API oder OData-API ausgelöst wird, hängt die Menge der in den Betriebsprotokollen angezeigten Informationen von den aktivierten Einstellungen ab:

Einstellungen aktiviert Protokollierte Informationen So aktivieren Sie
Keine (Standard)
  • Nur fehlgeschlagene Vorgänge im Studio Vorgangsprotokolle.
  • Sowohl erfolgreiche als auch fehlgeschlagene Vorgänge mit API-Anforderungsinformationen auf der Seite Management Console Laufzeit.
 Dies ist das Standardverhalten.
Vorgangs-Debug-Protokollierung Sowohl erfolgreiche als auch fehlgeschlagene Vorgänge mit API-Anforderungsinformationen in den Studio Vorgangsprotokollen und auf der Seite Management Console Laufzeit. Anforderungs- und Antwortpayload sind ausgeschlossen.
Vorgangs-Debug-Protokollierung und API-Detailprotokollierung Sowohl erfolgreiche als auch fehlgeschlagene Vorgänge mit API-Anforderungsinformationen in den Studio Vorgangsprotokollen und auf der Seite Management Console Laufzeit, einschließlich Anforderungs- und Antwortpayload. Aktivieren Sie die Vorgangs-Debug-Protokollierung für Cloud-Agenten oder private Agenten, und aktivieren Sie im API-Manager die Detailprotokollierung im Einstellungs-Tab der API.

api information

API-Informationen

Das Vorgangsprotokoll kann die folgenden Informationen für API-Aufrufe anzeigen:

  • API-Informationen: Details zum API-Aufruf, einschließlich API-Name, API-Typ, Anforderungsmethode, API-Anforderungs-ID, Quell-IP, API-Gateway, API-Dienst-URL und Quellanwendung. Für Feldbeschreibungen siehe API-Informationen.

  • Aufrufinformationen: Die HTTP-Anforderungsheader, die mit dem API-Aufruf gesendet werden, wie accept, accept_encoding, content_length, fulluri, host, user_agent und Weiterleitungsheader.

  • Aufrufprotokoll: Verfolgungsinformationen über die Verarbeitung von API-Anfragen.