Ir para o conteúdo
Promovaweb

Execuções, logs e falhas

StayCloudVPS 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.

Criar minha VPS na StayCloud

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

  1. A pergunta da manhã seguinte
  2. O que fica guardado em cada execução
  3. Retries no lugar do script que tenta de novo
  4. Tratamento de erro e aviso de falha
  5. Concorrência quando as execuções se acumulam
  6. Replay, restart e os estados

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.

  1. Execução criada

    O trigger, a interface ou a API cria a execução, que entra na fila no estado inicial.

  2. Task em execução

    O worker roda a task. Os logs e as métricas vão para o histórico enquanto ela trabalha.

  3. Falha e retry

    Com um bloco retry, a task tenta de novo no intervalo configurado, até maxAttempts.

  4. Lista errors

    Se as tentativas acabam, as tasks de errors rodam, como o aviso no Slack com o id da execução.

  5. Estado final

    A execução termina com falha, com aviso (WARNING) ou com sucesso. O registro fica disponível.

O caminho de uma execução com falha numa task, com os mecanismos de retry e de tratamento de erro descritos na documentação.

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.

PropriedadeO que defineEfeito na execução
maxAttemptsO número máximo de tentativas, incluída a primeira.Com 3, a task roda no máximo três vezes antes de falhar.
intervalA espera entre as tentativas, no formato de duração, como PT1S.Dá tempo para a API ou o banco se recuperar.
maxDurationO tempo total da task somando todas as tentativas.Evita que as novas tentativas segurem a rotina por horas.
warningOnRetryMarca a execução como WARNING quando houve nova tentativa.O sucesso com tropeço aparece diferente do sucesso limpo.
behaviorNo retry do flow, 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.