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. Los siguientes eventos se registran:

  • Eventos ejecutados 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 administradores a través de IDE > Monitoreo. El historial de eventos también está disponible para desarrolladores de manera programática a través del objeto de datos público EventHistory. El objeto de datos público EventHistory expone las siguientes columnas:

  • EventHistoryId - Entero que aumenta monotonamente.
  • ContextId - Identificador único que se puede utilizar para correlacionar eventos que ocurren dentro de una sola operación, como una regla CRUD de negocio. Este valor es accesible para las reglas utilizando la función de tiempo de ejecución mvSQL event('contextid').
  • TableId - La tabla sobre la cual se ha invocado 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 terminó el evento, exitoso o no.
  • 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 en milisegundos, este número puede diferir del valor derivado 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 la función de tiempo de ejecución mvSQL who('userid').
  • Bindings - Criterios de enlace utilizados para recuperar la fila sobre la cual se ejecutó el evento. Los criterios se serializan utilizando codificación URL (por ejemplo, Name1=Value1&Name2=Value2). Los enlaces no están disponibles para todos los eventos.
  • Exception - Mensaje de excepción si el evento falló como resultado de una excepción. Este valor es accesible para los controladores de fallos de acción utilizando la función de tiempo de ejecución 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 utilizando la función de tiempo de ejecución mvSQL session().
  • RowId - Identificador único para la fila sobre la cual se invocó el evento. En el caso de una regla CRUD de negocio, esto se refiere al identificador de la fila objetivo. Este valor es accesible para las reglas utilizando la función de tiempo de ejecución mvSQL event('rowid').
  • SourceRowId - Identificador único para la fila de origen de inserción y actualización de CRUD de negocio. Este valor es accesible para las reglas CRUD de negocio utilizando la función de tiempo de ejecución mvSQL event('source.rowid').

Nota

La entrada se escribe en el historial de eventos después de que el evento se ha ejecutado. Como consecuencia, el evento en sí no puede acceder a su entrada en el historial.

Retención del registro del historial de eventos

Desde App Builder 4.43, puedes cambiar cuánto tiempo se conservan los registros del historial de eventos.

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

  1. Selecciona IDE > Monitoreo.
  2. En el panel Registros, haz clic en el botón Registros de Eventos.
  3. Haz clic en el botón Configurar.
  4. En el diálogo Política de Retención, bajo la columna Días de Retención del Historial, ingresa el número de días para conservar los registros de Cancelados, Errores o Éxitos.
  5. Cierra el diálogo.