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

Histórico de eventos

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 em uma única operação, como uma regra CRUD empresarial. Este valor pode ser acessado por regras usando a função de tempo de execução mvSQL event('contextid').
  • TableId - A tabela na qual o evento foi invocado.
  • EventName - Nome do evento invocado.
  • Result - O resultado do evento. Os valores possíveis incluem Sucesso, Erro e Cancelado.
  • StartedOn - Data e hora em que o evento foi invocado.
  • CompletedOn - Data e hora em que o evento foi encerrado, com sucesso ou não.
  • Duration - A duração da execução do evento em milissegundos. Como muitos campos de carimbo de data/hora SQL não têm precisão de milissegundos, esse número pode ser diferente do valor obtido pela subtração de StartedOn de CompletedOn.
  • RanAsUserId - O identificador do usuário principal sob o qual o evento foi executado. Este valor é acessível às regras por meio do who('userid') Função de tempo de execução mvSQL.
  • 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). As vinculações não estão disponíveis para todos os eventos.
  • Exception - Mensagem de exceção caso o evento tenha falhado devido a uma exceção. Este valor pode ser acessado por manipuladores de falhas 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 pode ser acessado por regras usando a função de tempo de execução session() do mvSQL.
  • RowId - Identificador exclusivo para a linha na qual o evento foi invocado. No caso de uma regra CRUD empresarial, refere-se ao identificador da linha de destino. Este valor pode ser acessado pelas 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 de negócios. Este valor pode ser acessado pelas regras de CRUD de negócios usando a função de tempo de execução mvSQL event('source.rowid').

Nota

A entrada é gravada 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 de registro de histórico de eventos

Desde o App Builder 4.43, você pode alterar por quanto tempo os registros do 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 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 Cancelado, Erro ou Sucesso.
  5. Feche a caixa de diálogo.