Saltar al contenido

Historial de eventos en Jitterbit App Builder

Introducción

App Builder registra la ejecución de eventos en la tabla de historial de eventos. Se registran los siguientes eventos:

  • Eventos que se ejecutan en segundo plano, ya sea programados o iniciados por un usuario.
  • Cualquier evento que genere una excepción.
  • Cualquier evento que tarde más de 10 segundos en ejecutarse.

Historial de eventos

El historial de eventos está disponible para los administradores a través de IDE > Monitorización. El historial de eventos también está disponible para los desarrolladores mediante programación a través del objeto de datos públicos EventHistory. Este objeto expone las siguientes columnas:

  • EventHistoryId - Número entero monótonamente creciente.
  • ContextId - Identificador único que permite correlacionar eventos que ocurren dentro de una misma operación, como una regla CRUD empresarial. Las reglas pueden acceder a este valor mediante la función de tiempo de ejecución de mvSQL event('contextid').
  • TableId - La tabla en la que se invocó el evento.
  • EventName - El nombre del evento invocado.
  • Result - El resultado del evento. Los valores posibles incluyen Éxito, Error y Cancelado.
  • StartedOn - La fecha y hora en que se invocó el evento.
  • CompletedOn - La fecha y hora en que finalizó el evento, con o sin éxito.
  • Duration - La duración de la ejecución del evento en milisegundos. Dado que muchos campos de marca de tiempo SQL carecen de precisión de milisegundos, este número puede diferir del valor obtenido al restar StartedOn de CompletedOn.
  • RanAsUserId - El identificador del usuario principal bajo el cual se ejecutó el evento. Este valor es accesible para las reglas a través de who('userid') Función de tiempo de ejecución mvSQL.
  • Bindings - Criterios de vinculación utilizados para recuperar la fila donde se ejecutó el evento. Los criterios se serializan mediante codificación URL (p. ej., Nombre1=Valor1&Nombre2=Valor2). Las vinculaciones no están disponibles para todos los eventos.
  • Exception - Mensaje de excepción si el evento falló debido a una excepción. Este valor es accesible para los controladores de errores de acción mediante la función de tiempo de ejecución de mvSQL event('exception').
  • SessionId - En el caso de un evento iniciado por el usuario, el identificador de sesión del usuario. En el caso de un evento programado, un identificador de sesión efímero. Este valor es accesible para las reglas mediante la función de tiempo de ejecución session() de mvSQL.
  • RowId - Identificador único de la fila donde se invocó el evento. En el caso de una regla CRUD empresarial, se refiere al identificador de la fila de destino. Las reglas pueden acceder a este valor mediante la función de tiempo de ejecución de mvSQL event('rowid').
  • SourceRowId - Identificador único de la fila de origen de inserción y actualización de CRUD empresarial. Este valor es accesible para las reglas de CRUD empresarial mediante la función de tiempo de ejecución de mvSQL event('source.rowid').

Nota

La entrada se escribe en el historial de eventos una vez ejecutado. Por lo tanto, el evento no puede acceder a su entrada del historial.

Retención del registro del historial de eventos

Desde App Builder 4.43, puedes cambiar el tiempo durante el cual se conservan los registros del historial de eventos.

Para cambiar el período de retención del registro de eventos, siga estos pasos:

  1. Seleccione IDE > Monitoreo.
  2. En el panel Registros, haga clic en el botón Registros de eventos.
  3. Haga clic en el botón ** Botón Configurar.
  4. En el cuadro de diálogo Política de retención, en la columna Días de retención del historial, introduzca el número de días que se conservarán los registros de Cancelado, Error o Éxito.
  5. Cierre el cuadro de diálogo.