# Logs de auditoria

## Introdução

A ferramenta de **Logs de Auditoria** da plataforma Floui oferece um registro detalhado de todas as ações realizadas dentro do ambiente, proporcionando rastreabilidade e segurança para a gestão de fluxos, usuários e dados. Por meio dessa funcionalidade, administradores podem visualizar eventos categorizados por **Recursos** e **Ações**, permitindo a análise precisa de atividades como criação, atualização, execução e remoção de registros. Além disso, a ferramenta disponibiliza filtros avançados para facilitar a consulta de eventos e acompanha uma política de retenção para garantir a manutenção e o desempenho do sistema.

## Acesso aos logs de auditoria

Para realizar o acesso aos logs de auditoria, certifique-se de possuir uma conta Floui com permissões de administrador. Realize o login com sua conta e acesse o menu lateral, caso disponível, clique na opção **Logs de Auditoria**.

Por esta tela é possível visualizar todos os registros de ações realizadas pelos usuários com acesso a mesma conta.

<figure><img src="/files/IDNSkdhQBZudiV3q90MK" alt=""><figcaption><p>Logs de auditoria</p></figcaption></figure>

Nos logs de auditoria estão disponíveis as seguintes colunas referentes ao registro de ações:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Usuário</strong></td><td>Refere-se ao usuário, através do seu e-mail, que disparou determinado evento dentro do ambiente Floui. </td></tr><tr><td><strong>Workspace</strong></td><td>Workspace em que o registro foi capturado. Caso tenha sido realizado no ambiente SaaS, ou seja, fora de um Workspace, será sinalizado com um ícone "-".</td></tr><tr><td><strong>Recurso Utilizado</strong></td><td>Recursos são ferramentas e funcionalidades disponibilizadas no ambiente SaaS e Workspace.</td></tr><tr><td><strong>Ação</strong></td><td>Ações são eventos realizados por usuários nos recursos disponíveis no ambiente Floui, dentro do Workspace e no ambiente SaaS.</td></tr><tr><td><strong>Nome do recurso</strong></td><td>Nome da entidade onde o evento foi registrado.</td></tr><tr><td><strong>ID do recurso</strong></td><td>Identificador único da entidade onde o evento foi registrado.</td></tr><tr><td><strong>Data/Hora</strong></td><td>Data e hora em que o registro de ação foi realizado por determinado usuário.</td></tr></tbody></table>

## Recursos e ações em registros

Os registros de eventos capturados no Log de Auditoria podem ser categorizados em **Recursos** e **Ações**. Cada Recurso possui uma gama de Ações disponíveis para rastreamento. Através dessa combinação, é possível visualizar registros de criação, atualização, exclusão e execução de entidades, além de eventos relacionados à autenticação, transferências de dados e gestão de filas internas.&#x20;

### Recursos disponíveis&#x20;

Os eventos registrados na plataforma Floui abrangem diversas áreas da estrutura e operação do ambiente. Abaixo estão as principais categorias e seus respectivos contextos:

* **Flow**: Eventos associados à configuração de fluxos, execuções manuais e controle de versionamento.
* **Form**: Eventos relacionados à estrutura e gerenciamento de formulários internos.
* **Database\_table**: Eventos referentes à estrutura de tabelas no banco de dados interno.
* **Database\_entity**: Eventos referentes à criação, modificação ou remoção de registros dentro das tabelas.
* **Dashboard**: Eventos que acompanham alterações na estrutura e configuração dos dashboards.
* **Datasource**: Eventos sobre a estrutura e execução de fontes de dados.
* **Storage\_file**: Eventos que rastreiam a manipulação de arquivos armazenados no Workspace. Este recurso não se aplica na manipulação de pastas por fluxos e conectores.
* **Storage\_folder**: Eventos que monitoram a criação e remoção de pastas dentro do Storage. Este recurso não se aplica na manipulação de arquivos por fluxos e conectores.
* **Group**: Eventos relacionados ao gerenciamento de grupos dentro do Workspace.
* **Custom\_node**: Eventos associados à criação e gestão de conectores personalizados.
* **Alert\_rule**: Eventos referentes à criação e alteração de regras de alerta.
* **Service\_account**: Eventos sobre configuração de contas de serviço, e de autorização de determinados tipos de contas de serviço.
* **Queue**: Eventos relacionados à criação e gerenciamento de filas internas de processamento.
* **Queue\_job**: Eventos sobre as entidades processadas pelas filas internas. Se aplica somente para eventos manuais, não para ações dos conectores de gestão de filas.
* **Variable**: Eventos que monitoram a criação e modificação de variáveis globais do Workspace.
* **User**: Eventos relacionados à administração de usuários dentro da conta.
* **Workspace**: Eventos que registram acessos em Workspace disponíveis para a conta.
* **Company**: Eventos associados à gestão das informações da empresa vinculada à conta Floui.

