> ## 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

**Persistència local** conserva a la infraestructura de la teva organització un històric consultable dels registres d'[Auditoria](https://docs.flexxible.com/ca/features/traceability/audit.md) i [Operacions](https://docs.flexxible.com/ca/features/traceability/operations/operations) de FlexxClient. Permet definir quant de temps es desen i consultar la informació arxivada encara que ja no estigui disponible al servei SaaS.

El component s'instal·la en una màquina virtual del client i descarrega les dades mitjançant l'[API](https://docs.flexxible.com/ca/features/integrations/api.md). FlexxClient SaaS manté la gestió i l'execució de les accions; el component local conserva el seu històric i en facilita la consulta i l'exportació.

## Quina informació conserva

| Informació | Contingut |
| - | - |
| **Auditoria** | Accions sobre entitats, usuari o procés que les origina, dates, objecte afectat i detall dels canvis rebut del servei. |
| **Operacions** | Identificació i estat de l'operació, esdeveniments, dispositius relacionats, resultats i sortides d'execució d'accions, fluxos i microserveis. |
| **Activitat de l'arxiu** | Importacions, intervals coberts, errors i reintents, canvis de retenció, exportacions i eliminacions autoritzades. |

> [!NOTE]
>
> L'abast comprèn la informació exportada per aquestes fonts. La recepció directa de logs o telemetria de FlexxAgent no forma part d'aquesta funcionalitat. Les sortides d'execució que ja formen part d'una operació s'inclouen al seu històric.

## Com funciona

1. **Importació inicial.** Recupera l'històric que encara està disponible al SaaS i mostra des de quina data hi ha cobertura per a cada font.
2. **Sincronització nocturna.** Descarrega per intervals de dates els registres pendents i els seus detalls. Conserva els esdeveniments i les versions rebuts, incorpora les actualitzacions de registres ja importats i revisa les operacions obertes.
3. **Confirmació i recuperació.** Confirma cada lot quan les seves dades estan desades. Si una descàrrega s'interromp, reprèn la feina sense duplicar registres i mostra els intervals incomplets.
4. **Consulta local.** Actualitza les cerques i els resums diaris. El detall complet es carrega en obrir cada registre.

> [!NOTE]
>
> L'arxiu reflecteix l'última sincronització completada. Amb una execució diària pot acumular aproximadament un dia de retard, més el temps de processament. Una fallada pot ampliar aquest interval.

## Desplegament i configuració

El sincronitzador, el servei de consulta i el repositori es despleguen en una VM amb emmagatzematge persistent i ampliable. En instal·lacions de més càrrega, l'aplicació i la base de dades es poden allotjar en servidors separats.

### Requisits de desplegament

* **Connectivitat i credencials.** Connexió sortint HTTPS des del component cap a l'API de FlexxClient i una identitat tècnica de l'organització amb els permisos de lectura necessaris.
* **Accés.** Accés a la interfície local des de la xarxa autoritzada i autenticació per als usuaris que consulten o administren l'arxiu.
* **Emmagatzematge.** SSD o equivalent de baixa latència, amb espai lliure per a la importació, els índexs i el manteniment.
* **Còpies de seguretat.** Una destinació de còpies independent i una política de recuperació definida per l'organització.

### Configuració principal

| Paràmetre | Finalitat |
| - | - |
| **Organització i credencial** | Seleccionar l'origen i autoritzar la lectura dels seus registres. |
| **Programació** | Definir l'hora i la zona horària de la sincronització diària. |
| **Retenció** | Establir els terminis per categoria i els mínims de conservació aplicables. |
| **Accés i supervisió** | Assignar permisos i configurar avisos per errors, retards, manca d'espai o cobertura incompleta. |

## Consulta de l'històric

Les vistes permeten filtrar per dates i identificadors i, segons el registre, per actor, dispositiu, acció, estat, flux o microservei. Els resultats es paginen i les exportacions grans es processen en segon pla.

Cada vista mostra el període cobert i l'última sincronització correcta. L'històric continua sent consultable durant una interrupció del SaaS si funcionen el component local i els serveis d'autenticació configurats.

## Conservació i protecció

La retenció es configura en mesos o anys:

* **Auditoria.** El termini es compta des de l'esdeveniment.
* **Operacions.** El termini es compta des del tancament o l'últim canvi, el que sigui posterior. Les operacions obertes es conserven.

El perfil impedeix eliminar registres abans del mínim aplicable i permet bloquejar-ne l'eliminació durant una investigació.

La purga local segueix la política autoritzada i queda registrada; no s'activa per una eliminació al SaaS. Els permisos separen consulta, exportació i administració. Protegeix les comunicacions, les dades i les còpies d'acord amb la política de seguretat de la teva organització.

## Dimensionament orientatiu

El dimensionament depèn de les operacions diàries, la mida de les seves dades relacionades, l'auditoria, la retenció i les consultes concurrents. El nombre d'equips ajuda a descriure un escenari, però és l'activitat real la que determina els recursos.

### Hipòtesis dels exemples

* **Activitat i conservació.** Cinc operacions noves per equip i dia i cinc anys de conservació, calculats com a 1.825 dies. És un supòsit de planificació, no una mitjana d'ús del producte.
* **Unitat de càlcul.** Una operació correspon a un registre de l'historial d'Operacions. Una acció sobre diversos equips pot produir nombrosos resultats associats.
* **Mida per operació.** Aproximadament 22,6 kB físics per operació, inclosos esdeveniments, detalls associats i índexs. Substitueix aquest valor per la mesura de l'arxiu local de la teva organització.
* **Consultes.** Consultes paginades, resums diaris i entre cinc i deu usuaris de consulta concurrents. Els recursos es validen mitjançant una prova amb dades representatives.

| Equips de referència | Operacions al dia | Dades i índexs a 5 anys | SSD útil inicial | vCPU i RAM orientatives |
| - | - | - | - | - |
| 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]
>
> Les xifres són estimacions de planificació, no límits de capacitat certificats. GB i TB s'expressen en unitats decimals. La capacitat útil és la disponible per al servei després de les reserves de la infraestructura.

