Rastreamento¶

Visão Geral¶

Tracing é um recurso de diagnóstico disponível em App Builder que permite que Usuários Desenvolvedores diagnosticar e resolver problemas de aplicativos. O rastreamento pode ser uma ferramenta instrumental para depurar problemas relacionados ao desempenho em um aplicativo, bem como usá-lo para diagnosticar e resolver problemas problemas que não estão funcionando como esperado em um aplicativo. Para Usuários que têm permissão para usar o recurso Rastreamento, ele pode ser acessado de vários locais diferentes em App Builder, conforme descrito neste artigo.

Idealmente, o Trace é um recurso usado em um ambiente de Desenvolvimento, mas está disponível para uso em Produção, se necessário. Por motivos de desempenho, tente restringir a execução do Trace em Produção, a menos que seja absolutamente necessário. Se habilitado, o recurso Trace se desabilitará automaticamente após uma hora de inatividade para um Usuário para o qual foi habilitado. Isso é por design.

Por padrão, todos os registros de rastreamento são armazenados no App Builder banco de dados no Dg_Trace tabela. A cada hora, uma tarefa agendada é executada para excluir e limpar registros desta tabela.

Para Habilitar o Rastreamento do Perfil do Usuário¶

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

Para Habilitar o Rastreamento de Segurança¶

O rastreamento também pode ser habilitado ou ligado em Segurança > Usuários. Um Usuário Desenvolvedor pode navegar até a área Segurança de App Builder, para a tela Usuários e abra um registro de Usuário individual desta área para acessar a opção Rastreamento. Se o campo Rastreamento estiver marcado, o recurso Rastreamento foi habilitado ou ligado para o Usuário associado.

Para Habilitar o Rastreamento do Designer de Página¶

Supondo que você tenha as permissões de Design corretas, você também pode detalhar o Tracing para uma página na tela de design de página.

Para Habilitar e Acessar o Rastreamento do Monitor¶

O rastreamento também pode ser acessado para habilitá-lo e também para visualizar e interpretar os resultados da tela Monitor em App Builder. Para acessar aqui, navegue até Monitor > Desempenho. Uma vez aqui, você selecionará o Usuário para executar as informações de Rastreamento e também definirá o Status como Ativado. Com o recurso Ativado, você tem o Usuário e então executa a atividade que está procurando rastrear. Por exemplo, navegue até a(s) Página(s) em questão.

O utilitário Trace captura métricas resultantes exibidas como tempo mínimo, médio e máximo para cada tipo de métrica sendo armazenada. Você pode clicar nas métricas e detalhar para ver qual é a mais lenta.

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

Drill into Panels, por exemplo, mostra que a página Business Rule Builder é a mais lenta por causa dos seguintes Painéis/Regras.

Para Redefinir o Rastreamento¶

Reset excluirá as informações de rastreamento do painel de filtro atual, permitindo que você remova informações que não lhe interessam e, em seguida, execute novas ações e veja os resultados.

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

Manutenção¶

O rastreamento é removido após uma hora de disponibilidade, pois muitas informações são armazenadas no Dg_Trace tabela.

Após uma hora de inatividade na web por um Usuário, o rastreamento será desativado para esse Usuário.

Exemplo de Caso de Uso¶

Um exemplo de caso de uso em que você pode usar o Trace para obter insights sobre App Builder está rastreando 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 em App Builder:

Vamos ver o que App Builder logado Trace:

O primeiro evento foi carregar os dados para a lista de seleção de Logical coluna de tipo de dados. Você pode detalhar e obter mais detalhes clicando na seta laranja.

Diz que houve ações executadas, vamos detalhar mais.

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

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

Vamos voltar ao topo e ver a mudança de célula, é isso que é executado quando o usuário seleciona o Currency tipo de dados da lista de seleção.

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

Ao selecionar a linha Padrões, ela mostra quais padrões foram alterados. Como selecionamos Atual, esses valores foram padronizados. Vamos detalhar mais para ver quais regras padrão causaram essas alterações.

Você pode ver que 9 linhas padrão foram executadas, enquanto 2 delas realmente resultaram na alteração do estado atual das linhas. Db_Column_Physical_StorageDataTypeDefaultmudou o StorageDataTypeId e depois mais tarde Db_DefaultsByLogicalStorageDataType altere a Precisão e a Escala. Vamos detalhar e ver o SQL que causou isso.

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