# Pipeline logs

Pipeline logs são dados detalhados que permitem aos usuários ver em profundidade o que ocorre em cada execução presente durante o ciclo de funcionamento do *pipeline*. 

Na aba Pipeline Logs, você pode acompanhar os *logs* de eventos que são registrados durante a execução de um *pipeline*.

## Seleção de ambiente <a href="#h_26d49df614" id="h_26d49df614"></a>

Você pode selecionar o ambiente desejado no canto superior esquerdo. O histórico de *logs* expira após 3 dias no ambiente de teste (test) e após 10 dias no ambiente de produção (prod).

Quando você seleciona um ambiente, a página inteira atualiza e mostra os dados correspondentes.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2F5TgldpR92RDVXjNYs2dG%2Fsele%C3%A7%C3%A3o-de-ambiente.png?alt=media&#x26;token=0544622a-1f76-4cf5-b559-669fac0d4465" alt=""><figcaption></figcaption></figure>

## Campos de busca <a href="#h_00048f8780" id="h_00048f8780"></a>

Você pode filtrar os *logs* de *pipeline* utilizando os seguintes parâmetros:

* **Período do tempo**: o horário em que um *pipeline* foi executado. Filtre os *pipelines* executados nos últimos 5, 15 ou 60 minutos ou selecione um período de tempo específico.
* **Mensagem do&#x20;*****log*****:** informação enviada por um componente que retorna *logs* durante a execução de um *pipeline*. Você deve buscar por palavras inteiras quando utilizar esse campo.
* **Nome do&#x20;*****pipeline*****:** o nome do *pipeline*, como informado durante sua criação. Você deve buscar por palavras inteiras quando utilizar esse campo.
* [**Versão do&#x20;*****pipeline***](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/dashboards/broken-reference)*:* O filtro de versão do pipeline deve ser usado em conjunto com o nome do pipeline, caso contrário, a busca não retornará resultados.
  * Exemplo:&#x20;
    * Campo de nome: `João` + Campo de versão: 1.0 → ✅ retorna resultados
    * Campo de nome: nenhum + Somente versão: 1.0 → ❌ não retorna resultados
* **Chave de execução de um&#x20;*****pipeline*****:** identificador único de cada execução de um *pipeline.*
* **“Ordenar por”** (Beta): um filtro que permite classificar os *pipeline logs* em ordem crescente (*asc*) ou decrescente (*desc*) de acordo com o *timestamp*.
* **Nível do&#x20;*****log*****:** a classificação da mensagem do *log*, conforme o seguinte critério:
  * INFO: informação acerca de eventos ordinários durante a execução do *pipeline.*
  * WARN: informação acerca de possíveis problemas durante a execução do *pipeline.*
  * ERROR: informação acerca de erros durante a execução do *pipeline.*
  * ALL: qualquer tipo de informação.
* **Fonte de logs:** filtra os resultados por **Digibee Internal** ou **Log Connector**. Se você selecionar **Digibee Internal**, apenas logs internos da Plataforma serão exibidos. Se você selecionar **Log Connector**, apenas logs explicitamente adicionados pelo usuário no pipeline serão mostrados.

{% hint style="info" %}
**Comando:** é possível realizar uma busca usando o comando CTRL+ENTER (Windows) ou CMD+ENTER (Mac), como alternativa para o botão Pesquisar.
{% endhint %}

Os *logs* são mostrados abaixo de acordo com os parâmetros especificados. Você pode clicar no ícone de olho para ver os detalhes do *log* em um modal ou no ícone de cópia para copiar a mensagem do *log*.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2FYNPYNemZHi1aJ22sL4zl%2Fcampos-de-busca.png?alt=media&#x26;token=4e527e0f-98bf-4833-b0c2-2382720b9019" alt=""><figcaption></figcaption></figure>

## Como formatar mensagens com JSONs?

Agora é possível formatar mensagens de *logs* contendo JSONs e copiar o conteúdo formatado.

Para usar a *feature*, siga estes passos:

* Em Pipeline Logs, clique no ícone de **“olho”**, que abrirá os detalhes do log.
* Em Mensagem do log, clique no ícone de **“varinha”** para formatar qualquer JSON disponível. Na mesma aba, há o ícone para copiar o conteúdo.

<figure><img src="https://2518718503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO0A6g1dOsu8BiHYqO67%2Fuploads%2FCYeJ0X2HasCaYUT0FtNT%2Fdetalhes-do-log.gif?alt=media&#x26;token=66096d9e-1156-4fb9-a37a-af34e51df6de" alt=""><figcaption></figcaption></figure>