Tratar erros

Encaminhe os nós com falha para um caminho de erro, registre os detalhes do erro, tente novamente falhas temporárias e encerre o fluxo de trabalho corretamente em erros não recuperáveis.

O que você cria

Um fluxo de trabalho que roteia um nó com falha para um caminho separado, registra a falha com contexto útil, tenta novamente falhas temporárias onde isso faz sentido e termina sem problemas quando o erro não pode ser recuperado. O resultado é um padrão que se encaixa em qualquer fluxo de trabalho existente.

Antes de começar

• Um fluxo de trabalho existente com pelo menos um nó que pode falhar e possui uma guia Tratamento de erro , por exemplo, uma Solicitação HTTP ou um nó Extração.

Nós usados

• Solicitação HTTP: o nó que pode falhar neste exemplo.
• Script: registra os detalhes do erro.
• Encerrar: encerra o fluxo de trabalho em erros não recuperáveis.

Etapas

Dica:

Com um agente de codificação configurado, você pode ignorar as etapas manuais. Pergunte:

Add error handling to the HTTP Request node in this Maestro Automate workflow: connect its error path to a Script node that logs the error message, retry temporary failures, and end the run with a Terminate node when the error can't be recovered.

Em seguida, abra o fluxo de trabalho na tela, confira as etapas abaixo e teste. Configure seu agente de codificação descreve a configuração.

1. Conecte o identificador de erro do nó

Por padrão, um nó com falha interrompe todo o fluxo de trabalho. Em vez disso, para lidar com a falha:

1. Abra o fluxo de trabalho na tela e selecione o nó que pode falhar.
2. Abra a guia Tratamento de erros e ative Habilitar tratamento de erros. Um identificador de erro aparece abaixo do identificador de saída principal.
3. Selecione o + no identificador de Erro , pesquise Script e selecione-o.

Isso cria um caminho de erro. Quando o nó falhar, a execução segue esse caminho em vez de interromper o fluxo de trabalho. Um nó sem um identificador Erro não é compatível com o tratamento de erros e uma falha lá interrompe o fluxo de trabalho e aparece na aba Incidentes .

2. Registre o erro

No nó do Script no caminho do erro, leia o objeto de erro em $vars.<node>.error:

const error = $vars.httpRequest1.error;
console.log('Step failed:', error.message);
console.log('Code:', error.code, '| HTTP status:', error.status);
return { logged: true };

O objeto de erro é preenchido apenas no caminho de erro. A página Tratamento de erros lista o conjunto completo de campos de erros.

3. Tente novamente em caso de falhas transitórias (opcional)

Se houver probabilidade de a falha ser temporária, como uma interrupção de rede ou um limite de taxa, tentar novamente antes de parar ajuda. O nó de Solicitação HTTP tem novas tentativas integradas: configurar Contagem de novas tentativas em sua guia Avançado faz com que ele tente novamente a solicitação muitas vezes antes de disparar o identificador de erro. Apenas a falha final roteia para o caminho do erro.

AVISO:

Repetir apenas operações que podem ser executadas mais de uma vez com segurança. Tentar novamente um nó com efeitos colaterais, como escrever dados ou enviar uma mensagem, pode criar duplicatas.

4. Encerre se for irrecuperável

No caminho do erro, após o nó Script, adicione um nó Encerrar . Para retornar a descrição da falha, selecione Adicionar variável de saída no nó e dê a ela um valor que inclua o erro, por $vars.httpRequest1.error.message.

O fluxo de trabalho termina no nó Encerrar, e a execução é listada em Monitorar execuções.

5. Teste e Debug

Para disparar o caminho do erro intencionalmente:

1. Defina temporariamente o URL no nó de Solicitação HTTP para um valor inválido (por exemplo, https://this-will-fail.example.com).
2. Select Run Debug (▶) in the bottom toolbar of the canvas and verify that the execution trace follows the error path.
3. Restaure o URL correto.

Verifique a saída do console do nó do Script no trace para confirmar que os detalhes do erro estão registrados.

Resultado

O fluxo de trabalho roteia falhas para o caminho do erro, registra os detalhes do erro, opcionalmente, tenta novamente falhas temporárias e termina novamente com um status descritivo de falha. Um URL inválido no nó da Solicitação HTTP confirma que o caminho de erro funciona.

Estender este fluxo de trabalho

• Send an alert on failure: on the error path, before the Terminate node, add an HTTP Request or connector node to notify a Slack channel or create a ServiceNow incident.
• Continuar em vez de encerrar: se a etapa não for crítica, faça com que o caminho de erro defina um valor de fallback e participe novamente do caminho principal em vez de encerrar.
• Aplique esse padrão amplamente: a página Tratamento de erro descreve mais padrões, como registrar e continuar, valores de fallback e escalonamento.

Próximas Etapas

• Implantar um fluxo de trabalho: faça o fluxo de trabalho ser executado sem você.
• Guias: mais fluxos de trabalho para criar.
• Community: compartilhe o que você construiu ou peça ajuda a outros construtores.