Visão geral

Um log é o trace registrado de uma execução de workflow. Cada vez que um workflow executa, o Studio anota o que o disparou, quais blocks rodaram e em que ordem, e para cada block a entrada exata, a saída e qualquer erro. Esse trace é a fonte da verdade para depuração: ele mostra o que cada block recebeu, o que fez e o que retornou, para você achar onde algo deu errado.

Pense nele como o replay em vídeo da execução, onde você lê o que realmente aconteceu, um block por vez.

A página Logs lista todas as execuções do seu workspace, uma linha por execução. A referência de Logging cobre a página em si: as colunas, os filtros e a barra lateral. Esta página cobre o que um log captura e como rastrear uma falha até a sua causa.

O que um log registra

A execução

Cada linha da página Logs é uma execução. Ela registra o trigger que a iniciou (Manual, API, Schedule, Chat, Webhook, MCP, Studio agent, Workflow ou Custom block), um status, uma duração e o custo em créditos. Também carrega um execution ID que identifica a execução de forma única.

O status mostra o resultado da execução de imediato, com as execuções que falharam marcadas como Error. Quando você está caçando uma falha, filtra a lista pelos erros e começa por ali.

Os blocks

Abra uma execução e o Log Details mostra o trace. A aba Trace lista cada block como um span com seu tempo, na ordem em que rodaram; cada execução de block registra o nome e o tipo do block, o próprio status, sua entrada, sua saída e uma mensagem de erro, se falhou.

É neste nível que você depura, porque uma execução falha quando um dos seus blocks falha, e um block geralmente falha por causa da entrada que recebeu. Nesta execução, uma olhada nos spans mostra para onde foi o tempo: o HealingAgent consumiu 7,83s dos 11,61s totais.

Entrada e saída

Cada block na barra lateral tem duas abas. A aba Input mostra os valores resolvidos com que o block realmente rodou: os valores literais que você digitou e as saídas anteriores que ele leu por referência. Valores exatos substituídos com sucesso a partir de Secrets via {{KEY}} aparecem mascarados nesta cópia do trace; veja Proteção do log de execução. A aba Output mostra o que o block produziu, formatado como objeto, com markdown renderizado para texto gerado por agentes.

A aba de entrada é a mais importante. Um block lê saídas anteriores pelo nome, escrito como <blockName.field>, e a aba de entrada mostra no que essas referências foram resolvidas no momento da execução. Se uma referência apontava para um valor que não existia, você vê isso aqui como ausente ou errado, e não como a tag que você escreveu. Veja como os blocks passam dados para entender como essas referências são resolvidas.

O mesmo inspetor acompanha você no editor: durante execuções manuais e por chat, o console mostra o Output e o Input de cada block ao vivo, com os valores em uma árvore tipada.

O snapshot

Um workflow muda com o tempo. Um log não. Clique em View Snapshot para abrir uma cópia congelada do workflow exatamente como ele estava quando aquela execução aconteceu: os blocks, as conexões, a configuração. Isso importa quando uma execução falhou na semana passada e você editou o workflow depois. O snapshot mostra a versão que realmente rodou, não a de hoje.

Rastreando uma falha de trás para frente

Depurar segue o mesmo ciclo repetível todas as vezes. Você começa no block que falhou e caminha de volta até o block que causou a falha.

1. Encontre o block que falhou. Abra a execução com erro. A barra lateral marca o block cujo status é error. Leia a mensagem de erro.
2. Leia a entrada dele. Abra a aba Input do block. É com isso que ele realmente rodou, depois de todas as referências resolvidas.
3. Confira a entrada. Pergunte se essa entrada é o que o block esperava. Um campo vazio, um valor do tipo errado, uma chave aninhada faltando: a divergência normalmente fica visível aqui.
4. Volte até a origem. Uma entrada ruim veio de algum lugar. Encontre o block anterior cuja saída o block que falhou referenciou e abra a aba Output desse block. Ou ele produziu o valor errado, ou nunca rodou.
5. Corrija e execute de novo. Ajuste a referência, a configuração ou o block anterior e execute o workflow novamente.
6. Compare os traces. Abra o log da nova execução ao lado do antigo. O block que estava em error agora está em success, e a entrada dele é o valor que você esperava. Isso confirma a correção.

Falhas comuns

A maioria dos erros se resume a um punhado de divergências de entrada. Conhecer o padrão acelera o passo 3.

• Entrada faltando. Um campo que o block precisa ficou vazio, ou a referência dele resolveu para nada.
• Referência errada. A tag nomeia uma saída que não existe, ou usa o nome de campo errado.
• Tipo incompatível. Uma string onde se esperava um objeto, ou o contrário.
• Chave aninhada faltando. O objeto referenciado existe, mas o campo específico dentro dele não.
• Mensagem de agente vazia. Um Agent não retornou nada, então o block seguinte não teve o que ler.
• Erro externo. Uma ferramenta ou API chamada pelo block retornou um erro próprio, exibido na mensagem de erro do block.

Quando um valor está no formato errado, remodele-o em um block Function, cujo resultado se torna a saída dele, que os blocks seguintes podem ler.

Depuração assistida por IA

O Studio pode ler os logs de uma execução e propor uma correção a partir do trace: a mensagem de erro, a entrada que o block recebeu e a saída que o block anterior produziu. Os logs continuam sendo a fonte da verdade. Você confirma uma correção proposta do mesmo jeito que confirma a sua: execute o workflow de novo e compare o novo trace com o que falhou.

Retenção

Os logs são guardados para você depurar uma execução depois que ela aconteceu. Planos Free retêm os logs por 7 dias; depois disso eles são arquivados em armazenamento na nuvem e removidos do banco de dados. Os planos Pro, Team e Enterprise retêm os logs por tempo indeterminado.

Próximos passos