Saltar al contenido

Historial de Eventos

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

  • 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.

El historial de eventos está disponible para los administradores a través de IDE > Monitoreo. El historial de eventos también está disponible para los desarrolladores de manera programática a través del objeto de datos públicos EventHistory. El objeto de datos públicos EventHistory expone las siguientes columnas:

  • EventHistoryId - Número entero que crece de manera monótona.
  • ContextId - Identificador único que se puede utilizar para correlacionar eventos que ocurren dentro de una sola 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 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 finalizó el evento, ya sea con éxito o no.
  • Duration - La duración de la ejecución del evento en milisegundos. Dado que muchos campos de marca de tiempo de 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. Las reglas pueden acceder a este valor a través de la función de tiempo de ejecución de mvSQL who('userid').
  • Bindings - Criterios de vinculación utilizados para recuperar la fila en la que se ejecutó el evento. Los criterios se serializan mediante codificación URL (por ejemplo, Nombre1=Valor1&Nombre2=Valor2). Las vinculaciones 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 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 que utilizan la función de tiempo de ejecución mvSQL session().
  • RowId - Identificador único de la fila en la que se invocó el evento. En el caso de una regla CRUD empresarial, esto hace referencia 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 para la fila de origen de inserción y actualización de CRUD empresarial. Las reglas de CRUD empresarial pueden acceder a este valor mediante la función de tiempo de ejecución de mvSQL event('source.rowid').

Nota

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