Ir para o conteúdo

Histórico de eventos no Jitterbit App Builder

Introdução

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

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

Histórico de eventos

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

  • EventHistoryId - Inteiro que aumenta monotonamente.
  • ContextId - Identificador único 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 a 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 Sucesso, Erro e Cancelado.
  • StartedOn - A data e hora em que o evento foi invocado.
  • CompletedOn - A data e hora em que o evento foi encerrado, seja 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 em milissegundos, esse número pode diferir do valor derivado pela subtração de StartedOn de CompletedOn.
  • RanAsUserId - O identificador do principal do usuário sob o qual o evento foi executado. Este valor é acessível a regras via a 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, Name1=Value1&Name2=Value2). As 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 da sessão do usuário. No caso de um evento agendado, um identificador de sessão efêmero. Este valor é acessível a regras usando a função de tempo de execução mvSQL session().
  • RowId - Identificador único 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 alvo. Este valor é acessível a regras usando a função de tempo de execução mvSQL event('rowid').
  • SourceRowId - Identificador único para a linha de origem de Inserção e Atualização do CRUD de negócios. Este valor é acessível a regras CRUD de negócios usando a função de tempo de execução mvSQL event('source.rowid').

Nota

A entrada é registrada no histórico de eventos após a execução do evento. Como consequência, o próprio evento não pode acessar sua entrada no histórico.

Retenção do log de histórico de eventos

Desde o App Builder 4.43, é possível alterar por quanto tempo os logs de histórico de eventos são mantidos.

Para alterar o período de retenção do log de eventos, siga estas etapas:

  1. Selecione IDE > Monitoramento.
  2. No painel Logs, clique no botão Logs de Eventos.
  3. Clique no botão Configurar.
  4. Na caixa de diálogo Política de Retenção, na coluna Dias de Retenção do Histórico, insira o número de dias para manter os logs de Cancelados, Erro ou Sucesso.
  5. Feche a caixa de diálogo.