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

# Persistência local

A **Persistência local** mantém na infraestrutura da sua organização um histórico consultável dos registros de [Auditoria](https://docs.flexxible.com/pt-BR/features/traceability/audit.md) e [Operações](https://docs.flexxible.com/pt-BR/features/traceability/operations/operations) do FlexxClient. Permite definir por quanto tempo eles são guardados e consultar as informações arquivadas mesmo que já não estejam disponíveis no serviço SaaS.

O componente é instalado em uma máquina virtual do cliente e baixa os dados por meio da [API](https://docs.flexxible.com/pt-BR/features/integrations/api.md). O FlexxClient SaaS mantém o gerenciamento e a execução das ações; o componente local preserva o seu histórico e facilita a sua consulta e exportação.

## Quais informações são preservadas

| Informação | Conteúdo |
| - | - |
| **Auditoria** | Ações sobre entidades, usuário ou processo que as origina, datas, objeto afetado e detalhe das alterações recebido do serviço. |
| **Operações** | Identificação e estado da operação, eventos, dispositivos relacionados, resultados e saídas de execução de ações, fluxos e microsserviços. |
| **Atividade do arquivo** | Importações, intervalos cobertos, erros e novas tentativas, alterações de retenção, exportações e exclusões autorizadas. |

> [!NOTE]
>
> O escopo abrange as informações exportadas por essas fontes. O recebimento direto de logs ou telemetria do FlexxAgent não faz parte desta funcionalidade. As saídas de execução que já fazem parte de uma operação são incluídas no seu histórico.

## Como funciona

1. **Importação inicial.** Recupera o histórico que ainda está disponível no SaaS e mostra a partir de qual data existe cobertura para cada fonte.
2. **Sincronização noturna.** Baixa por intervalos de datas os registros pendentes e os seus detalhes. Preserva os eventos e versões recebidos, incorpora as atualizações de registros já importados e revisa as operações abertas.
3. **Confirmação e recuperação.** Confirma cada lote quando os seus dados estão salvos. Se um download for interrompido, retoma o trabalho sem duplicar registros e mostra os intervalos incompletos.
4. **Consulta local.** Atualiza as buscas e os resumos diários. O detalhe completo é carregado ao abrir cada registro.

> [!NOTE]
>
> O arquivo reflete a última sincronização concluída. Com uma execução diária, ele pode acumular aproximadamente um dia de atraso, mais o tempo de processamento. Uma falha pode ampliar esse intervalo.

## Implantação e configuração

O sincronizador, o serviço de consulta e o repositório são implantados em uma VM com armazenamento persistente e expansível. Em instalações de maior carga, o aplicativo e o banco de dados podem ser hospedados em servidores separados.

### Requisitos de implantação

* **Conectividade e credenciais.** Conexão de saída HTTPS do componente para a API do FlexxClient e uma identidade técnica da organização com as permissões de leitura necessárias.
* **Acesso.** Acesso à interface local a partir da rede autorizada e autenticação para os usuários que consultam ou administram o arquivo.
* **Armazenamento.** SSD ou equivalente de baixa latência, com espaço livre para a importação, os índices e a manutenção.
* **Backups.** Um destino de backups independente e uma política de recuperação definida pela organização.

### Configurações principais

| Configuração | Finalidade |
| - | - |
| **Organização e credencial** | Selecionar a origem e autorizar a leitura dos seus registros. |
| **Programação** | Definir o horário e o fuso horário da sincronização diária. |
| **Retenção** | Estabelecer os prazos por categoria e os mínimos de preservação aplicáveis. |
| **Acesso e supervisão** | Atribuir permissões e configurar avisos para erros, atrasos, falta de espaço ou cobertura incompleta. |

## Consulta do histórico

As visualizações permitem filtrar por datas e identificadores e, dependendo do registro, por ator, dispositivo, ação, estado, fluxo ou microsserviço. Os resultados são paginados e as exportações grandes são processadas em segundo plano.

Cada visualização mostra o período coberto e a última sincronização bem-sucedida. O histórico continua consultável durante uma interrupção do SaaS se o componente local e os serviços de autenticação configurados estiverem funcionando.

## Preservação e proteção

A retenção é configurada em meses ou anos:

* **Auditoria.** O prazo é contado a partir do evento.
* **Operações.** O prazo é contado a partir do fechamento ou da última alteração, o que for posterior. As operações abertas são preservadas.

O perfil impede excluir registros antes do mínimo aplicável e permite bloquear a sua exclusão durante uma investigação.

A limpeza local segue a política autorizada e fica registrada; ela não é acionada por uma exclusão no SaaS. As permissões separam consulta, exportação e administração. Proteja as comunicações, os dados e os backups de acordo com a política de segurança da sua organização.

## Dimensionamento orientativo

O dimensionamento depende das operações diárias, do tamanho dos seus dados relacionados, da auditoria, da retenção e das consultas simultâneas. O número de computadores ajuda a descrever um cenário, mas é a atividade real que determina os recursos.

### Hipóteses dos exemplos

* **Atividade e preservação.** Cinco operações novas por computador e por dia e cinco anos de preservação, calculados como 1.825 dias. É uma suposição de planejamento, não uma média de uso do produto.
* **Unidade de cálculo.** Uma operação corresponde a um registro do histórico de Operações. Uma ação sobre vários computadores pode produzir numerosos resultados associados.
* **Tamanho por operação.** Aproximadamente 22,6 kB físicos por operação, incluindo eventos, detalhes associados e índices. Substitua esse valor pela medição do arquivo local da sua organização.
* **Consultas.** Consultas paginadas, resumos diários e entre cinco e dez usuários de consulta simultâneos. Os recursos são validados por meio de um teste com dados representativos.

| Computadores de referência | Operações por dia | Dados e índices em 5 anos | SSD útil inicial | vCPU e RAM orientativas |
| - | - | - | - | - |
| 1.000 | 5.000 | 0,21 TB | 0,5 TB | 4 vCPU / 16 GB |
| 5.000 | 25.000 | 1,03 TB | 2 TB | 8 vCPU / 32 GB |
| 10.000 | 50.000 | 2,06 TB | 4 TB | 8 vCPU / 64 GB |
| 25.000 | 125.000 | 5,16 TB | 10 TB | 16 vCPU / 128 GB |
| 50.000 | 250.000 | 10,32 TB | 20 TB | A dimensionar |
| 100.000 | 500.000 | 20,64 TB | 40 TB | A dimensionar |

> [!WARNING]
>
> Os números são estimativas de planejamento, não limites de capacidade certificados. GB e TB são expressos em unidades decimais. A capacidade útil é a disponível para o serviço após as reservas da infraestrutura.

A coluna de dados inclui as operações e os seus detalhes associados. A auditoria, as versões adicionais e o espaço operacional do mecanismo devem ser medidos separadamente. O SSD inicial incorpora uma reserva de planejamento cuja suficiência deve ser verificada ao adicionar esses itens.

O disco do sistema operacional, os backups e as réplicas exigem capacidade adicional. Para 250.000 operações diárias ou mais, a distribuição de CPU e RAM e a separação de serviços são definidas por meio de um dimensionamento específico.

No cenário de 50.000 operações diárias, são preservadas 91,25 milhões de operações em cinco anos. A configuração de referência é de 8 vCPU, 64 GB de RAM e 4 TB úteis expansíveis, sujeita a validação com a carga real.

### Ajustar a capacidade à sua organização

1. **Medir a atividade.** Utilize um período representativo de duas a quatro semanas. Registre as operações e os bytes arquivados a cada dia, incluindo resultados, auditoria e novas versões. Inclua dias de atividade elevada.
2. **Projetar a preservação.** Multiplique o crescimento diário medido pelos dias de retenção e pelo crescimento previsto da atividade. Inclua os índices e o espaço operacional do mecanismo sem contar duas vezes os itens já medidos.
3. **Reservar capacidade.** Divida o total previsto por 0,70 para manter 30 % de espaço livre. Dimensione os backups e as réplicas de forma independente.
4. **Validar o desempenho.** Verifique as buscas e a abertura de registros antigos enquanto uma importação é executada. Confirme que o download termina dentro da janela acordada e ajuste CPU, RAM, disco ou simultaneidade se necessário.

Como referência, 50.000 operações diárias exigem cerca de 0,41 TB com um ano de preservação, 1,24 TB com três anos e 2,06 TB com cinco anos, antes de adicionar a Auditoria e os demais itens. Se o tamanho médio das operações ou dos seus resultados mudar, recalcule esses valores.

## Supervisão e manutenção

Supervisione o espaço livre, a última sincronização bem-sucedida, a idade do arquivo, os intervalos pendentes e os tempos de consulta. Amplie o armazenamento antes de consumir a reserva prevista e revise o dimensionamento quando a retenção, a atividade ou os usuários simultâneos aumentarem.

Os backups devem permitir recuperar em conjunto os dados, a configuração e o estado de sincronização. Teste a restauração e acorde por quanto tempo o arquivo pode ficar indisponível. Uma única VM exige medidas adicionais se for necessária alta disponibilidade.

## Informações relacionadas

* [Auditoria](https://docs.flexxible.com/pt-BR/features/traceability/audit.md)
* [Operações](https://docs.flexxible.com/pt-BR/features/traceability/operations/operations)
* [API](https://docs.flexxible.com/pt-BR/features/integrations/api.md)