La columna de dades inclou les operacions i els seus detalls associats. L'auditoria, les versions addicionals i l'espai operatiu del motor s'han de mesurar per separat. L'SSD inicial incorpora una reserva de planificació la suficiència de la qual s'ha de comprovar en afegir aquestes partides.

El disc del sistema operatiu, les còpies de seguretat i les rèpliques requereixen capacitat addicional. Per a 250.000 operacions diàries o més, el repartiment de CPU i RAM i la separació de serveis es defineixen mitjançant un dimensionament específic.

En l'escenari de 50.000 operacions diàries es conserven 91,25 milions d'operacions en cinc anys. La configuració de referència és de 8 vCPU, 64 GB de RAM i 4 TB útils ampliables, subjecta a validació amb la càrrega real.

### Ajustar la capacitat a la teva organització

1. **Mesurar l'activitat.** Utilitza un període representatiu de dues a quatre setmanes. Registra les operacions i els bytes arxivats cada dia, inclosos resultats, auditoria i noves versions. Inclou dies d'activitat elevada.
2. **Projectar la conservació.** Multiplica el creixement diari mesurat pels dies de retenció i pel creixement previst de l'activitat. Inclou els índexs i l'espai operatiu del motor sense comptar dues vegades les partides ja mesurades.
3. **Reservar capacitat.** Divideix el total previst entre 0,70 per mantenir un 30 % d'espai lliure. Dimensiona les còpies de seguretat i les rèpliques de manera independent.
4. **Validar el rendiment.** Comprova les cerques i l'obertura de registres antics mentre s'executa una importació. Confirma que la descàrrega acaba dins de la finestra acordada i ajusta CPU, RAM, disc o concurrència si cal.

Com a referència, 50.000 operacions diàries requereixen uns 0,41 TB amb un any de conservació, 1,24 TB amb tres anys i 2,06 TB amb cinc anys, abans d'afegir Auditoria i les altres partides. Si canvia la mida mitjana de les operacions o dels seus resultats, recalcula aquests valors.

## Supervisió i manteniment

Supervisa l'espai lliure, l'última sincronització correcta, l'antiguitat de l'arxiu, els intervals pendents i els temps de consulta. Amplia l'emmagatzematge abans de consumir la reserva prevista i revisa el dimensionament quan augmentin la retenció, l'activitat o els usuaris concurrents.

Les còpies han de permetre recuperar conjuntament les dades, la configuració i l'estat de sincronització. Prova la restauració i acorda quant de temps pot estar indisponible l'arxiu. Una única VM requereix mesures addicionals si es necessita alta disponibilitat.

## Informació relacionada

* [Auditoria](https://docs.flexxible.com/ca/features/traceability/audit.md)
* [Operacions](https://docs.flexxible.com/ca/features/traceability/operations/operations)
* [API](https://docs.flexxible.com/ca/features/integrations/api.md)
