Logs

O bloco Logs consulta logs de execução de workflow no workspace atual e busca detalhes completos de execuções individuais — os mesmos dados que você vê na página Logs, disponíveis para seus workflows.

Operações

Encontre execuções que batem com um conjunto de filtros. Retorna só os run IDs correspondentes, ordenados do mais novo para o mais antigo por padrão.

  • Workflows: selecione workflows específicos, ou deixe vazio para todos (IDs separados por vírgula no advanced mode)
  • Status: info, error, running, pending, cancelled (vazio para todos)
  • Time Range: presets dos últimos 30 minutos aos últimos 30 dias, ou datas ISO explícitas de início/fim no advanced mode
  • Cost: compare o custo da execução contra um limiar de créditos (ex.: ≥ 10 créditos)
  • Duration: compare a duração da execução contra um limiar em milissegundos
  • Limit: máximo de run IDs a retornar (padrão 100, máx. 200)

Busque tudo sobre uma única execução pelo run ID:

  • runId, workflowId, workflowName
  • status, trigger, startedAt, durationMs
  • cost: custo da execução em créditos
  • traceSpans: o rastreamento completo — entradas, saídas, timings e tool calls por bloco
  • finalOutput: a saída final da execução

Padrão típico

Consulte as execuções que importam, depois faça loop sobre os IDs retornados e busque detalhes de cada uma:

  1. Query Logs com Status: error e Time Range: Past 24 hours → <logs1.runIds>
  2. Faça loop sobre os IDs e chame Get Run Details → inspecione <logs2.traceSpans> para encontrar o bloco que falhou
  3. Aja — poste um resumo no Slack, abra um ticket ou alimente o rastreamento a um bloco Agent para diagnóstico

Isso combina naturalmente com o trigger Zoen: o trigger entrega o runId que disparou o evento, e Get Run Details dá o rastreamento completo.

O bloco sempre opera no workspace atual. Custos são denominados em créditos, tanto para o filtro de custo quanto para a saída de custo.

Common Questions

Para manter payloads pequenos e previsíveis. Resumos de execução podem ser grandes — busque só as execuções de que realmente precisa com Get Run Details.
Não. O bloco é escopado ao workspace em que o workflow vive.
O rastreamento de execução de uma run: cada bloco que rodou, suas entradas e saídas, timings e quaisquer tool calls — os mesmos dados mostrados na visão de rastreamento da página Logs.
Até onde a retenção de logs do seu plano permitir. Planos Free retêm logs por 7 dias; planos pagos os retêm indefinidamente.

On this page

Operações
Padrão típico