Esses eventos fornecem rastreabilidade e controle sobre as operações realizadas dentro da plataforma, permitindo auditoria e gestão dos recursos.

### Ações disponíveis

Os eventos registrados na plataforma Floui abrangem diversas ações operacionais realizadas pelos usuários do sistema. Abaixo estão os principais tipos de eventos e seus respectivos contextos:

#### **Eventos de Manipulação de Entidades**

* **Create**: Criação de novas entidades dentro da conta Floui.
* **Update**: Atualização de entidades já existentes.
* **Delete**: Exclusão de uma entidade específica.
* **Mass\_delete**: Exclusão em massa de entidades, atualmente disponível apenas para registros armazenados em Databases.
* **Duplicate**: Duplicação de determinadas entidades dentro do ambiente.

#### **Eventos de Transferência de Dados**

* **Export**: Exportação de dados para arquivos, aplicável atualmente à exportação de registros de Database.
* **Upload**: Envio manual de arquivos para o Storage do Workspace.
* **Download**: Download de arquivos armazenados no Storage do Workspace.

#### **Eventos de Execução e Processamento**

* **Execute**: Execução manual de fluxos e Datasources.

#### **Eventos de Depuração (Debug)**

* **Debug\_start**: Início da execução manual de um fluxo em modo de depuração (debug).
* **Debug\_stop**: Interrupção manual da execução de um fluxo em modo de depuração.

#### **Eventos de Autenticação e Autorização**

* **Login**: Login realizado com sucesso na conta Floui.
* **Authorize**: Autorização para determinados tipos de contas.
* **Update\_profile**: Atualização do perfil do usuário.
* **Password\_recovery**: Recuperação de senha do usuário.
* **Workspace\_access**: Acesso ao Workspace através do ambiente SaaS.

#### **Eventos de Gerenciamento de Filas**

* **Queue\_pause**: Pausa manual no processamento de itens em uma fila interna.
* **Queue\_resume**: Retomada manual do processamento de itens em fila interna.
* **Queue\_clean**: Limpeza manual de itens de uma fila interna.

#### **Eventos de Versionamento de Fluxos**

* **Snapshot\_create**: Criação de uma versão de um fluxo no formato Snapshot.
* **Snapshot\_update**: Atualização dos dados de um versionamento do tipo Snapshot.
* **Snapshot\_delete**: Remoção de um versionamento do tipo Snapshot.
* **History\_restore**: Restauração de versões anteriores de fluxos.

## Modificações e deleções de usuários com registros

Quando um usuário com registros vinculados no Log de Auditoria altera suas informações cadastrais, como seu e-mail, os novos registros passam a ser gerados com este e-mail atualizado, enquanto os registros anteriores permanecem associados ao e-mail antigo. Para monitorar essa mudança de dados cadastrais, é possível consultar registros utilizando a combinando de ações **User** e **Update\_profile**.&#x20;

Já na remoção de usuários com registros vinculados, os registros permanecem disponíveis no ambiente até que a política de retenção de registros seja aplicada.

## Política de retenção

Os registros do log de auditoria seguem a política de retenção de logs, logo são armazenados temporariamente no ambiente e deletados ao atingir a data limite. Por padrão os logs datados acima de 90 dias serão removidos. Esta limpeza visa manter a saúde do ambiente.


---

# 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.floui.io/guia/painel-da-conta/logs-de-auditoria.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.