Zum Inhalt springen

Ereignishistorie im Jitterbit App Builder

Einführung

Der App Builder protokolliert die Ausführung von Ereignissen in der Ereignishistorientabelle. Die folgenden Ereignisse werden protokolliert:

  • Ereignisse, die im Hintergrund ausgeführt werden, unabhängig davon, ob sie geplant oder von einem Benutzer initiiert wurden.
  • Jedes Ereignis, das eine Ausnahme auslöst.
  • Jedes Ereignis, das länger als 10 Sekunden zur Ausführung benötigt.

Ereignishistorie

Die Ereignishistorie ist für Administratoren über IDE > Überwachung verfügbar. Die Ereignishistorie ist auch für Entwickler programmgesteuert über das öffentliche Datenobjekt EventHistory verfügbar. Das öffentliche Datenobjekt EventHistory stellt die folgenden Spalten zur Verfügung:

  • EventHistoryId - Monoton wachsender Integer.
  • ContextId - Eindeutiger Identifikator, der verwendet werden kann, um Ereignisse zu korrelieren, die innerhalb einer einzelnen Operation wie einer Geschäfts-CRUD-Regel auftreten. Dieser Wert ist für Regeln über die mvSQL-Laufzeitfunktion event('contextid') zugänglich.
  • TableId - Die Tabelle, auf der das Ereignis aufgerufen wurde.
  • EventName - Der Name des aufgerufenen Ereignisses.
  • Result - Das Ergebnis des Ereignisses. Mögliche Werte sind Erfolg, Fehler und Abgebrochen.
  • StartedOn - Das Datum und die Uhrzeit, zu der das Ereignis aufgerufen wurde.
  • CompletedOn - Das Datum und die Uhrzeit, zu der das Ereignis beendet wurde, erfolgreich oder anders.
  • Duration - Die Dauer der Ausführung des Ereignisses in Millisekunden. Da viele SQL-Zeitstempelfelder keine Millisekundenpräzision aufweisen, kann diese Zahl von dem Wert abweichen, der durch Subtrahieren von StartedOn von CompletedOn abgeleitet wird.
  • RanAsUserId - Der Identifikator des Benutzerprinzips, unter dem das Ereignis ausgeführt wurde. Dieser Wert ist für Regeln über die mvSQL-Laufzeitfunktion who('userid') zugänglich.
  • Bindings - Bindungskriterien, die verwendet werden, um die Zeile abzurufen, auf der das Ereignis ausgeführt wurde. Die Kriterien werden mit URL-Codierung serialisiert (z. B. Name1=Value1&Name2=Value2). Bindungen sind nicht für alle Ereignisse verfügbar.
  • Exception - Ausnahmemeldung, wenn das Ereignis aufgrund einer Ausnahme fehlgeschlagen ist. Dieser Wert ist für Aktionsfehlerbehandler über die mvSQL-Laufzeitfunktion event('exception') zugänglich.
  • SessionId - Im Falle eines benutzerinitiierten Ereignisses der Sitzungsidentifikator des Benutzers. Im Falle eines geplanten Ereignisses ein flüchtiger Sitzungsidentifikator. Dieser Wert ist für Regeln über die mvSQL-Laufzeitfunktion session() zugänglich.
  • RowId - Eindeutiger Identifikator für die Zeile, auf der das Ereignis aufgerufen wurde. Im Falle einer Geschäfts-CRUD-Regel bezieht sich dies auf den Zielzeilenidentifikator. Dieser Wert ist für Regeln über die mvSQL-Laufzeitfunktion event('rowid') zugänglich.
  • SourceRowId - Eindeutiger Identifikator für die Geschäfts-CRUD-Insert- und Update-Quellzeile. Dieser Wert ist für Geschäfts-CRUD-Regeln über die mvSQL-Laufzeitfunktion event('source.rowid') zugänglich.

Hinweis

Der Eintrag wird in die Ereignishistorie geschrieben, nachdem das Ereignis ausgeführt wurde. Folglich kann das Ereignis selbst nicht auf seinen Historieneintrag zugreifen.

Ereignishistorie Protokollaufbewahrung

Seit App Builder 4.43 können Sie ändern, wie lange Ereignishistorieprotokolle aufbewahrt werden.

Um den Aufbewahrungszeitraum für das Ereignisprotokoll zu ändern, befolgen Sie diese Schritte:

  1. Wählen Sie IDE > Überwachung.
  2. Klicken Sie im Panel Protokolle auf die Schaltfläche Ereignisprotokolle.
  3. Klicken Sie auf die Schaltfläche Konfigurieren.
  4. Geben Sie im Dialogfeld Aufbewahrungsrichtlinie unter der Spalte Tage der Historieaufbewahrung die Anzahl der Tage ein, um Abgebrochen, Fehler oder Erfolg Protokolle aufzubewahren.
  5. Schließen Sie das Dialogfeld.