Ir para o conteúdo

Histórico de Eventos

App Builder registra a execução do evento na tabela de histórico de eventos. Os seguintes eventos são registrados:

  • Eventos executados em segundo plano, sejam eles agendados ou iniciados por um usuário.
  • Qualquer evento que gere uma exceção.
  • Qualquer evento que leve mais de 10 segundos para ser executado.

O histórico de eventos está disponível para administradores por meio do IDE > Monitoramento. O histórico de eventos também está disponível para desenvolvedores programaticamente por meio do objeto de dados públicos EventHistory. O objeto de dados públicos EventHistory expõe as seguintes colunas:

  • EventHistoryId - Inteiro monotonicamente crescente.
  • ContextId - Identificador exclusivo que pode ser usado para correlacionar eventos que ocorrem dentro de uma única operação, como uma regra CRUD de negócios. Este valor é acessível para regras usando a função de tempo de execução mvSQL event('contextid').
  • TableId - A tabela na qual o evento foi invocado.
  • EventName - O nome do evento invocado.
  • Result - O resultado do evento. Os valores possíveis incluem Success, Error e Cancelled.
  • StartedOn - A data e hora em que o evento foi invocado.
  • CompletedOn - A data e hora em que o evento terminou, com sucesso ou não.
  • Duration - A duração da execução do evento em milissegundos. Como muitos campos de timestamp SQL não têm precisão de milissegundos, esse número pode diferir do valor derivado subtraindo StartedOn de CompletedOn.
  • RanAsUserId - O identificador do principal do usuário sob o qual o evento foi executado. Este valor é acessível às regras por meio da função de tempo de execução mvSQL who('userid').
  • Bindings - Critérios de vinculação usados para recuperar a linha na qual o evento foi executado. Os critérios são serializados usando codificação de URL (por exemplo, Nome1=Valor1&Nome2=Valor2). Vinculações não estão disponíveis para todos os eventos.
  • Exception - Mensagem de exceção se o evento falhou como resultado de uma exceção. Este valor é acessível a manipuladores de falha de ação usando a função de tempo de execução mvSQL event('exception').
  • SessionId - No caso de um evento iniciado pelo usuário, o identificador de sessão do usuário. No caso de um evento agendado, um identificador de sessão efêmero. Este valor é acessível para regras usando a função de tempo de execução session() mvSQL.
  • RowId - Identificador exclusivo para a linha na qual o evento foi invocado. No caso de uma regra CRUD de negócios, isso se refere ao identificador da linha de destino. Esse valor é acessível para regras usando a função de tempo de execução mvSQL event('rowid').
  • SourceRowId - Identificador exclusivo para a linha de origem de Inserção e Atualização do CRUD empresarial. Este valor é acessível para regras de CRUD empresarial usando a função de tempo de execução mvSQL event('source.rowid').

Nota

A entrada é escrita no histórico de eventos após o evento ter sido executado. Como consequência, o próprio evento não pode acessar sua entrada de histórico.