> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/monitoramento/logger.md).

# Logger

{% hint style="info" %}
Ao aplicar conectores do tipo Logger é possível persistir dados de monitoramento sobre os eventos de execução de fluxos. Seus valores poderão ser consultados nos Logs de monitoramento e utilizados em Dashboards personalizados.
{% endhint %}

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeHDmwYHCrsmnE9VvUIATrqqeGilW0zPLqlu5F3z5YcWHQVGn_ZuRHGsI0kg01a-OgHBfljoI6zdpTiWKZjMlw8cmnura-qmCEO9hwQ04MKU1LHSdcXdOKEmVz-fMOCrOn7CsgU?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                             | Tipo           | Descrição                                                                                                                                                                                                                                                                                |
| --------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição                         | Campo de texto | Descrição visual do conector no editor de fluxo                                                                                                                                                                                                                                          |
| Enviar para o log                 | Seletor        | Permite escolher a forma que o registro será exibido no Workspace. Entre registrar o objeto message completo da execução ou uma linha de texto customizada.                                                                                                                              |
| Título opcional à mensagem do log | Campo de texto | Título adicional que será exibido junto ao registro de execução.                                                                                                                                                                                                                         |
| Mensagem do log                   | Campo de texto | <p>Campo disponível quando optado por registrar uma linha de texto customizada em Enviar para o log.  </p><p></p><p>O valor inserido neste campo será o valor exibido nos logs de execução. Utilize a notação Mustache {{msg}} para acessar informações dentro do contexto do fluxo.</p> |
| {% endtab %}                      |                |                                                                                                                                                                                                                                                                                          |

{% tab title="Payload" %}

## Sucesso

**Linha de texto**: Trata-se do modelo padrão para visualização de dados de execução. Com o modelo personalizado, torna-se viável a criação de Strings específicas, incorporando dados dinâmicos por meio da notação Mustache.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdzVKpiP3FJh2A7GJp3JmLpCvINdDVTXNton1La2H_0dN1CBRrXlEn_ttATxrmVgKG_a6czq-wq0IMxe_EXqvQe_dS4KnEIEH65rlVYdN0zvPk6NkrGmCarLWnMdGEHxVu0FOrS?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Log gerado com linha de texto e dado dinâmico em formato Mustache</p></figcaption></figure>

**Objeto msg completo**: Esse tipo de visualização possibilita a compreensão completa e detalhada dos dados, exibindo todas as informações relevantes acumuladas até o ponto atual da execução do conector Logger. Ao visualizar logs completos, clique no botão Detalhes para visualizar toda a estrutura do registro e os dados acumulados.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcBmSwKVclHCxmtpKDyuvrzdHL2se_Jb3lqliN6gBP9Dyuv2u3npSttvdwwxMBD3QFtv5ZOv2mLhwuSb3Cf3lww0tFQTxPZInPuXg4WEtSGJ00cHZWVq6dqRqjhReTSA9ZuDYpLkw?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Log gerado com captura de objeto message completo</p></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXevjv9J_F8mGWr_MaaXAL9k0-Ji7Ttul6ueNc4oXNcI8-G75YUMO_KWYX7Rnsmo5KTsh5fS_l-yEG6ENV2ei2nYFkd5rgnfkr8-jZi1plH8SZNaACt887tSt-GyzxdrfZx5qvKi2A?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Detalhes adicionais do log</p></figcaption></figure>

### Locais onde os logs de execução podem ser visualizados

Ao utilizar o conector Logger, os registros das execuções dos fluxos ficam armazenados em diferentes áreas do Workspace, facilitando o acompanhamento e análise. Confira abaixo onde os logs podem ser acessados:

**Menu Logs de Monitoramento**: Acesse o menu lateral do Workspace e clique em Logs de Monitoramento para visualizar os registros armazenados.

**Fluxo**: Na tela do fluxo, clique no botão Debugger e, em seguida, acesse a aba Mensagens de execução. Os registros do conector Logger aparecerão em tempo real durante a execução do fluxo.

**Dashboards**: Os logs também podem ser exibidos em Dashboards, permitindo análises mais detalhadas. Por exemplo: Logs gerados pelo fluxo, contagem total de logs gerados pelo fluxo ou um histograma com a contagem geral de logs de execução em um período de tempo customizável.&#x20;

Para configurar, acesse o menu Dashboards no Workspace e utilize os widgets de log para criar sua visualização personalizada.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcy3jBHReFDvWVNim1g2dr6M61Ab-Gmkp1hFlkFCtfdHDkxT11r7n9IRHYAdUBtTvZuNVl2sJWeNCBp7_W_NvYP1_8J2y_JKbIV67EqERKPQYegXEfI02FJTy-57XG_OLHiwZVI?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Logs em Dashboards</p></figcaption></figure>

### Limitação na geração de logs

Para garantir a segurança e o desempenho do ambiente, os logs gerados pelo conector Logger possuem um limite padrão de 90KB. É recomendável utilizar a opção Enviar para o log > Linha de Texto ao configurar o conector, permitindo capturar apenas os dados essenciais para o contexto da execução do fluxo. Isto evita o acúmulo de informações desnecessárias e reduz a poluição nos logs de monitoramento.

Logs que excedem o limite de 90KB ainda serão gerados, mas serão comprimidos para se ajustarem ao limite. Caso seja necessário registrar todos os dados acumulados durante a execução de um fluxo, utilize o conector Debugger. Ele permite o registro de dados sem limites de tamanho, porém, esses dados ficarão disponíveis apenas na visualização em tempo real durante a execução do fluxo. Eles não serão exibidos na tela de Log de Monitoramento ou nos Dashboards.
{% endtab %}
{% endtabs %}


---

# 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 dynamically by asking a question.

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

```
GET https://docs.floui.io/guia/conectores/categorias/monitoramento/logger.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
