> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Observabilidade - Relatório de execuções

> Baixe o detalhe das execuções dos seus workflows em uma planilha, respeitando os filtros que você tiver aplicado

Em **Logs** você pode baixar o detalhe das execuções dos seus workflows em uma planilha. O que você baixa é exatamente o que está vendo na tela: o relatório respeita o intervalo de datas e todos os filtros ativos, não é um despejo completo.

Serve para guardar o comprovante do que é faturado para você, ou para revisar com calma o que aconteceu com um conjunto de execuções sem abrir uma por uma.

## Como baixar

<Steps>
  <Step title="Abra Logs">
    Entre na seção **Logs** do seu projeto e escolha a aba **Workflows** ou **Tools**, conforme o que quiser exportar.
  </Step>

  <Step title="Aplique os filtros">
    Ajuste o intervalo de datas e os filtros que precisar: canal, status, workflow, usuário. O arquivo vai conter exatamente esse conjunto.
  </Step>

  <Step title="Pressione o botão de download">
    Ele fica à direita da barra de filtros. A geração é assíncrona: o pedido é despachado e o arquivo aparece na **Central de downloads** quando estiver pronto.

    <Frame>
      <img src="https://mintcdn.com/jelouai/HSkNXQdNdXNjg_dI/assets/images/observabilidad/reporte_barra_descarga_es.png?fit=max&auto=format&n=HSkNXQdNdXNjg_dI&q=85&s=20b1ed398648d71f66d939db8b24c0e6" alt="Barra superior dos Logs de Brain com as abas Workflows e Tools, o campo de busca, o botão Filtros, o de recarregar e, na extremidade direita, o botão de download do relatório" width="1851" height="114" data-path="assets/images/observabilidad/reporte_barra_descarga_es.png" />
    </Frame>

    <Tip>
      Você não precisa ficar esperando na tela. Continue trabalhando e volte à Central de downloads depois.
    </Tip>
  </Step>
</Steps>

<Note>
  Se o conjunto de filtros não retornar resultados, o sistema avisa que não há dados em vez de entregar um arquivo vazio.
</Note>

## Colunas do arquivo

| Coluna                | O que contém                                          |
| --------------------- | ----------------------------------------------------- |
| `ID da execução`      | Identificador único da execução                       |
| `ID da execução pai`  | A execução que a invocou, quando é uma execução filha |
| `ID da execução raiz` | A execução que originou toda a cadeia                 |
| `Nível`               | `Pai` ou `Filha`                                      |
| `Nome do usuário`     | Nome do usuário que originou a execução               |
| `ID do usuário`       | Identificador do usuário                              |
| `Workflow`            | Nome do workflow executado                            |
| `Projeto`             | Projeto ao qual pertence, quando aplicável            |
| `Canal`               | Canal pelo qual a conversa entrou                     |
| `Status`              | Resultado da execução                                 |
| `Origem`              | O que a disparou                                      |
| `Data de início`      | Quando começou                                        |
| `Data de término`     | Quando terminou, vazia se a execução não finalizou    |

Os cabeçalhos vêm no seu idioma configurado: espanhol, inglês ou português.

## Hierarquia pai-filho

Quando um workflow invoca outro, três colunas trabalham juntas para você distinguir quem chamou quem.

`Nível` diz de imediato se a linha é uma execução **pai** — começou por conta própria — ou uma **filha**, invocada a partir de outra. `ID da execução pai` diz qual a invocou, e `ID da execução raiz` leva você à origem de toda a cadeia, por mais níveis de aninhamento que existam.

<Note>
  As três colunas podem vir vazias quando a informação de hierarquia não está disponível para aquela execução. O relatório deixa a célula em branco em vez de supor um valor.
</Note>

## Datas e fuso horário

As datas do arquivo são expressas no **fuso horário configurado no seu perfil**, não no UTC do servidor. Se você não tiver um configurado, é usado o do seu navegador.

O formato é `AAAA-MM-DD HH:MM:SS` em relógio de 24 horas. Essa ordem é intencional: em uma planilha ela ordena corretamente em ordem alfabética e o Excel a reconhece como data.

<Note>
  O fuso horário do arquivo e o intervalo de datas do filtro são duas coisas diferentes. O filtro define **quais execuções entram**; o fuso define **como as datas são exibidas**.
</Note>

## Limite de tamanho

<Warning>
  O relatório aceita até **1.000.000 de linhas**. Se seus filtros retornarem mais, o download é rejeitado com a mensagem *"Erro ao gerar o download do relatório. Excede os limites de recursos"* e nenhum arquivo é gerado.

  Se você bater nesse limite, reduza o intervalo de datas ou adicione um filtro de workflow ou canal.
</Warning>

Abaixo desse teto o arquivo é montado automaticamente. Se o conjunto for grande, ele é dividido em vários arquivos, e você encontra todos na Central de downloads.

## Casos de uso

<AccordionGroup>
  <Accordion title="Auditar o gasto faturado">
    Uma conta que precisa justificar a fatura ao financeiro: baixa o detalhe do período completo e o guarda como comprovante do consolidado que recebe.
  </Accordion>

  <Accordion title="Revisar com calma um pico de falhas">
    Um time que viu muitas execuções com falha ontem: filtra por status e por canal, baixa o conjunto e revisa os identificadores sem abrir cada execução na interface.
  </Accordion>

  <Accordion title="Rastrear uma cadeia de workflows aninhados">
    Um workflow que invoca outros dois, e um deles falha: com `ID da execução raiz` agrupam-se todas as linhas da mesma cadeia, e com `Nível` distingue-se o pai das filhas.
  </Accordion>
</AccordionGroup>

## Artigos relacionados

<CardGroup cols={2}>
  <Card title="Como funciona o faturamento" icon="receipt" href="/pt/guias/faturamento/introducao">
    O que é cobrado e como se compõe o seu consolidado
  </Card>

  <Card title="Eventos de Nó" icon="chart-line" href="/pt/guias/observabilidade/eventos">
    Configure eventos de rastreamento para alimentar suas métricas
  </Card>
</CardGroup>
