# Pipeline logs

Os logs de pipeline (pipeline logs) são registros detalhados que permitem inspecionar o que acontece em cada etapa do ciclo de execução de um pipeline. Na aba **Pipeline logs**, você pode acompanhar os logs de eventos registrados durante a execução do pipeline.

### **Ambiente**

Selecione o ambiente desejado no canto superior esquerdo da página. Ao selecionar um ambiente, a página é atualizada para exibir os dados correspondentes.

{% hint style="warning" %}
O histórico de logs expira após **3 dias no ambiente de teste** e após **10 dias no ambiente de produção**.
{% endhint %}

### **Campos de pesquisa**

Use os campos abaixo para filtrar os pipeline logs. A lista de resultados exibe os logs que correspondem aos critérios selecionados.

| Campo                             | Descrição                                                                                                                             |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Mensagem do log**               | As informações enviadas por um conector que retorna logs durante a execução do pipeline. Pesquise apenas por palavras completas.      |
| **Nome do pipeline**              | O nome do pipeline conforme definido pelo usuário. Pesquise apenas por palavras completas.                                            |
| **Versão do pipeline**            | O número da versão do pipeline. Deve ser usado em conjunto com o nome do pipeline; caso contrário, a pesquisa não retorna resultados. |
| **Chave de execução do pipeline** | O identificador único de uma execução de pipeline.                                                                                    |

#### **Uso do campo Pipeline version**

O campo Pipeline version funciona apenas em combinação com o campo Pipeline name.

| Nome do pipeline | Versão | Resultado                |
| ---------------- | ------ | ------------------------ |
| John             | 1.0    | ✅ Retorna resultados     |
| (vazio)          | 1.0    | ❌ Não retorna resultados |

### **Filtros**

#### **Log level**

Filtre as execuções pela classificação do log:

| Nível                    | Descrição                                                             |
| ------------------------ | --------------------------------------------------------------------- |
| **Todas as severidades** | Qualquer tipo de informação de log.                                   |
| **Info**                 | Informações sobre eventos comuns durante a execução do pipeline.      |
| **Warn**                 | Informações sobre possíveis problemas durante a execução do pipeline. |
| **Error**                | Informações sobre erros durante a execução do pipeline.               |

#### **Fonte dos logs**

Filtre os resultados pela origem do log:

* **Digibee Internals** — Exibe apenas os logs internos da plataforma.
* **Log Connector** — Exibe apenas os logs explicitamente adicionados pelo usuário no pipeline.

#### **Período de tempo**

Filtre os pipelines pelo tempo de execução. Selecione os últimos **5, 15 ou 60 minutos**, ou defina um intervalo de tempo personalizado.

### **Tabela de logs**

A tabela de logs exibe os resultados de acordo com os filtros selecionados.

Clique em um log na tabela para abrir seus detalhes em um modal.

Passe o cursor sobre qualquer célula para exibir o **ícone de cópia** e clique para copiar as informações.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/dashboards/pipeline-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.