> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-logs.md).

# Registos

### O que são os Logs de Workflow?

Os Logs de Workflow fornecem um registo detalhado, passo a passo, de tudo o que acontece durante a execução de um workflow. Registam o percurso completo dos seus dados por cada etapa do workflow, incluindo:

* **Detalhes da execução da etapa**: Duração de execução, estado de sucesso/falha e número de tarefas processadas
* **Dados de entrada e saída**: Os dados exatos que entraram em cada etapa e o que saiu
* **Metadados**: Informação sobre quem executou o workflow, quando foi executado e a partir de que origem
* **Mensagens de erro**: Informação detalhada de erro quando as etapas falham, ajudando-o a identificar e corrigir problemas

### Porque os Logs são importantes para os seus workflows

* **Compreender o comportamento do workflow**: Veja exatamente que dados entram e saem de cada etapa
* **Depurar execuções com falha**: Identifique onde e por que os workflows falham com mensagens de erro detalhadas
* **Otimizar o desempenho**: Encontre estrangulamentos ao rever os tempos de execução das etapas
* **Iterar sem voltar a executar**: Carregue qualquer execução anterior no Studio com todos os resultados intactos

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-36890c9361066a3594d145f8e022af755fa2687f%2FCleanShot%202025-05-26%20at%2011.26.14%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

### Onde encontrar os Logs

* **Modo de teste do Studio**: Clique no ícone de Histórico no canto superior direito do Studio para ver os Logs dessas execuções do workflow
* **Histórico do workflow**: Aceda a todas as execuções anteriores através do separador "Histórico" no seu workflow
* **Colunas do workflow na grelha**: Clique em qualquer célula na coluna do workflow para ver os Logs da execução dessa linha específica

### Carregar execuções no Studio

A **"Abrir no Studio"** o botão permite-lhe carregar qualquer execução anterior do workflow de volta para o Studio com todos os resultados das etapas restaurados. Esta funcionalidade poderosa permite-lhe:

1. Depurar problemas sem voltar a executar todo o workflow
2. Testar alterações usando dados reais de execuções reais
3. Evitar esperar por chamadas de API externas ou processos de longa duração
4. Iterar sobre prompts e lógica com dados de produção

Para usá-lo: Basta clicar em "Abrir no Studio" a partir da vista de logs de qualquer execução. O Studio será carregado com todas as saídas intermédias preenchidas, permitindo-lhe modificar e testar qualquer etapa imediatamente.

Isto é especialmente valioso para depurar workflows complexos, trabalhar com dados sensíveis ao tempo ou colaborar em melhorias do workflow.

{% @arcade/embed url="<https://app.arcade.software/share/fc5g9N1qrk19HTAWNiKo>" flowId="fc5g9N1qrk19HTAWNiKo" %}

### Boas práticas para usar os Logs

1. **Use nomes descritivos para as etapas**: Dê às suas etapas nomes claros e descritivos para tornar os logs mais fáceis de navegar e compreender
2. **Monitorize os tempos de execução**: Acompanhe as durações das etapas para detetar precocemente a degradação do desempenho

Ao aproveitar todo o poder dos Logs, pode criar workflows mais fiáveis, depurar problemas mais rapidamente e melhorar continuamente os seus processos de automatização.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-logs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
