Zum Inhalt springen

Ereignisverlauf im Jitterbit App Builder

Einführung

App Builder zeichnet die Ereignisausführung in der Ereignisverlaufstabelle auf. Die folgenden Ereignisse werden protokolliert:

  • Im Hintergrund ausgeführte Ereignisse, unabhängig davon, ob sie geplant oder von einem Benutzer initiiert wurden.
  • Jedes Ereignis, das eine Ausnahme auslöst.
  • Jedes Ereignis, dessen Ausführung länger als 10 Sekunden dauert.

Ereignisverlauf

Der Ereignisverlauf steht Administratoren über die IDE > Überwachung zur Verfügung. Entwickler können den Ereignisverlauf auch programmatisch über das öffentliche Datenobjekt „EventHistory“ abrufen. Das öffentliche Datenobjekt „EventHistory“ enthält die folgenden Spalten:

  • EventHistoryId - Monoton zunehmende Ganzzahl.
  • ContextId - Eindeutige Kennung, die zur Korrelation von Ereignissen innerhalb einer einzelnen Operation, z. B. einer CRUD-Regel, verwendet werden kann. Dieser Wert ist für Regeln über die mvSQL Laufzeit event('contextid') zugänglich.
  • TableId - Die Tabelle, für die das Ereignis aufgerufen wurde.
  • EventName - Der Name des aufgerufenen Ereignisses.
  • Result - Das Ereignisergebnis. Mögliche Werte sind „Erfolgreich“, „Fehler“ und „Abgebrochen“.
  • StartedOn - Datum und Uhrzeit der Auslösung des Ereignisses.
  • CompletedOn - Datum und Uhrzeit des erfolgreichen oder nicht erfolgreichen Endes des Ereignisses.
  • Duration - Die Dauer der Ereignisausführung in Millisekunden. Da viele SQL-Zeitstempelfelder keine Millisekundengenauigkeit aufweisen, kann dieser Wert von dem Wert abweichen, der sich aus der Subtraktion von „StartedOn“ und „CompletedOn“ ergibt.
  • RanAsUserId - Die Kennung des Benutzerprinzipals, unter dem das Ereignis ausgeführt wurde. Dieser Wert ist für Regeln über die who('userid') mvSQL- Laufzeit.
  • Bindings - Bindungskriterien zum Abrufen der Zeile, für die das Ereignis ausgeführt wurde. Die Kriterien werden mithilfe der URL Kodierung serialisiert (z. B. Name1=Wert1&Name2=Wert2). Bindungen sind nicht für alle Ereignisse verfügbar.
  • Exception - Ausnahmemeldung, wenn das Ereignis aufgrund einer Exception fehlgeschlagen ist. Dieser Wert ist für Aktionsfehlerhandler über die mvSQL- Laufzeit event('exception') zugänglich.
  • SessionId - Bei einem benutzerinitiierten Ereignis die Sitzungskennung des Benutzers. Bei einem geplanten Ereignis eine temporäre Sitzungskennung. Dieser Wert ist für Regeln über die mvSQL- Laufzeit session() zugänglich.
  • RowId - Eindeutige Kennung für die Zeile, für die das Ereignis ausgelöst wurde. Bei einer Business-CRUD-Regel bezieht sich dies auf die Zielzeilenkennung. Dieser Wert ist für Regeln über die mvSQL Laufzeit event('rowid') zugänglich.
  • SourceRowId - Eindeutige Kennung für die Quellzeile des Business-CRUD-Inserts und-Updates. Dieser Wert ist für Business-CRUD-Regeln über die mvSQL Laufzeit event('source.rowid') zugänglich.

Hinweis

Der Eintrag wird nach der Ausführung des Ereignisses in den Ereignisverlauf geschrieben. Daher kann das Ereignis selbst nicht auf seinen Verlaufseintrag zugreifen.

Aufbewahrung des Ereignisverlaufsprotokolls

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

Um die Aufbewahrungsdauer des Ereignisprotokolls zu ändern, führen Sie die folgenden Schritte aus:

  1. Wählen Sie IDE > Überwachung.
  2. Klicken Sie im Bereich Protokolle auf die Schaltfläche Ereignisprotokolle.
  3. Klicken Sie auf die Schaltfläche ** Schaltfläche „Konfigurieren“.
  4. Geben Sie im Dialogfeld „Aufbewahrungsrichtlinie“ in der Spalte „Verlaufsaufbewahrungstage“ die Anzahl der Tage ein, die die Protokolle „Abgebrochen“, „Fehler“ oder „Erfolgreich“ aufbewahrt werden sollen.
  5. Schließen Sie das Dialogfeld.