Status de execução
Status disponíveis
No status, podemos ter os seguintes resultados:
- 🟢 Sucesso
- 🟠 Finalizado com divergência
- 🔴 Falha
- 🔴 Erro
- 🟠 Abortado
- ⚪️ Não finalizado
Conseguimos identificar falcilmente pelos icones, quando um dos passos for direrente de sucesso, o icone apresentado será o falha ou divergência.
Também é possível buscar aplicando o filtro do status.
Diferenciação nas falhas
Os fluxos podem finalizar com diferentes status, que indicam a natureza do problema ocorrido durante a execução.
A distinção entre fail, error e aborted é importante para:
- Observabilidade e métricas
- Alertas
- Análise de causa raiz
- Experiência do usuário
- Governança e SRE
🔴 Falha fail
Indica que o fluxo iniciou corretamente, mas falhou durante a execução por erro operacional ou falha em dependências externas.
Quando acontece
- Erro em chamada de API externa (HTTP 4xx/5xx)
- Falha de conexão com serviço externo (ex: API, banco de dados, SFTP, etc)
- Erro de autenticação em serviço externo
Característica principal
O fluxo estava corretamente configurado e executando, mas falhou por uma condição de runtime não controlada pelo usuário.
🔴 Erro error
Indica que o fluxo não pôde ser executado corretamente devido a erro estrutural ou de configuração.
Quando acontece
- Problema na parametrização do passo (incluindo problema em Template)
- Passo mal configurado (ex: operação/recurso, conexão não configurados)
- Configuração inválida de conector
- Erro de parsing ou validação antes da execução do passo
- Erro interno de execução do fluxo/passo
Característica principal
O problema é estrutural/configuracional e impede a execução adequada do fluxo.
🟠 Abortado aborted
Indica que a execução foi interrompida intencionalmente ou por política do sistema, sem caracterizar falha técnica do fluxo.
Quando acontece
- Política interna de cancelamento: fluxos assíncronos que excedem 29 minutos de execução são abortados automaticamente pelo sistema
- Usuário clicou em Parar (em Roadmap)
- Cancelamento manual via API (em Roadmap)
Característica principal
O fluxo foi interrompido de forma controlada, por decisão do usuário ou por regra da plataforma.
Resumo conceitual das falhas
Status | Tipo de problema | Origem | Natureza |
|---|---|---|---|
fail | Operacional | Runtime | Erro técnico durante execução |
error | Estrutural/configuração | Pré-execução (do fluxo ou de um passo) | Problema interno de configuração ou execução |
aborted | Interrupção controlada | Usuário ou sistema | Encerramento intencional |
Boas práticas
- Acompanhe execuções com erro com frequência para identificar problemas recorrentes.
- Utilize filtros para facilitar a triagem de execuções com falha.
- Ao identificar comportamentos inesperados, utilize os dados da execução para reproduzir o cenário e ajustar o fluxo.