Rastreio no Jitterbit App Builder

Visão Geral

Rastreio é um recurso de diagnóstico disponível no App Builder que permite aos usuários desenvolvedores solucionar problemas em aplicações. O rastreio pode ser uma ferramenta instrumental para depurar problemas relacionados ao desempenho de um aplicativo, bem como para resolução de problemas. Existem várias maneiras de habilitar o recurso de rastreio, e ele é construído com mecanismos de desativação automática.

O rastreio deve ser preferencialmente utilizado em um ambiente de desenvolvimento, mas está disponível para uso em produção, se necessário. Por razões de desempenho, tente restringir a execução do rastreio em produção, a menos que seja absolutamente necessário.

Habilitar rastreio

Usuários que têm permissão para usar o rastreio podem acessá-lo a partir de várias localizações diferentes no App Builder.

A partir do perfil do usuário

O rastreio é armazenado no nível do Perfil do Usuário, então, se você for um Usuário Desenvolvedor, verá uma opção de Rastreio na página do seu Perfil do Usuário. Se o campo de Rastreio estiver marcado, então o recurso de Rastreio foi habilitado ou ativado para o Usuário associado.

A partir da segurança

O rastreio também pode ser habilitado ou ativado a partir de Segurança > Usuários. Um Usuário Desenvolvedor pode navegar até a área de Segurança do App Builder, para a tela de Usuários e abrir um registro de Usuário individual dessa área para acessar a opção de Rastreio. Se o campo de Rastreio estiver marcado, então o recurso de Rastreio foi habilitado ou ativado para o Usuário associado.

A partir do designer de páginas

Supondo que você tenha as permissões de Design corretas, você também pode acessar o Rastreio para uma página a partir da tela de design da página.

A partir do monitor

O rastreio também pode ser acessado tanto para habilitá-lo quanto para visualizar e interpretar os resultados a partir da tela de Monitor no App Builder. Para acessar aqui, você navega até Monitor > Desempenho. Uma vez aqui, você selecionará o Usuário para executar as informações de Rastreio e também definirá o Status como Ativado. Com o recurso Ativado, você fará com que o Usuário realize a atividade que você está buscando rastrear. Por exemplo, navegue até a(s) Página(s) em questão.

A ferramenta Trace captura métricas resultantes exibidas como o tempo mínimo, médio e máximo para cada tipo de métrica armazenada. Você pode clicar nas métricas e aprofundar-se para ver qual delas é a mais lenta.

• Menos de 1 segundo é verde
• De 1 a 2 segundos é amarelo
• Mais de 2 segundos é vermelho

Aprofundar-se em Painéis, por exemplo, mostra que a página do Construtor de Regras de Negócio é a mais lenta devido aos seguintes Painéis/Regras.

Reset trace

Resetar irá deletar as informações de rastreamento para o painel de filtro atual, permitindo que você remova informações que não são relevantes e, em seguida, realize novas ações e veja os resultados.

O status de Ligado ou Desligado é para o Usuário selecionado, neste caso, Administrador do Sistema.

Maintenance

Por padrão, todos os registros de rastreamento são armazenados no banco de dados do App Builder na tabela Dg_Trace. A cada hora, uma tarefa agendada é executada para deletar e purgar registros dessa tabela. Desde a versão 4.53, o modo de rastreamento é automaticamente desativado após 60 minutos.

Example use case

Um exemplo de caso de uso onde você pode usar o Trace para obter insights sobre o App Builder é rastrear um valor que está sendo alterado ao adicionar uma coluna a uma tabela.

Se adicionarmos uma nova Coluna a uma Tabela e simplesmente selecionarmos um Tipo de Dado Lógico de Moeda, esta é a aparência da tela no App Builder:

Vamos ver o que o App Builder registrou no Trace:

O primeiro evento foi o carregamento dos dados para a lista de seleção do tipo de dado Lógico. Você pode aprofundar-se e obter mais detalhes clicando na seta laranja.

Informa que houve ações executadas, vamos aprofundar mais.

O plugin de filtro foi executado, que é o que faz o carregamento real dos dados do banco de dados.

Agora você pode ver a instrução SQL que foi executada para retornar dados para a lista de Seleção.

Vamos voltar ao topo e ver a Mudança de Célula, isso é o que é executado quando o usuário selecionou o tipo de dado Currency na lista de seleção.

Você pode ver que os padrões e visibilidades também foram executados, e como a linha está laranja, isso nos informa que o estado da linha atual mudou.

Ao selecionar a linha de Padrões, é mostrado quais padrões foram alterados. Como selecionamos o Atual, esses valores foram definidos como padrão. Vamos aprofundar mais para ver quais regras de padrão causaram essas mudanças.

Você pode ver que 9 linhas de padrão foram executadas, enquanto 2 delas realmente resultaram na mudança do estado da linha atual. Db_Column_Physical_StorageDataTypeDefault alterou o StorageDataTypeId e depois, mais tarde, o Db_DefaultsByLogicalStorageDataType alterou a Precisão e Escala. Vamos aprofundar e ver o SQL que causou isso.

Aqui você pode ver que a cláusula where é usada, e que esse valor foi realmente definido como padrão anteriormente.