Módulo deste artigo: Message Monitor
Rastreie uma mensagem do SAP CPI etapa por etapa sem sair do designer de iFlows
O que o nível de log TRACE do SAP CPI registra, como ler o conteúdo antes de uma etapa no monitor e como seguir o caminho e o payload de uma mensagem no próprio diagrama do iFlow.
Quando um iFlow retorna o resultado errado, a pergunta quase sempre é a mesma: como estava a mensagem logo antes da etapa que deu errado? O SAP Cloud Integration (SAP CPI) consegue responder, mas só para mensagens processadas com o nível de log TRACE, e a resposta fica no monitor, a várias telas do diagrama que você está editando.
Este artigo explica o que um trace registra, como lê-lo no próprio monitor do SAP e como seguir o mesmo trace no diagrama, etapa por etapa, com o Kitegra.
O que um trace registra
Toda mensagem deixa um log de processamento de mensagens (MPL): o status, o início e o fim, e as etapas que executou. O nível de log do iFlow decide quanto detalhe entra nele.
| Nível de log | O que o log de processamento da mensagem guarda |
|---|---|
| Info | O status geral, os tempos e o erro, se houver |
| Debug | Uma entrada para cada etapa que a mensagem executou |
| Trace | O mesmo que Debug, mais o body, os headers e as exchange properties como estavam antes de cada etapa |
O conteúdo do trace serve para investigar, não para arquivar. O SAP o guarda por cerca de uma hora, e o próprio nível TRACE volta atrás depois de cerca de 10 minutos, então a mensagem que você quer ler precisa rodar logo depois que o TRACE é ativado. Como ele armazena payloads reais no tenant, use-o com dados de teste sempre que puder e siga as regras da sua empresa em produção. Por que o TRACE se desliga sozinho explica os limites.
Lendo um trace no monitor do SAP
- No monitor, abra Manage Integration Content, selecione o iFlow implantado e defina o nível de log dele como Trace.
- Envie a mensagem de novo nos minutos seguintes.
- Abra a mensagem em Monitor Message Processing e siga o link de trace até a execução do processamento da mensagem.
- Selecione uma etapa no diagrama da execução e abra o conteúdo da mensagem: headers, propriedades e payload.
Funciona, mas cada consulta a uma etapa custa alguns cliques, o diagrama da execução não é o que você está editando e, depois de 10 minutos, o nível de log precisa ser definido de novo.
Ative o TRACE pelo designer
Com o Kitegra, abra o iFlow no designer, clique no botão “Ferramentas do Kitegra” na barra de ferramentas do diagrama e escolha “Mensagens” (ou pressione Alt+Shift+M). O painel lista as últimas mensagens do iFlow no runtime que você escolher, agrupadas por dia, com status, horário de início e duração. Mensagens rastreadas levam uma marca TRACE, e as novas piscam quando chegam.
O interruptor do painel mostra “Trace: desligado”. Um clique define o nível de log do iFlow como TRACE, e o interruptor passa a mostrar “Trace: ligado” com uma contagem de minutos. Enquanto ele está ligado e você trabalha no iFlow, a extensão define o TRACE de novo antes que o SAP o derrube; ela para de renovar 20 minutos depois da sua última atividade. Desligar restaura o nível de log que o iFlow tinha antes.
O Trace é uma das quatro ações que alteram o seu tenant e, como as outras, só é executado quando você clica nele.
Siga a mensagem no diagrama
- Envie a mensagem, ou espere a próxima. Ela aparece no topo do painel “Mensagens”.
- Em uma mensagem rastreada, escolha “No diagrama”. As etapas por onde ela passou ficam coloridas, uma etapa com falha fica marcada e as etapas que ela não alcançou ficam esmaecidas.
- Clique em uma etapa colorida. O painel “Conteúdo antes da etapa” mostra o Body, os Headers e as “Propriedades de troca” como estavam antes daquela etapa, o Log da etapa e o Erro quando a etapa falhou.
- Use “Anterior” e “Próxima” para percorrer as etapas na ordem em que foram executadas. Uma etapa executada mais de uma vez, em um Splitter ou em um loop, mostra cada execução, por exemplo “Execução 2 de 3 desta etapa”.
- Quando terminar, escolha “Limpar as marcas do diagrama”.
Se a mensagem rodou sem TRACE, o painel avisa: o SAP guarda o body e os headers de uma mensagem apenas quando ela roda com TRACE, e só por cerca de uma hora.
Trabalhe com o que você encontrar
- O visualizador de payload mostra um body “Formatado” ou em “Uma linha”, pode “Quebrar linhas” e “Pesquisar”, e permite “Copiar” ou “Baixar”.
- “Comparar com a próxima etapa” abre dois bodies lado a lado em “Comparar payloads”, para você ver exatamente o que uma etapa mudou.
- “Tempos” colore as etapas pelo tempo que levaram, da mais rápida (verde) à mais lenta (vermelho); passe o mouse sobre uma etapa para ver o tempo dela.
- Em uma execução longa, “Etapas lidas” define quantas etapas são lidas para aquele iFlow, ou “Todas”.
- Em uma mensagem com falha, a aba “Resumo” diz onde ela falhou e, para erros conhecidos, “O que costuma significar:”.
Para abrir uma mensagem cujo ID você conhece, deste ou de qualquer outro iFlow do tenant, veja como encontrar uma mensagem do SAP CPI por Message ID ou Correlation ID.
Como o Kitegra ajuda
O Message Monitor é uma das cinco áreas do Kitegra. O conteúdo do trace é dado do cliente: a extensão o exibe na página e deixa você baixar um body, mas nunca o armazena, sincroniza ou envia para a Kitegra.
O Helper, o Message Monitor, o iFlow Inspector e o iFlow Docs contam, cada um, os iFlows em que você os usa: 5 por módulo sem uma conta Kitegra, 50 no plano Free, 100 no Starter e 300 no Pro; o Business não tem limite. A Toolbox e os extras do espaço de trabalho são gratuitos. Compare os planos.
Experimente no seu próximo iFlow
Veja o que o Kitegra acrescenta ao redor do designer do SAP Integration Suite, ou confira-o ao lado das outras extensões do Chrome da Kitegra.
Perguntas frequentes
Por que não consigo ver o payload da minha mensagem no SAP CPI?
O SAP guarda o body, os headers e as propriedades de uma mensagem apenas quando ela roda com o nível de log TRACE, e só por cerca de uma hora. Ative o TRACE, envie a mensagem de novo e leia o trace dentro dessa hora.
Quanto tempo o TRACE fica ligado no SAP CPI?
Cerca de 10 minutos. Depois disso, o iFlow volta para um nível de log mais baixo, e as mensagens deixam de ser rastreadas até que o TRACE seja definido de novo.
O que é o “conteúdo antes da etapa”?
É a mensagem como estava quando uma etapa começou: o body, os headers e as exchange properties. Compará-lo com o conteúdo da próxima etapa mostra o que a etapa mudou.
O trace deixa um iFlow mais lento?
Ele acrescenta trabalho, porque o conteúdo de cada etapa é gravado no tenant. Use-o enquanto investiga e desligue-o depois.
A extensão mantém o nível TRACE ligado para sempre?
Não. Ela renova o TRACE apenas enquanto o interruptor está ligado e você trabalha no iFlow, para 20 minutos depois da sua última atividade e restaura o nível anterior quando você o desliga.
A Kitegra armazena o conteúdo dos meus traces?
Não. O conteúdo do trace é exibido na página e pode ser baixado por você; ele nunca é armazenado, sincronizado nem enviado para a Kitegra.