Skip to main content

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.

Drop down choices wrong city

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.

Tracer log with error detail

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.

Tracer log with error detail
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.

Tracer tool icon

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 de eventos do 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.

tracer event with highlighted row

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.

Tracer properties on Page

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.

Este conteúdo foi útil?

100% acharam esse conteúdo útil

Quer nos ajudar a melhorar esse conteúdo?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice