Noções básicas de depuração

Depuração no fluxo na tela de compilação, cobrindo intervalos de execução, incidentes, inspeção de falhas e saída simulada para testar fluxos de trabalho isoladamente.

A depuração no Fluxo acontece na mesma tela em que você cria. Não há visualização de depuração separada — você executa seu processo, inspeciona os resultados no painel de execução e faz alterações quando identifica um problema.

Iniciar uma sessão de debug

O botão Debug na barra de ferramentas executa o processo. O painel de execução aparece na parte inferior da tela e são preenchidos em tempo real à medida que cada nó é executado.

O botão Parar encerra a sessão explicitamente. Qualquer alteração no processo também sai da sessão de depuração automaticamente.

Consulte A tela para obter uma visão geral completa dos controles de depuração e do layout do painel de execução.

Leitura do painel de execução

O painel de execução possui três guias. Cada uma responde a uma pergunta diferente.

Extensões

A aba Períodos mostra o rastreamento de execução — cada nó que foi executado, em ordem, com tempo e um indicador de sucesso ou falha. Selecionar um intervalo destaca o nó correspondente na tela, facilitando a ver exatamente onde a execução atingiu.

Incidentes

A aba Incidentes coleta erros que ocorreram durante a execução. Cada incidente nomeia o nó que falhou e inclui a mensagem de erro. Se seu processo parou de forma inesperada, verifique aqui primeiro.

Variáveis

A aba Variáveis mostra valores de variáveis de runtime. Selecione um período na guia Períodos e a guia Variáveis será atualizada para mostrar o estado nesse ponto da execução. Use isso para verificar se os nós upstream produziu os dados que você esperava.

Identificação de falhas

Após uma execução de depuração, cada nó na tela mostra um indicador de sucesso ou falha. A extensão do nó com falha na guia Períodos o destaca na tela. A aba Incidentes mostra a mensagem de erro. O painel de propriedades do nó com falha mostra o objeto de erro completo na seção de saída.

O objeto de erro inclui um campo message (descrição legível por humanos) e um campo detail (causa técnica). Comece com message porque ele contém o resumo de falha voltado para o usuário.

Uso de nós simulados

A saída simulada permite testar parte de um processo isoladamente. Quando você define uma saída simulada em um nó, ela pula a execução real e injeta seus dados de teste downstream.

Isso é útil quando um nó upstream é lento, requer credenciais não disponíveis localmente ou depende de sistemas externos. Clicar duas vezes no nó abre sua visualização expandida, onde a saída simulada pode ser definida como quaisquer dados que os nós subsequentes esperem.

Simular vários nós de uma só vez permite que a sessão de depuração se concentre em uma seção específica do processo.

Dicas

• Intervalos primeiro, incidentes depois. Os intervalos mostram a imagem de execução completa; os incidentes mostram apenas o que interrompeu.
• Os valores das variáveis revelam incompatibilidades de dados. Compare os dados que um nó recebeu com os dados que o próximo nó esperava.
• A simulação de dependências externas permite uma iteração mais rápida. Simular um nó que chama uma API ou dispara um processo de RPA permite que você depure a lógica sem esperar em sistemas externos.
• Pequenas iterações são mais rápidas. Uma correção por ciclo de depuração é mais eficiente do que tentar corrigir tudo de uma só vez.
• Os nomes de nós descritivos melhoram a legibilidade do trace. Nomes de nós de referência de intervalos e incidentes — nomes que descrevem o que um nó faz para facilitar a verificação dos traces de execução.

Páginas relacionadas

• A tela — controles de depuração completos e referência do painel de execução
• Tratamento de erros — configuração de ramificações de erro em nós
• Variáveis e fluxo de dados — como as variáveis funcionam entre nós