Execuções, logs e falhas
VPS Agêntica
O mesmo ambiente do SetupVibe, agora numa VPS
Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
Uma execução é uma única run de um flow, sempre num estado definido, com os logs, os outputs e as métricas de cada task guardados para consulta. Retries, a lista errors, a marcação allowFailure e o limite de concorrência decidem o que acontece quando uma etapa falha ou quando as execuções se acumulam.
Sumário da página
A pergunta da manhã seguinte
O relatório mensal que deveria estar pronto às sete não está. No cron, a resposta depende de um arquivo de log que o script talvez tenha gravado. No Kestra, a lista de execuções do flow mostra quando a execução começou, quanto tempo levou e o estado final, com o detalhe de cada task a um clique.
A documentação define a execução como uma única run de um flow, num estado específico. Ela começa por um trigger, do botão Executar da interface, de um webhook ou de uma chamada direta à API. Em todos os casos, o registro é o mesmo.
O que fica guardado em cada execução
Abra uma execução e você encontra as abas com o grafo visual das tasks, os logs, os outputs e as métricas. Os logs de cada task aparecem separados, na ordem de escrita, com o nível de cada linha. Os outputs ficam na aba própria, com os valores e os arquivos que cada task devolveu. As tasks também podem expor métricas, como o tamanho de um arquivo, a quantidade de linhas ou a duração de uma consulta.
Quando o dump do banco do cliente começa a demorar o dobro, a métrica de duração mostra a tendência antes da falha. Quando um relatório sai vazio, o output da consulta mostra se o problema estava na origem ou no envio.
Execução criada
O trigger, a interface ou a API cria a execução, que entra na fila no estado inicial.
Task em execução
O worker roda a task. Os logs e as métricas vão para o histórico enquanto ela trabalha.
Falha e retry
Com um bloco
retry, a task tenta de novo no intervalo configurado, atémaxAttempts.Lista errors
Se as tentativas acabam, as tasks de
errorsrodam, como o aviso no Slack com o id da execução.Estado final
A execução termina com falha, com aviso (
WARNING) ou com sucesso. O registro fica disponível.
Retries no lugar do script que tenta de novo
A API de pagamento responde com erro uma vez a cada cem chamadas. Num script, você escreveria um laço com espera. No Kestra, a task ganha um bloco retry. A documentação descreve três tipos de intervalo. O constant usa uma espera fixa. O exponential aumenta a espera a cada tentativa. O random sorteia esperas entre um mínimo e um máximo.
PT1S.Dá tempo para a API ou o banco se recuperar.WARNING quando houve nova tentativa.O sucesso com tropeço aparece diferente do sucesso limpo.CREATE_NEW_EXECUTION ou RETRY_FAILED_TASK.Recomeçar numa execução nova ou repetir só a task que falhou.O retry também existe no nível do flow. Com CREATE_NEW_EXECUTION, o Kestra cria uma execução nova. O contador de tentativas fica na execução. Com RETRY_FAILED_TASK, ele repete só a task que falhou. Nesse modo, o contador fica na task. Nas tasks flowable, o comportamento padrão repete só a task filha que falhou. Com RETRY_FLOWABLE, o Kestra reexecuta o bloco inteiro.
Tratamento de erro e aviso de falha
Por padrão, uma task com falha interrompe as tasks seguintes. A lista errors do flow define as tasks que rodam quando isso acontece. O exemplo da documentação usa uma task de webhook do Slack que manda uma mensagem com o namespace, o id do flow e o id da execução. Uma lista errors também pode ficar dentro de uma task flowable. Nesse caso, ela só trata as falhas das tasks filhas daquele bloco.
Duas marcações mudam o resultado sem esconder o problema. Com allowFailure: true, as tasks seguintes continuam rodando. A execução termina no estado WARNING. Com allowWarning, uma task com aviso deixa a execução terminar em SUCCESS. Os blocos finally e afterExecution rodam tarefas de limpeza ou de aviso depois que a execução chega a um estado final, com o estado disponível para decidir o que fazer.
Concorrência quando as execuções se acumulam
Um backup que normalmente leva dez minutos começa a levar uma hora. A agenda dispara outra execução antes da anterior acabar. O bloco concurrency do flow resolve isso com limit, o número máximo de execuções simultâneas. O comportamento padrão (QUEUE) coloca as excedentes na fila até abrir uma vaga. Com CANCEL, a execução nova termina cancelada na hora. Com FAIL, ela termina com falha, o que dispara o aviso da lista errors.
O limite de tempo por task, a propriedade de timeout, completa o quadro. Uma consulta presa deixa de segurar a rotina e falha dentro do prazo, entrando nas novas tentativas e no tratamento de erro como qualquer outra falha.
Replay, restart e os estados
As execuções terminadas ainda aceitam ação. O restart reabre uma execução com falha depois que você corrigiu a causa, sem perder o registro da tentativa anterior. O replay cria uma execução nova, com id próprio, a partir da task escolhida. O campo de execução original guarda o id da execução que a originou, e é isso que mantém o histórico ligado. O ciclo de vida completo, da criação ao estado final, está descrito na documentação dos estados, para execuções e para cada task.
O SLA, também descrito nos componentes do flow, define o tempo esperado para uma execução e reage quando ele estoura. Para rotinas com prazo, como a carga de relatórios antes do expediente, o SLA transforma o atraso em sinal explícito.
O hub seguinte mostra onde ficam as credenciais que essas tasks usam: os namespaces e os segredos.