Logs

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

Operações

Encontre execuções que correspondam a um conjunto de filtros. Retorna apenas os run IDs correspondentes, ordenados do mais recente para o mais antigo por padrão.

  • Workflows: selecione workflows específicos ou deixe vazio para todos (IDs separados por vírgula no modo avançado)
  • Status: info, error, running, pending, cancelled (vazio para todos)
  • Time Range: predefinições dos últimos 30 minutos até os últimos 30 dias, ou datas ISO de início/fim explícitas no modo avançado
  • Cost: compara o custo da execução com um limite em créditos (ex.: ≥ 10 créditos)
  • Duration: compara a duração da execução com um limite em milissegundos
  • Limit: número máximo de run IDs a retornar (padrão 100, máximo 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 trace completo — entradas, saídas, tempos e chamadas de ferramentas por block
  • finalOutput: a saída final da execução

Padrão típico

Consulte as execuções que interessam a você e depois itere sobre os IDs retornados, buscando os detalhes de cada um:

  1. Query Logs com Status: error e Time Range: Past 24 hours → <logs1.runIds>
  2. Itere sobre os IDs e chame Get Run Details → inspecione <logs2.traceSpans> para achar o block que falhou
  3. Aja sobre isso — poste um resumo no Slack, abra um ticket ou entregue o trace a um block Agent para diagnóstico

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

O block sempre opera no workspace atual. Os custos são expressos em créditos, tanto no filtro de custo quanto na saída de custo. Get Run Details é um caminho de leitura de log, então traceSpans e finalOutput vêm da projeção protegida voltada a logs, descrita em Proteção dos logs de execução. O resultado em tempo de execução subjacente permanece inalterado.

Common Questions

Para manter os payloads pequenos e previsíveis. Resumos de execução podem ser grandes — busque só as execuções de que você realmente precisa com o Get Run Details.
Não. O block é restrito ao workspace em que o workflow vive.
O trace de execução de uma execução: cada block que rodou, suas entradas e saídas, os tempos e quaisquer chamadas de ferramentas — os mesmos dados exibidos na visão de trace da página Logs.
Até onde chega a retenção de logs do seu plano. Planos gratuitos retêm logs por 7 dias; planos pagos os retêm indefinidamente.
LogsLoops