Logging

Toda execução de workflow é registrada. Há dois lugares para ler os logs: o Console, para a execução que você está acompanhando, e a página Logs, para todas elas.

Console em tempo real

Durante execuções manuais ou por chat, o painel Console no editor mostra cada block conforme ele roda — destaque do block ativo, saídas assim que ficam prontas, tempo por block e status de sucesso/erro.

Página Logs

Toda execução, de qualquer trigger — manual, API, chat, schedule, webhook — aparece na página Logs, com filtros por intervalo de tempo, status, tipo de trigger, pasta e workflow, busca em texto completo e um Live mode que traz as novas entradas em tempo real, conforme são registradas.

Detalhes do log

Clique em qualquer entrada para abrir a barra lateral: a linha do tempo da execução (início/fim, duração total, tempo por block) e o fluxo de dados de cada block.

O resultado do block — dados estruturados em JSON, renderização de markdown para conteúdo de IA e um botão de copiar.

O que o block recebeu — valores de variáveis resolvidos, saídas referenciadas e variáveis de ambiente. Valores exatos de secrets ativados por uma substituição {{KEY}} bem-sucedida aparecem mascarados nesta visão do trace. Veja Proteção do log de execução.

Snapshots do workflow

View Snapshot abre uma cópia congelada do workflow exatamente como ele estava no momento da execução — estrutura, estados dos blocks, conexões — e cada block é clicável para ver suas entradas e saídas. É assim que você depura a execução de um workflow que já foi alterado desde então.

Existem snapshots para as execuções posteriores à introdução do sistema de logging aprimorado. Logs mais antigos, migrados, exibem "Logged State Not Found".

Retenção

  • Free: 7 dias — os logs são arquivados em armazenamento na nuvem e depois excluídos.
  • Pro / Team / Enterprise: retidos por tempo indeterminado.

Próximos passos

Common Questions

Planos Free retêm os logs por 7 dias — depois disso, os logs são arquivados em armazenamento na nuvem e excluídos do banco de dados. Os planos Pro, Team e Enterprise retêm os logs por tempo indeterminado, sem limpeza automática.
Cada entrada de log inclui o ID da execução, o ID do workflow, o tipo de trigger, os timestamps de início e fim, a duração total em milissegundos, o detalhamento de custo (custo total, contagem de tokens e detalhamento por modelo), os dados da execução com os trace spans, a saída final e quaisquer arquivos associados. A barra lateral de detalhes do log permite inspecionar as entradas e saídas de cada block.
Quando um valor salvo em Secrets é substituído com sucesso via {{KEY}}, as ocorrências exatas, sensíveis a maiúsculas e minúsculas, são mascaradas em toda a cópia exposta nos logs, incluindo a exibição do log de block ao vivo, as entradas e saídas em Logs Overview, o Trace, as APIs de leitura de log e a saída Get Run Details do block Logs. Isso não é um redator genérico: valores fixos no código ou lidos diretamente não ativam o mascaramento por si só, e valores codificados, com hash ou transformados não são reconhecidos. Respostas funcionais de execução, streams e callbacks permanecem inalterados. Veja Proteção do log de execução em Secrets para mais detalhes.
Uma cópia congelada da estrutura do workflow (blocks, conexões e configuração) capturada no momento da execução, para você ver o estado exato por trás de uma execução específica — útil para depurar workflows que foram modificados desde então.
Sim. A API externa oferece endpoints para consultar logs com filtros por workflow, intervalo de tempo, tipo de trigger, duração, custo e modelo. Você também pode configurar notificações por webhook, email ou Slack para receber alertas em tempo real quando as execuções terminam.
Ele atualiza a página Logs em tempo real, para que novas entradas apareçam conforme são registradas — útil durante deploys ou ao monitorar workflows ativos.
Visão geralAlertas