Tracer
O Tracer é uma ferramenta disponível na Pega Platform que ajuda na resolução de problemas. Quando ocorre um erro em um aplicativo, é preciso identificar a fonte. Ao visualizar os eventos que levaram ao erro, é possível encontrar a causa raiz e resolver o problema.
Por exemplo, uma declare expression usada para definir um valor de propriedade pode retornar um valor inesperado. Esse valor de propriedade é usado para determinar se um estágio particular do fluxo de trabalho deve ser ignorado. O usuário nota que o caso avança para um estágio inesperado e descobre que a propriedade declare expression não é exibida na IU. A ferramenta Tracer documenta a sequência dos eventos de execução que permitem ao usuário resolver este erro.
Visualização de eventos com o Tracer
Para visualizar eventos quando um caso é processado, utilize a ferramenta Tracer para capturar e visualizar cada evento. Por exemplo, o aplicativo usa uma página de dados para preencher uma lista do dropdown de cidades. Se o conteúdo da lista do dropdown estiver incorreto, por exemplo, se a lista incluir um estado no lugar de uma cidade, é preciso determinar se o controle ou a conexão com a fonte de dados apresenta uma configuração imprópria.
A ferramenta Tracer e a ferramenta Área de transferência
Conforme o aplicativo é executado, a Pega Platform™ registra todos os eventos de processamento que resultem da execução do aplicativo. Diferente da ferramenta Área de transferência (Clipboard), que apresenta o valor atual das propriedades na memória, o Tracer apresenta um registro completo dos eventos que ocorrem durante o processamento de um caso. Esse registro permite identificar a fonte dos erros de execução, como exceções de Java ou valores incorretos de propriedade.
No centro da imagem a seguir, deslize a linha vertical para comparar a ferramenta Área de transferência e a ferramenta Tracer.
Cuidado: A execução do Tracer tem um impacto significativo no desempenho do aplicativo em razão do volume de dados coletados para execução das regras. Como melhor prática, não use o Tracer como uma ferramenta de análise de desempenho. Para saber mais sobre o uso da ferramenta Tracer, consulte Melhores práticas do Tracer.
Identificação de erros no processamento de casos
A coluna Status no registro do Tracer ajuda a identificar as etapas de processamento que levam a um erro. No registro do Tracer, a maioria das etapas retorna o status Bom (Good), indicando que a etapa foi concluída com sucesso. Caso uma etapa retorne um status de Falha (Fail), a etapa é concluída de forma malsucedida. A imagem a seguir mostra a ferramenta Tracer exibindo uma etapa com falha.
Um erro em um aplicativo pode indicar somente a última etapa de uma sequência de etapas com falha, mas não a causa da sequência da falha. A análise da sequência de eventos no Tracer ajuda a identificar a causa raiz que leva ao erro visto pelos usuários. Na ferramenta Tracer, quando você clica na etapa com falha, as propriedades do evento são exibidas.
Nota: Para saber mais sobre a identificação da causa raiz dos erros, consulte Rastreamento e captura de eventos.
Verifique seus conhecimentos com a interação a seguir.
Investigue os erros do aplicativo com a ferramenta Tracer
Ao configurar o Tracer para monitorar a execução do aplicativo, é possível investigar problemas e eventos registrados pelo Tracer para identificar suas causas.
O Tracer exibe cada evento em uma linha separada. Os registros são exibidos de acordo com o seguinte código de cores:
- Cinza – Processamento de atividades
- Laranja – Eventos de regras de fluxo, decisão ou declarativas
- Azul claro – Banco de dados PegaRULES e operações de cache
Nota: Para obter mais informações sobre os registros que o Tracer exibe, consulte Janela de resultados do Tracer.
Ícone do Tracer
O acesso ao Tracer é feito alternando a barra de ferramentas Runtime no App Studio. Passe o ponteiro do mouse sobre o canto inferior direito da tela para ver a opção Toggle runtime toolbar. Ou acesse a ferramenta Tracer na barra de ferramentas Developer no Dev Studio.
Eventos do Tracer
Cada evento é registrado em ordem de ocorrência e é identificado por uma thread, tipo de evento e status. As colunas Name e Ruleset identificam o nome da regra e ruleset relacionado para cada item da linha.
Na imagem a seguir, clique nos ícones + para saber mais detalhes sobre as colunas Name e Ruleset .
Detalhes do evento
Clique em uma linha dentro da ferramenta Tracer para visualizar os detalhes sobre o evento em uma nova janela. Nessa janela, é possível ver o conteúdo na memória no momento em que o evento ocorreu, como a classe de página e o nome da página. Ao finalizar a análise das propriedades do evento, feche a janela e retorne à ferramenta Tracer.
Propriedades e valores de página
A seleção de um item da linha na coluna Step Page exibe uma lista de propriedades de página e seus valores no momento em que um evento é executado. Essas informações podem ser usadas para determinar se os valores são diferentes do esperado. Por exemplo, o item da linha do evento 11391 mostra um método indefinido da etapa na coluna Step Method.
Exemplos de propriedades
O usuário clica em pwWorkPage na coluna Step Page do evento 11391 para exibir as propriedades que são armazenadas na página de trabalho no momento em que o evento é executado.
Verifique seus conhecimentos com a interação a seguir.
This Topic is available in the following Module:
If you are having problems with your training, please review the Pega Academy Support FAQs.
Quer nos ajudar a melhorar esse conteúdo?