Pular para o conteúdo principal

Monitoramento de Execucao

O que voce vai aprender
  • Como acessar o historico de execucao do workflow usando o botao workflow_history
  • Como ler logs de execucao e verificar status de sucesso ou falha
  • Como a configuracao de nivel de log afeta o detalhe dos registros de execucao
  • Como solucionar problemas em execucoes de workflow que falharam

O monitoramento de execucao permite acompanhar toda vez que um workflow executa, ver se foi bem-sucedido ou falhou, e inspecionar os detalhes de cada etapa. Isso e essencial para verificar que seus workflows estao funcionando corretamente e para diagnosticar problemas quando algo da errado.

Acessando o historico de execucao​

Para visualizar o historico de execucao dos seus workflows:

  1. Navegue ate Automacoes > Workflows na barra lateral para abrir a pagina de lista de workflows.
  2. Clique no botao workflow_history no topo da pagina de lista.

Isso abre a visualizacao do historico de execucao, que mostra um log de todas as execucoes passadas dos workflows. Cada entrada no historico inclui informacoes sobre quando o workflow executou, qual workflow foi e se a execucao foi bem-sucedida.

O que os registros de execucao mostram​

Cada registro de execucao no historico tipicamente inclui:

  • Timestamp -- A data e hora exata em que o workflow executou
  • Nome do workflow -- Qual workflow foi executado
  • Status -- Se a execucao foi concluida com sucesso, falhou ou ainda esta em andamento
  • Dados do trigger -- Qual evento ou condicao iniciou o workflow
  • Resultados etapa por etapa -- O resultado de cada etapa individual no workflow, incluindo status de execucao, timestamps e detalhes de erro sanitizados quando disponiveis

Como o nivel de log afeta o detalhe da execucao​

A configuracao de Log Level em cada workflow controla quanta informacao e capturada nos registros de execucao. Isso e configurado no formulario do workflow quando voce cria ou edita um workflow.

  • Niveis de log mais altos capturam informacoes mais detalhadas sobre cada etapa, incluindo valores de entrada, valores de saida e dados intermediarios. Isso e muito util durante desenvolvimento e testes.
  • Niveis de log mais baixos capturam apenas informacoes essenciais como status de sucesso/falha. Isso reduz ruido e armazenamento quando o workflow esta estavel e em producao.
dica

Defina o nivel de log para uma configuracao mais alta (mais verbosa) enquanto voce esta construindo e testando um novo workflow. Uma vez que o workflow esteja executando de forma confiavel, reduza o nivel de log para manter seu historico de execucao limpo e gerenciavel.

Solucionando problemas em execucoes que falharam​

Quando a execucao de um workflow falha, siga estes passos para identificar e corrigir o problema:

  1. Abra o historico de execucao clicando no botao workflow_history na pagina de lista de workflows.
  2. Encontre a execucao que falhou na lista. Execucoes com falha sao tipicamente marcadas com um indicador de status de falha.
  3. Inspecione os resultados das etapas para encontrar qual etapa falhou. O registro de execucao mostra o resultado de cada etapa em sequencia, para que voce possa identificar exatamente onde a falha ocorreu.
  4. Revise os detalhes do erro. Dependendo do nivel de log, o registro pode incluir mensagens de erro, os dados que foram passados para a etapa e metadados compartilhados de execucao como executionContext.status, timestamps e executionContext.safeError.
  5. Corrija o problema no workflow. Problemas comuns incluem:
    • Nomes de placeholder {{variable}} incorretos que nao correspondem aos dados disponiveis
    • Campos obrigatorios faltando na configuracao de uma etapa
    • Servicos externos (webhooks) que estao indisponiveis ou retornando erros
    • Formatos de dados invalidos passados entre etapas
  6. Re-teste o workflow apos fazer a correcao. Para workflows manuais, use o botao executeManual. Para workflows hook, acione o evento relevante novamente. Para workflows temporais, aguarde a proxima execucao agendada ou ajuste o cronograma.

Melhores praticas para monitoramento​

  • Verifique o historico de execucao regularmente durante os primeiros dias apos ativar um novo workflow. A deteccao precoce de problemas evita que eles se acumulem.
  • Use o botao Debug all na secao Etapas do formulario do workflow para testar seu workflow antes de ativa-lo. Isso detecta muitos problemas antes que aparecam em producao.
  • Ajuste os niveis de log conforme necessario. Aumente a verbosidade ao solucionar um problema especifico, depois reduza quando o problema for resolvido.
  • Revise a lista de workflows periodicamente para garantir que todos os workflows habilitados estao executando como esperado, usando as ferramentas de filtro e historico na pagina de lista.

Os metadados de execucao mostrados na interface sao sanitizados para depuracao segura. Eles sao destinados a ajuda-lo a entender o que falhou sem expor stack traces brutos, segredos ou payloads de provedores.

informação

O botao workflow_history na pagina de lista de workflows fornece uma visao centralizada de todas as execucoes de todos os workflows. Isso facilita identificar padroes, como um workflow que falha toda vez que executa, ou um que nao executou ha muito tempo.

Proximos passos​